---
title: "TinyMCE AI Introduction"
description: "Introduction to TinyMCE AI features and capabilities"
canonical_url: "https://www.tiny.cloud/docs/tinymce/latest/tinymceai-introduction/"
md_url: "https://www.tiny.cloud/docs/tinymce/latest/tinymceai-introduction/index.md"
version: "latest"
last_updated: "2026-07-02T01:24:13Z"
tokens: 1862
---
# TinyMCE AI Introduction

Integrate real-time AI writing assistance into your application with TinyMCE AI, with ready-to-go editor features available via the TinyMCE plugin, and custom functionality available via the API — even outside the editor. Speed up content creation and enhance editorial workflows across a wide range of use cases, from productivity boosts and proof-reading to content quality and consistency. All with your choice of LLM — including your own.

> **Note:** The TinyMCE AI plugin requires TinyMCE 8.4 or later.

## Demo

**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',
  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-chat',
  tinymceai_chat_welcome_message: '<p>Welcome to TinyMCE AI. Pick an action below or type your own prompt.</p>',
  tinymceai_chat_welcome_actions: [
    { text: 'Here are some actions to get started:' },
    { title: 'Summarize the document', command: 'TinyMCEAIQuickActionsSummarize' },
    { title: 'Continue writing', command: 'TinyMCEAIQuickActionContinueWriting' },
    { title: 'Translate to Spanish', command: 'TinyMCEAIQuickActionTranslate', value: 'spanish' },
    { title: 'Review my document', command: 'ToggleSidebar', value: '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' },
  ]
});
```

## What is TinyMCE AI

TinyMCE AI is an AI-powered writing assistant platform with two core components:

- **[TinyMCE AI plugin](../tinymceai/)**: Integrates the AI directly into TinyMCE, providing instant text rewriting, summarization, correction, and contextual chat help based on organizational style guides. It includes automated review tools and enterprise-ready functionality that integrates with existing systems without requiring custom infrastructure. The plugin is available for both Tiny Cloud and self-hosted TinyMCE; from TinyMCE 8.7.0, it can be installed from the `tinymce-premium` NPM package or as an addon `.zip`.
- **[TinyMCE AI API](../tinymceai-api-overview/)**: A state-of-the-art back-end AI engine that incorporates multiple models and delivers high-quality content. Any functionality available in the plugin is also available in the API, plus more, and the API can be used anywhere in your application — not just in TinyMCE. **The hosted AI service is currently available in Cloud setup only.**

These components enable teams to implement a full suite of AI writing tools quickly, delivering efficient content workflows that maintain brand consistency and integrate smoothly with document management systems. In addition, the plugin and API use the same authorisation mechanisms and share conversation history, enabling ease of integration with your application’s broader content authoring workflow — not just within TinyMCE.

Both components support multiple AI models, enabling a unified UI and API across the models your application needs. See [AI Models](../tinymceai-models/) for more information.

> **Note:** ⭐️ On-premises deployment for the AI service is available in early access; [Contact Tiny Support](/contact) for details.

## TinyMCE AI features

There are three main features of TinyMCE AI.

- [**Chat**](../tinymceai-chat/): Interactive AI chats with history and persistent context.
- [**Review**](../tinymceai-review/): Content analysis and proofreading, optimized for larger content.
- [**Actions**](../tinymceai-actions/): Fast, stateless operations for specific tasks.

> **Note:** Existing customers on paid plans can request a full featured free trial through the [Customer Portal](/my-account).

## Integration Options

TinyMCE AI can be integrated with applications through two methods: the plugin (for out-of-the-box editor features) or the AI service API (for custom integrations). See [Integration Options](../tinymceai-integration-options/) for details.

## Permissions

Developers can control access to AI features, models, and capabilities based on user roles, subscription tiers, and organizational requirements. Learn more about the [permissions system](../tinymceai-permissions/).

## Privacy and data handling

### Regional Data Storage

All data stored by Tiny for TinyMCE AI is handled in the US region.

Data sent to LLM providers for processing is currently handled in the US region. TinyMCE does not offer separate LLM processing regions to choose from.

### Data Retention Policy

Conversation data is automatically deleted after 12 months of inactivity, including:

- all conversation messages and history,
- attached documents, files, and web resources,
- conversation metadata and settings.

### Security

All data is encrypted in transit and at rest with end-to-end encryption. Conversations and attachments are stored in secure cloud infrastructure with fine-grained access control and comprehensive permission systems.

## On-Premises Deployment

On-premises deployment allows the AI service to run within an organization’s infrastructure, giving teams more control over data and infrastructure.

> **Note:** ⭐️ On-premises deployment for the AI service is available in early access; [Contact Tiny Support](/contact) for details.

## Next steps

- [Plugin Reference](../tinymceai/): Install the `tinymceai` plugin, configure authentication, and enable Chat, Review, and Quick Actions.
- [JWT Authentication](../tinymceai-jwt-authentication-intro/): Issue tokens for the hosted `TinyMCE AI` service.
- [AI Models](../tinymceai-models/): Review supported models, compatibility versions, and limits.
- [API Overview](../tinymceai-api-overview/): Call the REST API from application code outside the editor.
- [API Quick Start](../tinymceai-api-quick-start/): Obtain API credentials and connect to the service.
- [Integration Options](../tinymceai-integration-options/): Compare plugin-first and API-first integration paths.