# Change ID Manipulator

The Change ID Manipulator allows you to replace the ID of a content.  

## Properties

| Property     | Purpose                                                                                                                                                | Required |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ | -------- |
| changeId     | <p>The value to update the ID to. Options: <br>- UUID<br>- RAND:{integer}<br>- {custom value}</p>                                                      | True     |
| changeIdLang | A comma separated list of language IDs to apply the `changeId` value to. If the option is not set, all languages will apply the same `changeId` value. | False    |

## Specifics

This manipulator updates the content's ID allowing for a custom ID or completely new ID to be set. This is useful for systems that allow a custom ID when creating a content.&#x20;

### How to use

Set the `changeId` property to a one of the options available.&#x20;

Options:&#x20;

* UUID
  * generates a new UUID value
* RAND:{integer}
  * generates a random ID string from alphanumeric characters with the length of the `{integer}` value used
  * i.e., `RAND:21` will generate a random ID with 21 alphanumeric characters&#x20;
* {custom value}
  * sets the ID to the provided custom value

The `fieldName` option is not necessary for this manipulator. If using the UI a whitespace can be used for these values.

## Examples

### UUID

<figure><img src="/files/aAYNN7WUmt74wklQtg9Z" alt=""><figcaption></figcaption></figure>

### RAND

<figure><img src="/files/0QmlPT4aZW2Eg19toDns" alt=""><figcaption></figcaption></figure>

### Custom ID

<figure><img src="/files/KDEqF1mZrcCGV4CrHoQR" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://motivlabs.gitbook.io/impulse-user-manual/content-manipulators-motators/change-id-manipulator.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.