<- Back to all posts

Introducing: Ditto Support for Figma Branching

Jolena Ma
January 18, 2023

At Ditto, our goal is to make it easy for teams to manage their product text from design all the way to development with a single source of truth. By allowing everyone on a team to access, reference, and reuse the same set of up-to-date content, teams can work faster, reduce copy errors, and increase copy consistency.

From working with hundreds of teams, we’ve realized that, in practice, a “single source of truth” can look different for different teams. Especially for teams at scale, a “single source of truth” might not necessarily mean everyone working out of the same place, at the same time, all the time. Requiring everyone on teams with lots of collaborators to edit the same file can lead to issues like work getting overwritten, limited iteration and exploration, confusion over what’s been updated, and more.

Developers have long combatted these issues using the concept of branching, which allows team members to iterate safely in separate environments that are connected to the main source of truth, and then merge those changes back in one they’re approved. Recently, designers got to experience the same workflow with Figma’s launch of branching.

Time and time again, we've heard from teams that want to use Ditto to manage copy in their Figma branches so they can reap the same benefits of branching for copy. Today, we’re excited to announce Ditto’s new-and-improved integration with Figma branching to enable exactly that! Teams on Figma's Organization or Enterprise plan that are using Figma branching will now have access to version control that’s built for copy in Ditto, so teams of any size — whether 2 or 200 — to maintain a centralized source of copy truth.

How does it work?

Importing a Figma branch into Ditto

When you create a new branch for a file in Figma, you’ll be able to import that directly into Ditto. If you’ve already been working on the main branch of that Figma file in Ditto, you’ll be able to just pick up where you left off — Ditto will bring over existing work for any text that’s the same between the two branches. This includes: Blocks, Components, status, notes, tags, and variants.

We'll bring over existing work for any text that's the same between the two branches, including status, notes, components, etc.

Working on copy in a Figma branch

As you’re working on the copy in a branch, you’ll be able to take advantage of all of Ditto’s text management features. This includes reusing Ditto content components from your team’s library, creating new content components for reuse, marking text status, tracking edit history, assigning reviewers, suggesting edits, managing variations of copy, and more.

Work you’re doing in the branch project in Ditto won’t affect anything in the Ditto project synced to the main branch, so you’re free to iterate and test changes out.

Merging a Figma branch

When the Figma branch is merged, Ditto will take care of everything around making sure that copy gets merged correctly, both in Ditto and the designs. Ditto will make sure your copy stays in-sync with design and development at all times, track all changes, and surface any overrides or conflicts.

After merging a Figma branch

After you merge a branch in Figma, the Ditto project corresponding to that branch will get “archived.” This means all the work you did on text in that branch in Ditto — including all change history, comments, and edits — will get preserved. You’ll be able to refer back to all changes, discussions, and decisions made in that branch with full context in the future.

Why does it matter?

With these updates, teams in Ditto will be able to manage copy on design branches more effectively, so that it’s easier to collaborate on copy at scale:

  • Keep the copy source of truth accurate and reliable — with Ditto, you can allow any number of collaborators to contribute to your content source of truth, without risking its stability. Collaborators can safely explore and iterate in their own environments that are still connected to the main source of truth, making it easy to incorporate changes when they’re ready. All changes and any potential conflicts are reviewed, tracked, and resolved, though, so you can make large (even breaking!) changes in a structured, organized way.
  • Iterate faster and more freely on copy — with Ditto, multiple collaborators can safely try out different versions of copy without fear of disrupting each other’s work, and can speed up that exploration by building directly off the main source of truth. Ditto also takes care of making sure copy stays in sync with Figma at all times, so you can test out copy changes directly in context of the latest visuals. You never have to worry about writing or editing content for outdated mockups, or your copy changes getting overridden when the design branch is merged.
  • Use version control that’s built for text — with Ditto, you can iterate on copy in branches using tools that are built for text, whether it’s creating reusable text components to speed up your workflow or allowing reviewers to suggest text edits. All edits will be tracked, merged, and communicated in a way that makes sense for text and allow for decision-making context to be preserved and greater transparency across the team.

To get started, just head to your Ditto workspace and import a branch of a Figma file! You can also read our full help guide to learn more.

Success! 🥳 Look forward to Ditto updates in your inbox.
Oh no — something went wrong while submitting the form. Please try again!