> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Substitution tags

> Substitution tags are used to generate dynamic content across the platform. As **enumerations**, substitution tags can be defined for each language set for the solution.

![](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/platform-deep-dive/substitution_tags.png)

> [!NOTE]
>
> Substitution tags are versioned as part of your project version, not individually. Changes are tracked in the project's [**Resources Changed**](https://docs.flowx.ai/5.1/docs/projects/managing-applications/versioning.md#resources-changed) view. To view the change history for a specific substitution tag, right-click it and select **View History**.

On the main screen inside **Substitution tags**, you have the following elements:

* **Key**
* **Values** - strings that are used in the end-user interface, according to the language set for the generated solution
* **Edit** - button used to edit substitution tags
* **Delete** - button used to delete substitution tags
* **New value** - button used to add a new substitution tag
* **Breadcrumbs menu** - access import, export, and other bulk actions
* **Search by** - search function used to easily look for a particular substitution tag

### Export and import

You can export and import substitution tags to transfer them between projects or environments.

#### Exporting

1. Open the breadcrumbs menu on the Substitution Tags list page
2. Select **Export** and choose the format:
   * **to JSON** - exports as a ZIP file containing JSON data
   * **to CSV** - exports as a CSV file

#### Importing

1. Open the breadcrumbs menu on the Substitution Tags list page
2. Select **Import** and choose the format:
   * **from ZIP** - import from a ZIP file exported from another environment
   * **from CSV** - import from a CSV file for bulk operations
3. Select the file to import
4. If substitution tags with the same identifiers already exist, a **Review Resource Identifiers Conflicts** modal appears
5. Choose a strategy for each conflicting tag (or use **Apply to all**):
   * **Keep both** - imports the tag as a new copy alongside the existing one
   * **Replace** - overwrites the existing tag with the imported version
   * **Skip this one** - keeps the existing tag unchanged
6. Click **Continue** to complete the import

> [!NOTE]
>
> Importing is only available for work-in-progress (WIP) project versions. You cannot import into a committed version.

### Adding new substitution tags

To add a new substitution tag, follow the next steps.

1. Open your project in **FlowX Designer** and go to **CMS**.
2. Select **Substitution tags**.
3. Click **New value**.
4. Fill in the necessary details:
   * Key
   * Languages
5. Click **Add** after you finish.

![](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/platform-deep-dive/add_new_substitution.png)

> [!NOTE]
>
> When working with substitution tags or other elements that imply values from other languages defined in the CMS, when running a **process**, the default values extracted will be the ones marked by the default language.

### Getting a substitution tag by key

```
public func getTag(withKey key: String) -> String?
```

All substitution tags will be retrieved by the [**SDK**](https://docs.flowx.ai/5.1/sdks/angular-renderer.md) before starting the first process and will be stored in memory.

Whenever the container app needs a substitution tag value for populating the UI of the custom components, it can request the substitution tag using the method above, providing the key.

For example, substitution tags can be used to localize the content inside an application.

### Example

#### Localizing the app

> [!NOTE]
>
> You must first check and configure the FLOWX.AI Angular renderer to be able to replicate this example. For more information, see the [Angular renderer documentation](https://docs.flowx.ai/5.1/sdks/angular-renderer.md).

The `flxLocalize` pipe is found in the `FlxLocalizationModule`.

```typescript theme={"dark"}
import { FlxLocalizationModule } from 'flowx-process-renderer';
```

```typescript theme={"dark"}
import { Component } from '@angular/core';

@Component({
  selector: 'app-dummy-component',
  template: ` <h3>{{ "stringToLocalize" | flxLocalize}}</h3>`,

})
export class DummyComponent{
 stringToLocalize: string = `@@localizedString`
}
```

Strings that need to be localized must have the '**@@**' prefix which the **flxLocalize** pipe uses to extract and replace the string with a value found in the substitution tags enumeration.

Substitution tags are retrieved when a start process call is first made, and it's cached on subsequent start process calls.

## Task Management localization

Substitution tags are essential for localizing Task Management interfaces. FlowX.AI provides **51 system substitution tags** (prefixed with `sys_tm_*`) specifically for Task Management localization:

> [!NOTE]
>
> **Available since:** FlowX.AI 5.1.1

* Table columns (title, stage, assignee, status, priority)
* Process states (created, started, finished, etc.)
* Task actions (assign, hold, unassign, execute)
* Bulk operations
* History events and comments
* User selection dialogs

> [card] [Task Management Localization](https://docs.flowx.ai/5.1/docs/platform-deep-dive/core-extensions/task-management/task-management-localization.md)
>
> Complete guide to localizing Task Management with all 51 substitution tags. Table grid localization is automatic.


## Related topics

- [Reusable UI Templates](https://docs.flowx.ai/5.1/docs/building-blocks/reusable-resources/reusable-ui.md)
- [Dynamic & computed values](https://docs.flowx.ai/5.1/docs/building-blocks/ui-designer/dynamic-and-computed-values.md)
- [Reference types in resources usage](https://docs.flowx.ai/5.1/docs/projects/reference-types.md)
- [iOS SDK](https://docs.flowx.ai/5.1/sdks/ios-renderer.md)
- [FlowX.AI 4.7.10 Release Notes](https://docs.flowx.ai/release-notes/v4.x/v4.7.x-lts/v4.7.10-november-2025/v4.7.10-november-2025.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.