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
Select a text item to open the details panel
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:
Click the three-dot menu in the top right of the Figma plugin
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:
Select the text items you want to add tags to
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
In the details panel, click Assign
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:
Use the Assignee to filter for your name
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:
Select a text item and go to the Activity tab
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
In the Comment section in the details panel, type your message.
Mention anyone in your workspace by typing
@
to see a list of your users.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:
Select a text item
Switch from Editing to Suggesting mode
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:
Find the suggestion under Comments
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:
Find the suggestion under Comments
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.