> For the complete documentation index, see [llms.txt](https://docs.varbase.vardot.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.varbase.vardot.com/content-designers/ai-in-varbase/ai-tools-in-the-editor.md).

# AI Tools in the Editor

Varbase includes AI tools that help you write and check content: drafting and editing text in the rich-text editor, suggesting alt text for images, and reviewing a post before it is published. You stay in charge: every suggestion is yours to accept, change or discard. This page shows each tool.

{% embed url="<https://youtu.be/aYmUE-PteQc>" %}
Writing With the AI Assistant (Video)
{% endembed %}

{% hint style="info" %}
The AI tools work only after your site administrator connects an AI provider. If a button gives an error, ask them whether AI is set up on your site.
{% endhint %}

## The Privacy Prompt

The first time you use an AI tool, Varbase asks for your consent, because the tool sends your text or image to an outside AI service. For example, **Generate with AI** for alt text is replaced by the question **Transfer image and meta data to chosen AI service?**

* Click **Yes (this time)** to allow it for this visit only.
* Click **Manage privacy settings** to turn each AI service on or off for good. You can change this at any time.

<figure><img src="https://410909369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcuWLZ87gvtX5vA2YGD%2Fuploads%2Fgit-blob-848d18890b9e7c50719968a63ac2333389ae00d7%2Fai-tools-04-privacy-prompt.png?alt=media" alt="The consent prompt Transfer image and meta data to chosen AI service, shown in place of the Generate with AI button, with the Yes (this time) button highlighted"><figcaption><p>The Privacy Prompt Before an AI Tool Runs</p></figcaption></figure>

{% hint style="warning" %}
The privacy prompt covers **Generate with AI**, not the **AI image safety** check. When you upload an image on a site with the AI recipes, the safety check sends it to the AI provider straight away, without asking. Keep this in mind before uploading an image that should not leave the site.
{% endhint %}

<figure><img src="https://410909369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcuWLZ87gvtX5vA2YGD%2Fuploads%2Fgit-blob-fe401f26908dde3187d68c819e21006a36605d8d%2Fai-tools-05-privacy-settings.png?alt=media" alt="The privacy settings dialog with a switch for the Functional services, a switch for Live chat, a switch to toggle all services and the Save button"><figcaption><p>Managing Your Privacy Settings</p></figcaption></figure>

## Writing With the AI Assistant

In the **Rich editor** text format, used for blog posts, the toolbar has an **AI Assistant** button.

1. Select the text to work on, or place the cursor where new text should go.
2. Click **AI Assistant** and choose an action:

| Action                   | What it does                                                                   |
| ------------------------ | ------------------------------------------------------------------------------ |
| **Generate with AI**     | Writes new text from your instructions.                                        |
| **Modify with a prompt** | Changes the selected text the way you describe, for example "make it shorter". |
| **Reformat HTML**        | Tidies the formatting of the selected text.                                    |
| **Fix spelling**         | Corrects spelling and punctuation.                                             |
| **Summarize**            | Writes a summary of the selected text.                                         |

3. Read the result in the dialog, then insert it or try again.

<figure><img src="https://410909369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcuWLZ87gvtX5vA2YGD%2Fuploads%2Fgit-blob-76bf741273ae12edae713eb72b44e811f545a685%2Fai-tools-01-editor-menu.png?alt=media" alt="The AI Assistant menu open in the rich-text editor toolbar, listing Generate with AI, Modify with a prompt, Reformat HTML, Fix spelling and Summarize"><figcaption><p>The AI Menu in the Editor</p></figcaption></figure>

The **Content** format of utility pages has no **AI Assistant** button. For the full list and the actions that are off by default, see [Varbase AI Editor Assistant](https://docs.varbase.vardot.com/developers/understanding-varbase/varbase-ai-recipes/varbase-ai-editor-assistant.md).

## Suggesting Tags

On a blog post, **Suggest tags** next to the **Tags** field reads the text and proposes tags from the site's existing vocabulary. Keep the useful ones and remove the rest. Because suggestions come from the existing list, tags stay consistent instead of filling with near-duplicates.

<figure><img src="https://410909369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcuWLZ87gvtX5vA2YGD%2Fuploads%2Fgit-blob-db160d203a2440ed7b39df0926d6e41f32b13552%2Flearn-18-suggest-tags.png?alt=media" alt="A blog post edit form with the Tags field holding Multilingual, Global Audience, Varbase and Drupal, and the Suggest tags (AI) button marked below it"><figcaption><p>Suggest Tags Under the Tags Field</p></figcaption></figure>

## Suggesting Alt Text for Images

When you add an image, click **Generate with AI** next to **Alternative text**. Varbase describes the image in the language of the content. Check the suggestion against the picture before saving: the AI does not know why you chose the image. See [Image](https://docs.varbase.vardot.com/content-designers/media-management/uploading-media-files/image.md).

When an image is saved with its **Image description** and **Image tags** empty (in the **AI description and tags** group), AI writes a longer description and picks up to five tags from an image vocabulary. Fill either field yourself, and the AI leaves it alone.

{% hint style="warning" %}
An image larger than about 7.5 MB can be refused with **AI provider failed to evaluate the content** on **Alternative text** and **Focal point**, although the field accepts much larger files. Resize the image, then upload it again. See [Content Uploading Standards](https://docs.varbase.vardot.com/content-designers/additional-tips/content-uploading-standards.md).
{% endhint %}

<figure><img src="https://410909369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcuWLZ87gvtX5vA2YGD%2Fuploads%2Fgit-blob-a290283786ee1c946e1b7a9aa6bd2eed6250d9ae%2Fai-tools-02-alt-text.png?alt=media" alt="An image form with the Alternative text filled in by AI after clicking Generate with AI"><figcaption><p>Alt Text Suggested by AI</p></figcaption></figure>

## Filling Other Fields With AI

Tags, the SEO title and description, and the image description and tags are filled by **automators**: rules that let AI fill a field from other fields. Almost any field can have one, for example a summary written from the main text. An automator is set up on the field's own settings, with **Enable AI Automator** and **AI Automator Settings**. On a new site it is off for the other fields, such as the **Description** of a blog post, so ask your site administrator when a field should get one.

## Reviewing a Post Before Publishing

The **AI Review** tab on a blog post or utility page checks it against your site's **Editorial review** rules and lists suggestions.

1. Open the item and click the **AI Review** tab.
2. Run the review and wait for the results.
3. Read each suggestion, and apply or dismiss it.

<figure><img src="https://410909369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcuWLZ87gvtX5vA2YGD%2Fuploads%2Fgit-blob-2a1ef2cc80e34e2bf83d6c8cf7b1968f5db1adc6%2Fai-tools-03-review.png?alt=media" alt="The AI Review tab of a blog post with the Editorial review results and a list of suggestions"><figcaption><p>An AI Review of a Blog Post</p></figcaption></figure>

The **AI Review** column on the **CMS** list shows the latest result of each item.

## Building Pages With the Canvas AI Agent

The Drupal Canvas editor can also draft a page from a short request. On a new site this is limited to the **Super Admin**. See [Building Pages With the Drupal Canvas AI Agent](https://docs.varbase.vardot.com/developers/theme-development-with-varbase/drupal-canvas/building-pages-with-the-drupal-canvas-ai-agent.md).

## Who Can Use the Tools

| Tool                    | Roles                                                                |
| ----------------------- | -------------------------------------------------------------------- |
| AI button in the editor | **Content editor**, **Content Admin**, **SEO Admin**, **Site Admin** |
| Alt text suggestions    | **Content editor**, **Content Admin**, **SEO Admin**, **Site Admin** |
| AI Review               | **Content editor**, **Content Admin**, **Site Admin**                |
| Canvas AI agent         | **Super Admin**                                                      |

## Tips

* Treat AI text as a first draft. Check facts, names and numbers before publishing.
* Do not paste private or personal information into an AI request.
* Say what you want in plain words, for example "rewrite for a general audience, under 80 words".
