Skip to main content

Collaboration

Updated yesterday

Product text requires input from multiple teams, from design to content to legal. Ditto makes collaboration second-nature, and this guide will walk you through how to manage copy statuses, make suggestions to your text, and notify teammates when you need their input, all in Ditto.

💡 Check out this guide on setting up a review workflow in Ditto!


Statuses

Statuses are your team’s way to track progress of a text item in Ditto, and keep relevant team members in the loop. Using statuses allows writers and other collaborators to work on the right text items, signal to reviewers when it's time to chime in, and lets developers know when text is ready for production.

Set a status

  1. Select a text item to open the details panel

  2. Click the Status dropdown menu and choose one of the four status options

  • ⚪ None

  • 🔴 Work in Progress

  • 🟡 Ready for Review

  • 🟢 Final

💡 By default, a copy’s status is assigned as ⚪ None when first imported into Ditto

When a status is updated, the text changes color in the web app to reflect its new status.

Status changes are tracked in the Activity log, so you can see who made the update.

Statuses in Figma’s layer name

When you assign a status to a text item, Ditto adds a status emoji to the layer name in Figma. Designers can see the status of all text at a glance, even if they don’t have a seat in Ditto.

These status indicators are on by default. To change the settings:

  1. Click the three-dot menu in the top right of the Figma plugin

  2. Go to Settings and toggle Status indicator

Variant statuses

Each text variant can have its own status. For example, if the base text is Final, a Japanese language variant can still be set as Work in Progress.

By default, the variant text's status will be ⚪ None. When updated, a variant icon appears in the web app with the corresponding status color.


Tags

Add tags to text items to provide more specific, nuanced context on the type of copy it is, such as Heading 1 or Button. Tags can also be used to filter your text in your project view on the web app. You can manage your tags in workspace settings.

Attach a tag to a text:

  1. Select the text items you want to add tags to

  2. Create or attach a tag from the drop down menu

💡 You can add multiple tags to a text item


Assigning owners

You can assign any teammates in your Ditto workspace to specific text items for review, feedback, or ownership. For text items published to the Component Library, assigned owners will sync across all instances.

Assign a text item

  1. In the details panel, click Assign

  2. Search for a teammate in your workspace by name. You can only assign text to individuals in your workspace.

💡 Use Ditto’s multi-select shortcut (hold ctrl/cmd) to select and assign multiple text items at once

View your assigned text

You'll receive a notification (🔔 icon in the web app and via email) when text is assigned to you.

To find your assigned text in a project or the component library:

  1. Use the Assignee to filter for your name

  2. Refine results by filtering Tags, Status, Developer ID, and Page to your search.


Activity log

Ditto tracks all historical changes in the Activity log, which can be accessed from both the web app and plugin. It shows in chronological order any previous edits or comments made in this project, along with the user that made the change.

💡 Select a text item to see its own activity log

Revert edits

If you made an accidental edit or decide a previous wording was better, revert a piece of text back to any version in its edit history.

Restore a text edit:

  1. Select a text item and go to the Activity tab

  2. Find the version to revert back to and click Restore


Comments and @-mentions

Use comments and @-mentions to discuss copy revisions, ask questions, and get feedback from relevant team members.

Add a comment

  1. In the Comment section in the details panel, type your message.

  2. Mention anyone in your workspace by typing @ to see a list of your users.

  3. Click Add comment

💡 You can also add a new comment straight from the Comments tab

View all comments

All comments on a text item can be seen in the Comments tab when a piece of text is selected.

To view comments for the entire project, you can click the Comments tab when you don’t have any text selected. Click Go to text underneath a comment to jump directly to that text item.

Resolve a comment

Once a comment thread is ready to be archived, anyone in your workspace can click the checkmark icon on the top right corner of the comment to resolve the thread.

💡 You can un-resolve a comment anytime by clicking the checkmark icon again


Suggest edits

Collaborate with your team by suggesting edits to text you’re working on without making direct copy changes to your design. This is helpful to propose alternative phrasing for text or start a discussion around potential edits.

Make a suggestion

Enter Suggesting mode to make suggestions to your project text. You will remain in your selected mode to make changes in bulk.

Make a suggestion:

  1. Select a text item

  2. Switch from Editing to Suggesting mode

  3. Make a suggestion to the text and save

Accept or reject a suggestion

Suggestions are generated as comments, and are found in the Comments tab and the recent section of the details panel. You can reply to a suggestion like normal comments to discuss the proposed change with your team.

Respond to a suggestion:

  1. Find the suggestion under Comments

  2. Click Reply and write a response

Any suggestion can be accepted or rejected, and the person that accepted or rejected the suggestion will be displayed in the activity history. Accepted suggestions will immediately be reflected in the text.

Accept or reject a suggestion:

  1. Find the suggestion under Comments

  2. Click accept (✓) or reject (✕) the suggestion


Notifications

You’ll get notifications when you're assigned text, mentioned in a comment, or receive a reply. You will not receive a notification if you mention or assign text to yourself.

Web app notifications

Click the 🔔 icon in the bottom left of the web app to view all notifications. Clicking a notification takes you directly to the project.

Email notifications

By default, Ditto emails you when you’re assigned text or mentioned in a comment. Emails are threaded by project to reduce clutter, and include direct links to the relevant piece of text in the web app.


Shareable links

If you need to share a specific page, text item, or other view in Ditto, you can copy and send the URL. This will keep all filters, text selections, and design previews intact—so your teammate sees exactly what you do.

Did this answer your question?