Changelog

​

October 6, 2025

​

Ditto Github Action - 1.0.2

• 1.0.2
• 1.0.1
• 1.0.0

​

Ditto CLI - 5.1.0

​

October 1, 2025

​

Ditto CLI - 5.0.0

​

September 29, 2025

​

API

​

Ditto CLI - 5.0.0-beta.8

​

September 11, 2025

​

API

​

August 18, 2025

​

Ditto CLI - 5.0.0-beta.7

​

July 24, 2025

​

API

​

July 8, 2025

​

API

​

April 30, 2025

​

Ditto CLI - 5.0.0-beta.6

• 5.0.0-beta.6
• 5.0.0-beta.5
• 5.0.0-beta.4
• 5.0.0-beta.3
• 5.0.0-beta.2
• 5.0.0-beta.1
• 5.0.0-beta.0

​

March 28, 2025

​

API

• Added fetch project folders (GET /v1/project-folders) API endpoint for fetching project folders in the user’s workspace.
• Added fetch projects by project folder id (GET /v1/project-folders/:folder_id/projects) API endpoint for fetching projects in the specified folder.

​

March 24, 2025

​

API

• Added fetch projects (GET /v2/projects) API endpoint for fetching projects in the user’s workspace.
• Added fetch text items (GET /v2/textItems) API endpoint for fetching text items in the user’s workspace.
• Added fetch variables (GET /v2/variables) API endpoint for fetching variables in the user’s workspace.
• Added fetch variants (GET /v2/variants) API endpoint for fetching variants in the user’s workspace.

​

February 3, 2025

​

API

​

November 11, 2024

​

Ditto React - 1.6.3

• Dependency upgrades

​

May 21, 2024

​

Ditto CLI - 4.5.2

• Fix to include header distinguishing Ditto CLI requests from direct API requests.

​

May 7, 2024

​

Ditto CLI - 4.5.1

• Fix issue with error logs not being flushed before exiting the CLI

​

May 3, 2024

​

Ditto Github Action - 0.3.0

• add optional name input parameter pr-title-prefix to distinguish prs with multi config setups

​

May 2, 2024

​

API / Web App

{
  "fruit": "You have fruit in your cart.",
  "fruit_one": "You have one fruit in your cart.",
  "fruit_other": "You have some fruit in your cart."
}

​

April 16, 2024

​

CLI

​

March 22, 2024

​

CLI

​

March 15, 2024

​

Documentation

• Small fixes and wording clarifications on the SDKs page

​

March 13, 2024

​

Ditto React - 1.6.1

• Fix crash when rich text is enabled

​

February 29, 2024

​

Ditto CLI - 4.4.0

• Add pull —sample-data flag for variants

​

February 27, 2024

​

Ditto API

• /v1/variants now supports the showSampleData query parameter
• Fix /v1/variants for projectIds query parameter

​

February 19, 2024

​

Ditto CLI - 4.3.0

• nested format is now supported

​

Ditto CLI - 4.2.3

• Upgrades to several dependencies

​

January 22, 2024

​

Ditto CLI - 4.2.2

• Stop component folders with emojis from creating a leading separator

​

December 12, 2023

​

Ditto API

​

December 7, 2023

​

Ditto React

​

November 28, 2023

​

Ditto CLI - 4.2.1

• Only run init() on commands that need it in https://github.com/dittowords/cli/pull/89

​

November 16, 2023

​

Ditto CLI - 4.2.0

​

November 2, 2023

​

Ditto React

<Ditto
  textId="text_61e7238bbae5dc00fb66de15"
  variables={{ itemCount: 5 }}
  richText
/>

​

October 30, 2023

​

Ditto CLI — 4.1.0

​

New example apps

​

September 29, 2023

​

August 29, 2023

​

Ditto React

• Ditto components with rich text can now be rendered natively by passing the richText property on either Ditto or DittoComponent.
• Example: <Ditto componentId="shopping-cart" richText />

