# Display (custom) IDs

## What are Display IDs?

Replace the automatically generated ID created by Content Controller for **Accounts**, **Content**, **Equivalents** and **Bundles** with your own Display (also known as custom) ID. These IDs can be used for searching, reporting and audit logs or interacted with via the API. 

{% hint style="warning" %}
If you are integrated in any way with Content Controller or utilize the Automation API. Please make sure to check with your Manager or Engineering team before changing an ID. 
{% endhint %}

### Some things to keep in mind

Before working with these custom IDs there are a few limitations to be aware of.

* The IDs must be unique
* They cannot be more than 1000 characters
* And they cannot contain any of the following: &$+,/:;=?@# <>\[]{}|^%

### Setting & editing IDs

To set a custom ID this can be done via the API or the UI. Within the UI, you have the option of applying an ID when importing a course or from the details panel for those already in your library. Similarly, this applies to Accounts, Equivalents and Bundles.

#### During content import&#x20;

1. Navigate to the **Content** section&#x20;
2. Click the **+ Add** button then select the Course option.&#x20;
3. Here you will see a checkbox “**Automatically generate ID**” selected. Uncheck this box to present a new text field where an ID may be set.&#x20;
4. Enter your ID and upload the course as normal.&#x20;

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

{% hint style="info" %}
The same steps above also apply when creating an **Equivalent** or **Bundle**.
{% endhint %}

#### Editing existing content&#x20;

1. Navigate to the **Content**, **Equivalent** or **Bundle** areas&#x20;
2. Select the desired course by clicking on it&#x20;
3. In the details panel that appears, click the **Edit** button under the Details title section.&#x20;
4. Here you may edit the ID and save as normal.

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

#### During account creation

1. Navigate to the **Account** section&#x20;
2. Click the **+ Add** button to create a new account&#x20;
3. Here you will see a checkbox “**Automatically generate ID**” selected. Uncheck this box to present a new text field where an ID may be set.&#x20;
4. Enter your ID and create the account as normal.

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

#### Editing an existing account

1. Navigate to the **Account** section&#x20;
2. Select the account you wish to assign an ID to&#x20;
3. On the account dashboard you will see the ID near the bottom as shown in the screenshot.&#x20;
4. Click **Edit** and uncheck the **automatically assign ID checkbox**. Enter your ID and save the account as normal.

<figure><img src="/files/8v5PczZaiu2AlKCOoUEv" alt=""><figcaption></figcaption></figure>

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

### Using and viewing IDs

#### Searching

When searching on the appropriate pages within Content Controller. You may preface your search with **id:** followed by the ID to find the desired course. <mark style="color:green;">Example id: RD5896521485</mark> notice how the search icon changes to a key.

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

#### List views

IDs will now appear on the appropriate pages with a list view for Content, Equivalents, Bundles as well as the Accounts dashboard.&#x20;

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

{% hint style="info" %}
Anywhere an ID would normally appear in reports a new <mark style="color:green;">displayid</mark> will be added.
{% endhint %}


---

# 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://guide.contentcontroller.com/settings/update-user-details-1.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.