AI Suggestions (Beta)

AI Suggestions are an entry-level type of AI Action in Contentful that analyzes your content to generate insightful, actionable suggestions. Insight types include content quality checks, alignment with style guides. 

Unlike AI Actions that transform content, AI Suggestions focus on analyzing and suggesting. These produce stored results that can be reviewed, reused to maintain brand consistency and improve content quality assurance. 

AI Suggestions help teams keep content consistent, accurate, and on-brand by reviewing entries automatically.

The feature flags issues such as spelling, grammar, tone, brand compliance, translation accuracy, and SEO opportunities. All suggestions are presented directly in the editor, and users stay in control by reviewing and choosing which changes to apply.

• Spelling and grammar checks: catch errors across all entries.

• Brand compliance: enforce naming conventions, tone, and style consistently.

• Translation review: verify accuracy, tone, and cultural relevance in localized content.

• SEO optimization: identify improvements to metadata and content structure.

• Pre-publish review: surface potential issues during content editing, so they can be resolved before publishing, without switching tools.

How to use AI Suggestions: 

1. Navigate to an entry within your Contentful space where you want to perform content analysis.

2. In the entry editor, choose “AI Suggestions” from the AI dropdown. 

3. In the right-hand sidebar of the entry editor, open the AI Actions tab. If your space has AI Actions enabled, you’ll see a panel showing available actions for that entry.

4. AI Suggestions are visually distinguished by a light bulb icon. Transform Actions uses a lightning bolt icon. These two types are shown in the AI Actions configuration tab and categorized accordingly in the sidebar.

5. Select an existing AI Suggestions or create a new one by defining your instructions. You can write instructions like:

   • “Highlight any spelling and grammar issues.”

   • “Analyze this content against our brand guidelines.”

   • “Check for potential violations of compliance based on this document.”

For further reading, check out our AI Actions use cases.

You can enhance your prompt using variables, such as:

• Entry fields (e.g., title, body).

• Media files (now including PDF or text documents).

6. You can upload resources such as style guides or compliance documents to align with your content quality checks). To include a reference document:

• Go to the Media in the variable picker in your AI Action Instructions.

• Upload or select a PDF or text file (e.g., a style guide or legal policy document).

• Attach this as a variable in the AI Action. 

• Click Publish to use this action during analysis.

7. Click Run to execute the AI Suggestion. You can run it:

• Manually from the sidebar. 

8. Once processed, the AI Action results are displayed in the AI Actions sidebar. Results include:

• Highlighted text suggestions (e.g., red for removals, green for improvements)

• Annotations that reference your attached document (e.g., “Per Contentful writing guidelines, avoid bold text for emphasis”)

Every result is temporarily stored in the entry’s history and can:

• Be revisited or deleted at any time. 

• Be referenced as a variable in other AI Actions.

Running AI Suggestions in bulk can generate entry-level recommendations, allowing you to review differences and apply changes efficiently across many entries. 

AI suggestions work within the framework of our existing feature Run AI Actions in bulk which can run across multiple entries to review content at scale. 

To select entries to run AI Suggestions in bulk:  

1. Navigate to your list of entries in the content table. 

2. Select the entries you want to analyze. 

3. Choose the AI Suggestion from the Run AI Action dropdown menu. NOTE: choose the options for the AI Action, i.e. target locale. 

4. Click Start run to apply the AI Action to the selected entries in bulk. 

To view your selected entries and review the AI suggestions: 

1. Navigate to the AI Runs section, under the AI & Automations tab, select the run you want to review.
   

   

2. In the AI Runs table, use the status tabs to locate your run:

   • In progress - the AI is still generating suggestions for the selected entries.

   • Pending review - All suggestions have been generated and are ready for review.

   • Completed - the run has been reviewed and the selected changes have been applied.

3. You will find the Review screen divided in three sections. In the left sidebar, you can select and view the Pending and Reviewed entries of the selected run.
   

   

   
   In the middle of the screen is the selected entry. On the right sidebar, you can view the AI suggestions for that selected entry. NOTE: you can filter the entries by content type by selecting from list in the dropdown. 

4. For each AI suggestion, a dedicated card presents the suggested change, including a brief reasoning and the preview of the change. To apply that suggestion, click Apply at the bottom of that card, or click Dismiss to disregard and not apply the suggestion. To restore a suggestion after applying it to the entry, click Restore suggestion. 
   

   

5. Once each entry is reviewed, click Mark as reviewed to the accepted and rejected suggestions.

6. After reviewing all entries, click Apply to entries at the top right to confirm and apply all of the changes.

AI Action technical limits also cover AI Suggestions:

• AI Actions per space: 20. 

• Maximum simultaneous bulk AI suggestions: 2. 

• References: up to 200 per entry.

• It currently does not work with our existing Automations feature.  

• Invoked AI Actions per minute: 20. 

What are AI Suggestions? 

AI Suggestions are a type of AI Action focused on review instead of creation or complete transformation. They analyze individual entries for quality, brand consistency, and translation accuracy, then surface feedback and suggestions in a dedicated AI tab. 

How do AI Suggestions differ from regular AI Actions? 

While AI Actions create or transform content, AI Suggestions review existing content. Instead of directly modifying entries, they produce suggestions that you can choose to apply.

Where are suggestions stored? 

Suggestions are saved in the AI tab of each entry, making it easy to revisit or compare historical outputs. Please note: results are currently stored in your local browser storage, so clearing cache will remove them. 

Can I apply all the suggestions at once? 

Yes. You can apply them individually or use “Apply All” to implement all recommendations in a single step. 

Do AI Suggestions review referenced entries? 

Currently, AI Suggestions only analyze the core entry content. References are not resolved as part of the review. 

How accurate are AI Suggestions? 

While they can catch many issues, AI Suggestions rely on large language models and are not guaranteed to detect every inaccuracy or inconsistency. Results may vary, but all suggestions are reviewed and approved by users before being applied. 

Is there any pricing associated with AI Suggestions during the beta? 

No. Usage of AI Suggestions is free during the beta, with fair usage limits applied.

Who can run AI Suggestions in my space? 

Any user with edit access to entries and permission "Run AI Action" can generate AI Suggestions and apply them.