Skip to main content

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 are versioned as part of your project version, not individually. Changes are tracked in the project’s 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
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. Go to FlowX Designer and select the Content Management tab.
  2. Select Substitution tags from the list.
  3. Click New value.
  4. Fill in the necessary details:
    • Key
    • Languages
  5. Click Add after you finish.
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 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

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.
The flxLocalize pipe is found in the FlxLocalizationModule.
import { FlxLocalizationModule } from 'flowx-process-renderer';
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:
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

Task Management Localization

Complete guide to localizing Task Management with all 51 substitution tags. Table grid localization is automatic.
Last modified on April 27, 2026