Review content with AI
Maintain consistency and quality across your content with AI-accelerated content reviews. Set up detailed review guidelines tailored to specific textual elements. Whether you are working with rich text or simple text elements, you can use AI to ensure your content meets the your standards by providing insightful comments and actionable suggestions.
Create effective review guidelines
The AI-powered content reviews are only as good as the review guidelines you provide. Without proper review guidelines, the AI might give you review suggestions that are vague, inaccurate, or contradictory to one another. Here are a few tips for crafting effective review guidelines.The content review guidelines must be in plaintext, but that doesn’t mean they should be without structure.We recommend structuring your guidelines with headings, paragraphs, and lists. This means using a markup language, such as Markdown, AsciiDoc, or ReStructuredText, to make the guidelines clearer for the AI assistant to understand and interpret.
Make sure your rule descriptions are explicit and leave little to no room for interpretation. Imagine you give the review guidelines to your new colleague as part of their onboarding. They need to understand the rule the way you intended.If your review guidelines contain many rules, ensure that following one rule doesn’t lead to a violation of another rule.
Explain what it looks like when a rule is followed and when it’s broken. What’s correct? What’s incorrect? Don’t be afraid to state the obvious and provide multiple examples. By adding examples for each rule, the content reviews become more accurate and leave less room for error. For example, let’s say you have a rule about directness that aims to avoid using words like “please”.
Creating great review guidelines is an iterative effort. Adjust them over time based on your content creator’s feedback. You might find that some rules can be more explicit or use better examples.It can feel similar to tweaking an AI prompt until it does just what you need on the first try.
Set up review guidelines
AI-accelerated content reviews work on a per-element basis. By default, they are available for all supported text and rich text elements. Optionally, you can configure content review guidelines for your content type elements to specify the default guidelines for the element. For best results, we recommend creating multiple context-specific content review guidelines so content creators can choose the right one based on their current needs.- In
Content model, open a content type for editing. - For a rich text or text element, click its
. - In Content review guidelines, click the input field.
- Select the preferred content review guidelines, such as Example of general style guide.
- Click Save changes.
Check your content against its guidelines
Once you set up content review guidelines for your elements, you can review an element’s content by clicking
.
During the review, the AI adds comments and suggestions to your content. Each comment explains the reason behind flagging a specific part of your content, and each suggestion provides a possible fix for the issue.
Considerations
When reviewing your content with AI, keep in mind the following:- The reviews work only for textual elements in content items, not components.
- The review is one level deep. If your rich text elements contain components or content items, this inserted content won’t be reviewed as part of the rich text element review.
- Responses are in English. You can review content in languages other than English, but the AI only provides comments in English. For example, if your content review guidelines are in Dutch and you use them to review Dutch content, the AI assistant’s reasoning will be in English, but its suggestions will be in Dutch.
- The reviewed content element must contain 10 words or more.