​

August 18, 2023

​

Ditto API

• Endpoints for fetching project text now support an exclude_components query parameter.
• When exclude_components=true, only text items not associated with Ditto components will be returned from a given endpoint.

​

Ditto CLI

• We’ve released a new major version (v4) of the CLI. See the release notes here.

​

August 15, 2023

​

Ditto API

// Base Text
{{username}}, your role is {{role}}.

// Variant Text
Tú papel es {{role}}, {{username}}.
Previously, exports for the base text and variant text would cause format specifier indices to be reversed for the variables:
/* base-example.strings */
"text" = "%1$@, your role is %2$@.";

/* spanish-example.strings */
"text" = "Tú papel es %1$@, %2$@.";
To facilitate ease of integration into development, exports for variant text will now ensure that the format specifier indices match those in the base text:
/* base-example.strings */
"text" = "%1$@, your role is %2$@.";

/* spanish-example.strings */
"text" = "Tú papel es %2$@, %1$@.";

​

August 7, 2023

​

Ditto API

• Support has been added for an exclude_components query parameter to the endpoint.
• When set to true, only text items not associated with components will be returned from the endpoint.

​

Ditto CLI

• Small bug fix to ensure files aren’t written to disk for empty API responses.
• For more information, please refer to the release here.

​

July 26, 2023

​

Ditto API

• When exporting data for variants, variant metadata (name and description) is now included.
  • In the JSON formats, two new meta keys are added at the top level: variant_name and variant-description
  • In the Android .xml, iOS .strings, and iOS .stringsdict formats, a comment is added for each field at the top of the file

​

July 17, 2023

​

Ditto API

• The flat format now supports rich text.

​

June 27, 2023

​

Ditto CLI

• Added support for specifying a list of formats in the format configuration property.
• For more information, please refer to the release here.

​

June 26, 2023

​

Ditto React

• v1.4.1 fixes a bug introduced in v1.4.0 which caused variables to ignore passed values.

​

June 14, 2023

​

Ditto CLI

• Added the import-components command which enables component imports via a file through the CLI. For information about the command please refer to the documentation in the README.

​

June 12, 2023

​

Ditto API

• We’ve added the new POST /components/file endpoint to enable uploading components through the API.

​

June 8, 2023

​

VSCode Extension

• Add the ability to only match on components from a component folder. Must be used with v3.8.0 of the Ditto CLI.

​

Ditto CLI

• Add component-folders command which lists component folders in your workspace. See the release here.

​

June 5, 2023

​

Ditto CLI

• Add the -cf (--component-folder) flag for generate-suggestions. See the release here.

​

June 2, 2023

​

Ditto CLI

• Performance improvements. See the release here.

​

May 30, 2023

​

Ditto CLI

• We’ve added support for specifying the new ios-stringsdict format in the CLI configuration. See the release here.

​

Ditto API

{
  "data": {
    "[API ID]": {
      "text": "[TEXT OF TEXT ITEM (CAN INCLUDE VARIABLES)]",
      "notes": "[NOTES OF TEXT ITEM]", // optional
      "tags": [ ... ], // optional: array of strings
      "plurals": [ // optional: array of plural objects
        {
          "text": "[TEXT OF PLURAL FORM]",
          "form": "[one|two|zero|few|many|other]"
        }
      ]
    }
  }
}

​

May 12, 2023

​

Ditto API

​

May 3, 2023

​

Ditto CLI

• Adds ICU support
• Fixes a bug where pulling would fail on new initializations
• Full Changelog

​

May 1, 2023

​

VS Code Extension

​

April 28, 2023

​

Ditto API

​

April 26, 2023

​

Ditto CLI

​

March 23, 2023

​

Ditto React

​

March 22, 2023

​

Ditto API, Ditto CLI, Ditto React

