Unify and manage your data

Enable Reltio ID and Custom UID

Learn how to enable Reltio ID and Custom UID for specific entity types in your tenant configuration.

You need ROLE_ADMIN_TENANT Access permissions or another role with similar configuration access to update the source and attribute configuration in your tenant.

For more information, see System roles.

Follow these steps to enable durable identifiers in your tenant. Reltio ID and Custom UID must be configured manually using the API, as the required data types and flags aren't exposed in the UI.
To enable Reltio ID for a specific entity type:
  1. Add a source named ReltioID
    1. In the Sources tab in Data Modeler,, add a new source + CREATE NEW.
    2. The Display name can be any value.
  2. Create a new attribute using the ReltioId data type via the API.
    This data type is not available in the UI.

    Addition of the ReltioId simple attribute to L3.

    Example payload:

    {
    "label": "Reltio Id",
      "name": "ReltioId",
      "type": "ReltioId",
      "hidden": false,
      "searchable": false,
      "attributeOrdering": {
        "orderType": "ASC",
        "orderingStrategy": "LUD"
      },
      "uri": "configuration/entityTypes/Test1Profile/attributes/ReltioId",
      "skipInDataAccess": false
    }
    Example of how the Simple attribute looks like in the UI once added:

  3. Save your tenant configuration changes.
  4. To generate Reltio IDs for existing entities, run the GenerateReltioIdTask.
    For more information, see Generate a Reltio ID for an entity.
To enable Custom UID for a specific attribute:
Note: A Custom UID lets you define your own identifier, such as a license number or customer ID, and use it across tenants. Unlike the system-generated Reltio ID, a Custom UID value must be supplied by your source data. Reltio does not generate it automatically.
  1. Ensure the source ReltioID has already been added
    Same setup as for Reltio ID above.
  2. Edit the attribute configuration using the API
    1. Add the customReltioId: true flag to mark it as a Custom UID.
    This flag can't be configured through the UI.

    Example payload:

    {
      "label": "Website URL",
      "name": "WebsiteURL",
      "type": "URL",
      "customReltioId": true,
      "attributeOrdering": {
        "orderType": "ASC",
        "orderingStrategy": "LUD"
      },
      "uri": "configuration/entityTypes/HCO/attributes/WebsiteURL",
      "skipInDataAccess": false
    }
    Note: When customReltioId: true is set, Reltio expects the value to be provided during data load or via the API. It will not generate this value on its own. The platform creates a crosswalk using the ReltioID source system and the supplied value.
  3. Save your tenant configuration changes.
The selected entity types now support durable identifiers. New records will automatically be assigned a Reltio ID or Custom UID.

Existing records will receive identifiers after running the generate task.