> ## Documentation Index
> Fetch the complete documentation index at: https://foliant-help.iforiti.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Describe a change with AI

> Tell the visual editor what to change in your own words, compare the result with your template, then apply it or ask for more.

Instead of finding the right block and setting yourself, you can describe a change in a sentence, such as "put the totals on the right and make them bold" or "add our bank details at the bottom". Foliant's AI makes the change with the editor's own blocks and settings. You see your template before and after, and nothing changes until you apply it and save.

## Before you start

* **Describe a change** is in early access, so not every store has it yet. If you don't see the button, it isn't available for your store yet.
* It works in the visual editor, so it depends on your plan. See [Visual editor plan availability](https://foliant-help.iforiti.com/template-editor/visual-editor-plans.md).
* Each change uses one **AI credit**. A change that doesn't work out doesn't use one.

## Describe a change

1. Open the template in the visual editor.
2. Click **Describe a change** in the bar above the page.
3. Under **What should change?**, write what you want, in any language.
4. Click **Show me**. Foliant usually takes a few seconds. To stop, click **Cancel**.

To change one block only, select it and click the pencil button (**Change with AI…**) at the top of the inspector, or choose **Change with AI…** from the block's menu in the **Blocks** outline. Foliant then changes that block and nothing else.

## Review the change

Foliant shows your template **Now** and **With the change**, side by side, both with the same sample order. Below them:

* **Changes** lists what Foliant did.
* **Couldn't do** lists anything you asked for that Foliant's blocks can't do, with the reason.

Then choose:

| Button | What happens |
| - | - |
| **Apply** | The change goes into the editor. Click **Save** to keep it. |
| **Refine** | Write what else should change (for example "a little smaller") under **Anything else to change?**. Foliant adds it to the change and shows the result again. Each refine uses one AI credit. |
| **Discard** | Closes without changing your template. |

## After you apply

* The change is one step: **Undo** in the editor takes it all back.
* Nothing is saved until you click **Save**. In the **Version history**, the version shows **Changed with AI**, with what you asked for. See [Save your changes and publish](https://foliant-help.iforiti.com/template-editor/save-and-publish.md).
* If part of the change no longer fits your template when you apply it, Foliant leaves that part out and tells you.

## What it can and can't change

Foliant changes your template with the same blocks, settings and document styles you can use yourself: it adds, moves, removes and styles blocks, and changes colours, fonts and spacing. It never writes code.

* **Custom Liquid** blocks and **Shared section** blocks can be moved or removed, but not changed.
* Order details such as names, addresses and prices come from each order when you print. Ask for the block that shows them (for example "show the shipping address"), not for the text itself.
* If Foliant can't make the change with its blocks, it tells you, and your credit isn't used.

## Good to know

* Foliant sends the AI your template's blocks and what you wrote. It doesn't send your orders or your customers' details.
* Check the result before you save. The preview uses a sample order, so your real orders may be longer or shorter.
* To build a whole template like the invoice you use today, use **Match your current invoice** when you create a template, if your store has it.

## Related articles

* [Add, move and remove blocks](https://foliant-help.iforiti.com/template-editor/add-and-arrange-blocks.md)
* [Style and place a block](https://foliant-help.iforiti.com/template-editor/block-style-and-layout.md)
* [Document styles](https://foliant-help.iforiti.com/template-editor/document-styles.md)
* [Save your changes and publish](https://foliant-help.iforiti.com/template-editor/save-and-publish.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.