{
  "some-variable-1": {
    "example": "Hello world!",
   "__type": "string"
  },
  "some-variable-2": {
    "example": 100,
    "__type": "number"
  },
  "some-variable-3": {
    "text:" "Foo",
    "url": "https://bar.com",
    "__type": "hyperlink"
  }
}

​

March 21, 2023

​

Ditto API

​

March 9, 2023

​

Ditto CLI

​

February 15, 2023

​

Ditto API

• index values for format specifiers will now be relative to a text item’s base value AND its plurals, instead of resetting for each plural form (issue)
• extra whitespace is no longer added between text and variables in the final output (issue)

​

February 14, 2023

​

Ditto API

​

February 6, 2023

​

Ditto Web App

• Removed the deprecated the full format from the export modals on the project page and in the component library
• Set the flat format to be the default export format in the web app

​

February 3, 2023

​

Ditto API

​

February 1, 2023

​

Ditto React — 1.3.0

​

January 25, 2023

• Android localization files (.xml)
• iOS localization files (.strings)

​

January 19, 2023

​

Ditto React — 1.2.1

• Updated README to clarify that the flat format does not currently support variables.
• Fixed a bug preventing falsy values (namely 0 and "") from being properly interpolated.

​

December 15, 2022

​

Ditto CLI

​

December 13, 2022

​

Ditto API

• /projects
• /projects/:id
• /projects/:id/components
• /components
• /component-folders/:api*id/components

​

November 30, 2022

​

Ditto CLI

​

November 29, 2022

​

Ditto CLI

​

November 10, 2022

​

Ditto API

​

Ditto CLI

• DITTO_CONFIG_FILE: used to specify an alternate file location for the CLI to read authentication information from. The default path is $HOME/.config/ditto.
• DITTO_TEXT_DIR: used to specify an alternate folder location for the CLI to write its output files to. The default path is ./ditto.

​

Oct 11, 2022

​

Ditto API

• Added new endpoint: Fetch component folders
• Added new endpoint: Fetch components by component folder
• Added sub-headings to divide the endpoints by the entity they’re associated with, and implemented minor miscellaneous cleanup across the endpoint documentation

​

Sep 23, 2022

​

Ditto API

​

Sep 19, 2022

​

Ditto React — 1.2.0

• We exported two hooks that can be used for accessing synced data: useDittoSingleText and useDittoComponent. These hooks are experimental and will likely undergo API changes in the future.
• See the release here.

​

Ditto API

• Added the status field to data returned from the /components and /projects/:id/components endpoints.

​

Jun 30, 2022

​

Ditto API

• Added support for including variables in payloads sent to the PUT /components endpoint.
• Fixed an issue with Android & iOS export formats not escaping special characters: \n, \t, @, ?, ', and " characters are now properly escaped.
• Added missing xliff namespace to exported Android .xml files. = Fixed a bug with Android .xml exports that occurred with text items with API IDs that include the - character. Now, all - characters are replaced with \_ characters in the name property of <string> and <plural> tags, and a ditto_api_id property has been added to string and plural tags to serve as a reference to the original API ID.

​

Ditto CLI — 2.5.1

• Fixed a bug when using the project add / project remove commands and selecting the component library caused incorrect modifications to be made to the CLI’s configuration file.
• See the release here.

​

Ditto Example Projects

• Added new iOS Example Project showcasing how to use exported .strings files.
• Added new Android Example Project showcasing how to use exported .xml string files.

​

Jun 13, 2022

​

Ditto GitHub Action — 0.2.0

​

June 7, 2022

​

Ditto API

​

June 1, 2022

​

Ditto API

• Added early support for exporting text data to Android and iOS Strings formats. All endpoints that support a format query parameter can now accept values of android or ios-strings.
• Added GET /variables endpoint that returns the variables in the workspace of the requesting user.
• Added the ability to filter by text item status by passing a status query parameter in API requests. Supported by the following endpoints:
  • GET /projects
  • GET /projects/:id
  • GET /projects/:id/components
  • GET /components See our API documentation for more details.

