--- title: "TinyMCE AI Review" description: "AI Review feature for TinyMCE AI plugin" canonical_url: "https://www.tiny.cloud/docs/tinymce/latest/tinymceai-review/" md_url: "https://www.tiny.cloud/docs/tinymce/latest/tinymceai-review/index.md" version: "latest" last_updated: "2026-04-29T05:31:25Z" tokens: 2655 --- # TinyMCE AI Review The Review feature provides AI-powered quality assurance for content by running checks for grammar, style, clarity, tone, and more. Review always analyzes the entire document. For AI shortcuts on a selection or range, see [Quick Actions](../tinymceai-actions/). The editor enters read-only Review mode until the review completes or is dismissed. Suggestions appear in the Review sidebar and in the document; each change applies only after acceptance or rejection. The plugin introduces an intuitive interface for reviewing and managing AI-suggested edits directly within the document, ensuring content meets professional standards with minimal manual effort. The API offers the same functionality with flexible integration. The Review feature is available as a plugin UI and through the Reviews API. This page covers both: - Plugin sections describe user-facing features and configuration ([Review configuration](../tinymceai/#options-review)). - API sections cover REST API access (starting at [Reviews API](#reviews-api)). ## Demo The interactive demo below loads the editor with the Review feature. Use the Review toolbar button to open the Review sidebar and run the built-in reviews. **Example** ```js // Step 1: Set up session - this should be part of the application's user management process. // Open-source plugins below are only for editing the demo HTML (lists, links, tables). TinyMCE AI options are the focus. tinymce.init({ selector: 'textarea#tinymceai-review', height: '800px', plugins: ['tinymceai', 'advlist', 'lists', 'link', 'autolink', 'table', 'wordcount'], toolbar: 'undo redo | tinymceai-chat ai-quickactions-translate tinymceai-review | styles | bold italic underline strikethrough | alignleft aligncenter alignright alignjustify | bullist numlist outdent indent | link', sidebar_show: 'tinymceai-review', tinymceai_token_provider: async () => { return fetch('/api/tinymceai-token', { credentials: 'include' }) .then(resp => resp.text()) .then(token => ({ token })); }, tinymceai_chat_fetch_sources: () => Promise.resolve([{ label: 'TinyMCE resources', sources: [ { id: 'docs', label: 'TinyMCE Documentation', type: 'web-resource' }, { id: 'blog', label: 'Tiny Blog', type: 'web-resource' }, { id: 'survey-2023', label: 'State of rich text editing 2023', type: 'web-resource' }, ] }]), tinymceai_chat_fetch_source: (id) => { const urls = { 'docs': 'https://www.tiny.cloud/docs/tinymce/latest/', 'blog': 'https://www.tiny.cloud/blog/', 'survey-2023': 'https://www.tiny.cloud/developer-survey-results-2023/', }; return Promise.resolve({ type: 'web-resource', url: urls[id] }); }, tinymceai_quickactions_custom: [ { type: 'chat', title: 'Challenge', prompt: 'Challenge statements, verify facts and identify assumptions' } ], tinymceai_languages: [ { title: 'English', language: 'english' }, { title: 'Chinese (Simplified)', language: 'chinese' }, { title: 'Spanish', language: 'spanish' }, { title: 'German', language: 'german' }, { title: 'Japanese', language: 'japanese' }, { title: 'Portuguese', language: 'portuguese' }, { title: 'Swedish', language: 'swedish' }, { title: 'Korean', language: 'korean' }, { title: 'Hindi (Devanagari)', language: 'hindi devanagari' }, { title: 'Italian', language: 'italian' }, { title: 'Klingon', language: 'klingon' }, { title: 'Dothraki', language: 'dothraki' }, ] }); ``` ### Review sidebar and built-in reviews The figure below is a static screenshot of the Review sidebar in Review mode before any suggestions are returned. Built-in reviews are grouped by category (Proofread, Improve clarity, Improve readability, Change length, Adjust tone and style). Expand a category to read the description and select **Run** to analyze the whole document. In this example, **Improve readability** is expanded. ![Review sidebar showing review categories with Improve readability expanded and Run available](../_images/tinymceai/tinymce-ai-review-sidebar-command-categories-proofread-clarity.png) ## Integration To start using the Review feature, add `tinymceai` to the plugins configuration option. This will automatically add the ![Review icon](../_images/icons-premium/ai-review.svg) Review toolbar button and menu item to the default TinyMCE toolbar and menu. See [Plugin Reference](../tinymceai/) for more information regarding installation and enabling AI features. After picking one of the available reviews in the Review Mode tab, the AI will analyze the document and propose a series of suggestions: ![TinyMCE AI Review suggestion in content](../_images/tinymceai/tinymce-ai-review-mode-suggestions-underlined-in-editor-content.png) While in the Review Mode, the editor remains read-only and allows browsing suggestions. Suggestions can be clicked in the sidebar or selected in the editor content (underlined): ![TinyMCE AI Review sidebar with suggestions](../_images/tinymceai/tinymce-ai-review-improve-readability-suggestion-cards-and-underlines.png) Review suggestions can be individually skipped or applied by clicking the corresponding buttons. Changes that were accepted or dismissed become grayed out in the interface. The "Complete" button in the top of the sidebar enables actions such as: - Skipping or applying the remaining suggestions in bulk - Completing the review with the currently applied suggestions (and skipping the rest) - Aborting the review and exiting (with all applied changes reverted) ## Built-in reviews Built-in system reviews are listed below. The **Editor** column is the label in the Review sidebar when that review is available in the editor. The **API review** column is the system review name used in the [Reviews API](https://tinymceai.api.tiny.cloud/docs#tag/Reviews). | Editor | API review | Description | Editor UI | API | | --- | --- | --- | --- | --- | | **Proofread** | Correctness | Check grammar, spelling, and punctuation; the correctness API review also addresses factual errors. | ✓ | ✓ | | **Improve clarity** | Clarity | Improve logical structure, precision, sentence structure, word choice, and flow. | ✓ | ✓ | | **Improve readability** | Readability | Improve readability through sentence structure, paragraph structure, transitions, word choice, and reading level. | ✓ | ✓ | | **Change length** | Length Optimization | Shorten or lengthen the text while preserving key information. The editor offers *Longer* and *Shorter* options. | ✓ | ✓ | | **Adjust tone and style** | Tone Adjustment | Adjust tone and style. The editor includes *Casual*, *Direct*, *Friendly*, *Confident*, and *Professional* options. | ✓ | ✓ | | **Custom review** | — | [Custom review](#custom-review-choose-review): custom prompt and model; streams like other reviews. | ✓ | ✓ (custom review calls endpoint) | | | Translation | Translate between languages with cultural adaptation. | | ✓ | > **Note:** > - A checkmark in the Editor UI column means that review type can appear in the Review sidebar when it is listed in [`tinymceai_reviews`](../tinymceai/#tinymceai_reviews). > - [Custom review](#custom-review-choose-review) is included in the Review sidebar by default. The [Custom reviews (API)](#reviews-custom-reviews) section describes the REST endpoint used for the same streaming review flow. > - Translation Review is API-only (not listed in the Review sidebar); see the [Translation row](#built-in-reviews) in the table above. For translation from the editor, see **Translate** in [Quick Actions reference table](../tinymceai-actions/#quick-actions-reference-table). ## Custom review The Review sidebar includes a **Custom review** category by default. A natural-language prompt can be entered, and an AI model can be selected when [`tinymceai_allow_model_selection`](../tinymceai/#tinymceai_allow_model_selection) allows it; the review runs from **Run**. The document is analyzed with streaming suggestions like [built-in reviews](#review-sidebar-and-built-in-reviews); **Run** remains disabled until the prompt is entered and a model is selected. To hide Custom review, remove `'ai-reviews-custom'` from [`tinymceai_reviews`](../tinymceai/#tinymceai_reviews). > **Tip:** The backend uses the custom review call (`POST /v1/reviews/custom/calls`) with `content`, `prompt`, and `model` in the request body. After a run completes, **Retry** in the Review UI can re-run the last review with the same parameters for both system and custom reviews. ## Configuration Which built-in reviews appear in the Review sidebar can be configured using the `tinymceai_reviews` option. See [`tinymceai_reviews`](../tinymceai/#tinymceai_reviews) in the Plugin Reference for details. ## Reviews API The Review plugin feature is built on top of the Reviews API, which provides REST API access to review functionality. Reviews run a whole-document workflow: the editor analyzes the full document, streams suggestions, and applies changes only after acceptance or rejection in the Review sidebar. [Quick Actions](../tinymceai-actions/) are shortcuts to discrete AI operations on a selection or range (for example previewing a transformation, translation, or chat with context)—not the same end-to-end review flow. **Reviews compared with Quick Actions:** Reviews coordinate document-wide analysis and tracked suggestions in Review mode. Quick Actions expose individual AI capabilities from the Quick Actions menu without entering that workflow. See [Quick Actions](../tinymceai-actions/) for the available shortcuts and behavior. Reviews use streaming output with Server-Sent Events for real-time feedback as suggestions are generated. Each review type is optimized for specific improvement tasks, providing consistent, high-quality analysis of text structure, style, and quality. Reviews provide specific, actionable recommendations for content improvement. ### System reviews System reviews are default review operations for common use cases, which each use the AI agent most suitable for their functionality. The API includes one endpoint for running system reviews, which is passed the review name. Built-in system reviews including API names, descriptions, and whether each type is available in the Review sidebar or only through the API—are summarized in [Built-in reviews](#built-in-reviews). For endpoint details, request and response schemas, authentication, and streaming behavior, see [Reviews API](https://tinymceai.api.tiny.cloud/docs#tag/Reviews). ### Custom reviews (API) Integrators can also call the Custom Review API endpoint directly. It streams suggestions in the same way as system reviews but takes a custom `prompt` (and `model`) with document `content` in the request body. Custom reviews can be as simple as checking for specific words or phrases, or as complex as applying a company style guide that includes business logic, specific terminology, and more. See [Reviews API](https://tinymceai.api.tiny.cloud/docs#tag/Reviews) for the endpoint, parameters, and examples. Users can also run custom reviews directly from the editor through the [Custom review](#custom-review-choose-review) category in the Review sidebar. Custom reviews require the `ai:reviews:custom` permission in the JWT token. ### Streaming responses Reviews use Server-Sent Events (SSE) for real-time streaming results. See the [Streaming responses guide](../tinymceai-streaming/) for detailed implementation information. ### API reference The [Reviews API](https://tinymceai.api.tiny.cloud/docs#tag/Reviews) reference (interactive OpenAPI documentation) is the full source for endpoints, request and response schemas, authentication, system and custom review calls, worked examples, and streaming review responses. ## Related features - [AI chat](../tinymceai-chat/): For interactive discussions with document analysis and context. - [Quick actions](../tinymceai-actions/): Shortcuts to individual AI operations on a selection or range (transformations, translation, chat, and custom actions).