After turning on developer mode in a project, each piece of text in that project will receive a "developer ID." These IDs are unique to each text item in Ditto. Developer IDs allow each piece of text in Ditto to be identified when exporting it from Ditto or interacting with it through our developer integrations.
You can configure how IDs are generated in your workspace from the developer integrations page of your Account Settings:
With these configurations, each team in Ditto can determine how they want their developer IDs to be generated.
Component IDs are generated based on the component’s name.
Component ID Rules allow you to configure component ID generation as follows:
If IDs for two or more components are generated in such a way that they conflict with one another, the conflicts will be resolved by appending a number to the end of the duplicate component IDs until all IDs are unique.
By default, component IDs are regenerated according to your component ID rules whenever a component name changes. To opt out of this functionality, you can disable the toggle for Automatically update ID when component's name is changed on your developer settings page.
For text in projects not currently attached to a component, users can generate a template to create the text item's ID based off of the text's properties, including:
Project ID Rules allow you to configure that process as follows:
Project Name — the name of the project the text is in
Group Name — the name of the group the text is in
Block Name — the name of the block the text is in
Text — the value of the text itself
If IDs for two or more pieces of text are generated in such a way that they conflict with one another, the conflicts will be resolved by appending a number to the end of the duplicate developer IDs until all IDs are unique.