​

May 23, 2022

​

Ditto CLI — 2.5.0

• Added meta option flag in support of the Ditto GitHub Action release. See the release here.

​

Ditto GitHub Action — 0.1.0

• v0.1.0 released! Check it out here.

​

May 16, 2022

​

Ditto CLI — 2.4.0

• Update some user-facing CLI messages to accurately reflect our new subdomain: app.dittowords.com (instead of the old beta.dittowords.com). See the release here.

​

May 10, 2022

​

Ditto CLI — 2.3.0

• Allows users to override the output directory via a new environment variable DITTO_TEXT_DIR
• When no projects are found in the config.yml file an additional help message displays about verifying that the projects have developer mode enabled
• See the release here.

​

February 28, 2022

​

Ditto API

​

January 20, 2022

​

Ditto React — 1.1.1

• Our React SDK now supports variable interpolation by passing in values through the variables prop.
• Our React SDK now supports displaying plural forms through the count prop. For more information about using variable interpolations and pluralization through our React SDK, check out our SDK documentation.

​

Ditto CLI — 2.2.0

• The CLI now supports reading API keys from an environment variable (DITTO_API_KEY).
• See the release here.

​

January 11, 2022

​

Ditto CLI

• the pull command no longer crashes when projects other than the component library are specified in config.yml
• resolves a casing issue in the project add command that was causing it to crash

​

January 6, 2022

​

Ditto CLI

projects:
  name: Ditto Component Library
  id: ditto_component_library

​

December 8, 2021

​

Ditto API

• GET /projects/:id/components can now be used to fetch the components used in a project
• Return format matches the GET /components endpoint
• Supports format and variant parameters (the same as the /projects, /project/:id, and /components endpoints)

​

November 29, 2021

​

Ditto API

• GET /components can now be used to fetch the components in a workspace
  • Supports format and variant parameters (the same as the /projects and /project/:id endpoints)
• GET /projects/ditto_component_library has been deprecated; the endpoint is still available, but references to it have been removed from the documentation.
• PUT /components can now be used to update the text of components in a workspace
  • Currently only supports updating variant text via the variant query parameter (an error will be thrown if not specified)
  • Currently only available to teams on Team or Enterprise plans
  • Data is specified on data key in request body and must be in one of our three supported import formats

​

November 11, 2021

​

Ditto CLI — 2.0.0

• Output files are now written to disk in several different ways according to how the CLI is configured; most notably, if the variants option is set and a format of structured or flat is specified, output files will be written on a per-project per-variant basis
• Data for structured and flat formats is saved without arbitrary top-level nesting
• Files are only written for variants that contain values for the configured projects (no more empty files) For a more in-depth description (with examples) of these changes and others in the release, see the full release notes here.

​

Ditto React — 1.0.0

• ditto-react now only works with CLI version 2.x.x — leaning into new CLI improvements allowed us to drastically reduce many areas of complex logical overhead
• We made some stabilization improvements to the way that missing/invalid frameId, blockId, textId, or componentId values are handled
• We implemented significant refactoring in several areas of the project For a more in-depth description of these changes, see the full release notes here

​

Ditto Demo

• We added a new branch that showcases how Ditto can be integrated into a project with react-i18next
• We updated dependencies to the latest versions of the Ditto CLI (v2.0.0) and Ditto React (v1.0.0)

​

October 22, 2021

​

Ditto API — 2.4.1

• We fixed a bug with the API (and in-app exports) that included hidden text in flat and structured JSON exports. Now, hidden text will correctly not be included in these export formats!

​

Ditto Demo

• We included the files to import into the component library separately from where they’d be synced via the CLI
• We included more instructions on linking the demo app with its corresponding design file

​

October 7, 2021

​

General

