Skip to main content

Guideline page commenting

Collaborate directly on your guidelines content.

Updated over 2 weeks ago

Commenting enables structured feedback and collaboration directly inside Frontify Guidelines. Leave contextual comments on pages, sections, or blocks, mention teammates, and resolve discussions, without switching to external tools.


What is Commenting?

Commenting allows editors, translators, and reviewers to give and receive feedback directly within guideline pages.

Instead of managing review cycles in Slack, email, or MS Teams, conversations are anchored to the exact content they refer to. This keeps feedback visible, structured, and actionable, all in one place.

Comments can be added inline and are organized in threads. You can reply, mention users, resolve discussions, and track open or resolved feedback through a centralized sidebar.

Key benefits

  • Structured collaboration directly inside Frontify

  • Contextual feedback at page, section, or block level

  • Clear overview of open and resolved discussions

  • Async collaboration across teams and time zones

  • Ability to gather feedback without granting edit rights

  • Faster and more confident publishing


Getting started

Who can use commenting?

Commenting is available to: Editors, Translators, Reviewers

  • Reviewers can fully participate in commenting but do not have editing rights.

  • Viewers and external users cannot see or interact with comments.
    ​

Adding a comment

  1. Open a guideline page.

  2. Click the comment entry point in the action toolbar.

  3. Add your comment:

    1. Page-level comment: Open the comment sidebar and ensure the page filter is active.

    2. Section or block comment: Select the relevant section or block inline while commenting is active.

  4. Write your comment and publish it.

  5. A visual indicator (badge with count) will appear inline to show that open comments exist.

Managing discussions

Within a comment thread, you can:

  1. Reply to comments

  2. Mention users with autocomplete (@). You can mention any individual user who has access to the guideline (for example, members of an invited group).

    1. Note: Mentioning entire groups is currently not supported in Guideline comments.

  3. Edit or delete your own comments

  4. Resolve threads once feedback is addressed

  5. Copy a direct link to a thread

  6. View by open, resolved, or all comments

  • All comments for a guideline or page can be viewed in a single sidebar overview.

  • In translation contexts, comments remain distinct and contextualized.


Notifications

Users receive email notifications when:

  • They are individually mentioned

  • Someone replies to their comment

Notification preferences can be configured globally or per guideline.
Currently, notifications are available via email only.

How it works

Comments are:

  • Anchored to specific content (page, section, or block level)

  • Visible only to users with commenting permissions

  • Clearly marked as open or resolved

  • Accessible via keyboard navigation

When navigating from an email notification, users are taken directly to the exact content location of the comment.

Mentions and groups

If a group (for example, a group of Editors) has access to a guideline, you can mention individual members of that group in comments.

This allows you to notify the right people directly and keep feedback targeted and actionable.

Mentioning entire groups (for example, @Marketing-Team) is currently not supported in Guideline comments. To involve multiple people, simply mention the relevant individuals in your comment.

Commenting is available only when themes are used.


Use cases

  • Reviewing guideline updates before publishing

  • Proof-reading and clarifying content

  • Async collaboration across distributed teams

  • Gathering stakeholder feedback without granting edit rights

  • Tracking and resolving structured feedback

  • Managing translation-related discussions


Known limitations

  • Commenting is only available for guidelines using themes.

  • Notifications are currently email-based only.

Did this answer your question?