---
title: "replaceNamespace"
canonical: "https://help.vicon.com/space/ShogunPost121/1253738377/replaceNamespace"
format: markdown
---
# Description

Replaces all instances of a selected or specified namespace.

All modules under the same parent can be considered in the namespace of that parent, using slashes ( / ) to separate each module's parent's name. replaceNamespace operates on all selected modules unless you use the `-onMod` flag to specify the module on which to operate by name.

Note that you may specify the path in commands that require a module name, but you may not specify the path as a module name in the Name attribute.

You need to specify only what is required to uniquely identify the name.

## Functional area

Namespace

# Command syntax

## Syntax

> Macro (scroll-tablelayout)

|  |
| --- |
| `replaceNamespace oldNamespace newNamespace[-onMod string]` |

### Arguments

> Macro (scroll-tablelayout)

| Name | Type | Required | Comments |
| --- | --- | --- | --- |
| `oldNamespace` | string | Yes | Specify the path of a namespace using slashes ( / ), or colons ( : ). The number of namespaces in a module name is not limited. Note that if the module contains the same namespace twice, replaceNamespace removes all instances. |
| `newNamespace` | string | Yes | Specify the path of a namespace using slashes ( / ), or colons ( : ). The number of namespaces in a module name is not limited. |

> Macro (scroll-pagebreak)

### Flags

| Name | Flag arguments | Argument type | Exclusive to | Comments |
| --- | --- | --- | --- | --- |
| `onMod` | 1 | string | — | Specifies the module on which the command operates. |

## Return value

void

## Example

```plaintext
// Replace a namespace called Bob with a namespace called Joe 
replaceNamespace "Bob" "Joe";
```

# Additional information

## Related commands

- [addNamespace](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736602)
- [getNamespace](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736535)
- [getNamespaces](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737946)
- [removeNamespace](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737568)