• Refactored API documentation to be easier to navigate and communicate critical concepts more clearly

​

Ditto CLI — 1.1.1

• When the pull command is executed, all .json and .js files are now removed from the ditto folder prior to new data being written = Support added for new options in ditto/config.yml:
  • variants: true or false
    • If set to true, data will be fetched for both base and variant text and stored in separate JSON files
  • format: flat or structured - If specified, data will be fetched and stored in the specified format = Refactored README
• GET /variants will now return names and API IDs for variants in the workspace associated with the requesting user.

​

Ditto React — 0.0.5

• Support added for flat and structured formats
• Support added for passing a variant value to DittoProvider
• Bug fixes around support for integrating with workspace component libraries (as opposed to individual projects)
• Refactored README

​

Ditto Demo

• Refactored ditto-sdk usage to integrate with a component library instead of an individual project
• Added a language picker to showcase ditto-react and ditto-cli support for variants
• Refactored README, including adding instructions for connecting the repo to a component library

​

September 27, 2021

​

General

• Correct: ?projectIds[]=<PROJECT_ID>&projectIds[]=<PROJECT_ID>
• Incorrect: ?projectIds[]=<PROJECT_ID>,<PROJECT_ID>

​

API — 2.4.0

​

September 8, 2021

​

API — 2.3.0

• GET /projects and GET /projects/:id now accept an optional query parameter of variant; when provided, the data exported will be specific to the variant with an API ID that matches the parameter’s value. For default and structured formats, the variants key will not be included when the variant parameter is provided.

• GET /projects/:id will not include top-level projects and project_xyz keys Example request: GET /projects/123

{ projects: { project_123: { text_item: "Hello World", ... }}}

{ text_item: "Hello World", ... }

​

August 11, 2021

​

API — 2.2.0

​

July 28, 2021

​

API — 2.1.0

• GET /projects/:id will now return component variants. This applies both for when fetching projects or when fetching the component library (i.e. id = ditto_component_library)
• GET /projects/:id will now match the project JSON export from the web-app to include component information (is_comp and component_api_id) in the text object

​

June 21, 2021

​

Ditto React — 0.0.4

• If passed to DittoProvider, all descendant Ditto components will default to pulling text from the associated project
• If passed to Ditto, the component will pull text from the associated project
• If passed to both DittoProvider and Ditto, the value passed to Ditto will take precedence
• Breaking change: If a Ditto component is rendered that is not provided a projectId via direct prop or DittoContext ancestor, an error will be thrown

​

Ditto Demo

• Upgraded ditto-react to v0.0.4
• Updated source to work with new ditto-react version by passing projectId props to all instances of DittoContext

​

June 7, 2021

​

API — 2.0.0

• GET /project-names is the new name of the previous GET /projects endpoint. Just as before, this will return the names and IDs of projects in your Ditto workspace with Developer Mode turned on
• GET /projects/:id will now return the structured JSON in a format compatible with multiple projects
• GET /projects is a new endpoint that will return the content of multiple projects (specified via the query parameter projectIds) as a single JSON object

​

CLI — 1.0.0

• We’ve updated the CLI to handle syncing multiple projects in a single directory! This means several things: /ditto/config.yml now supports multiple projects. ditto-cli pull will pull all projects in the current directory’s /ditto/config.yml
• We’ve added two new commands to add and remove projects from /ditto/config.yml
  • ditto-cli project add
  • ditto-cli project remove
  • The regular ditto-cli project command will now function as ditto-cli project add

​

April 1, 2021

​

API — 1.1.0

• GET /projects now includes the Component Library if Developer Mode is enabled for the Component Library
• GET /projects/:id will return the Component Library as a structured JSON if the ID provided is ditto_component_library

​

February 25, 2021

​

API — 1.0.0

• GET /projects endpoint for fetching Ditto projects from workspace
• GET /projects/:id endpoint for fetching content in Ditto project as structured JSON