How To Use The CanvasAI Engine

The CanvasAI Engine builds and edits pages inside the Block Editor, using Canvas's own blocks. You describe a change in your own words, it proposes the blocks, text and settings that make it happen, and nothing on your site changes until you apply the proposal. This page walks through opening the panel, asking for a change, reviewing and undoing it, and the permissions, credits and Memory that sit around every request.

The CanvasAI Engine is part of Canvas Core 1.1.0. Update both the Canvas theme and Canvas Core to 1.1.0 or later before you look for it, as How To Update Canvas explains. The panel appears only on a site with an active Canvas license whose plan includes CanvasAI Engine credits, and only for people the Available To setting on the AI tab of Theme Options allows.

How To Open The Panel

Starting screenthe Block Editor, on the page or post you want to change.

You can open the panel from any of these places:

  • The editor's top bar. Choose Options, the three dots at the right of the top bar, then CanvasAI Engine. To keep a button for it in the top bar, choose Pin to toolbar in the panel's header.
  • A block's options. Select a block, open its options menu in the block toolbar and choose Ask CanvasAI Engine. The panel opens with that block already selected.

The panel works in the visual editor only. If the code editor is open, switch back to the visual editor first.

How To Ask For A Change

Type what you want in the box at the bottom of the panel, for example "Add a pricing section with three plans" or "Rewrite the hero heading for a dental clinic", then choose Send. The suggestions above the box are a good place to start on an empty page.

What you select decides what the CanvasAI Engine looks at:

  • With blocks selected, the request is about those blocks. The panel lists them above the box, each with a button to deselect it.
  • With nothing selected, the CanvasAI Engine looks at the whole page.

While it works, the panel shows each step it takes and the most credits the request can use. Choose Stop to end a request early; nothing is changed. A message you type while it is busy can be queued with Queue, and it is sent as soon as the current request finishes.

The CanvasAI Engine writes the words as well as the layout. Headings, paragraphs, buttons and lists arrive as real text in real blocks, so you can edit every word afterwards in the usual way. When a request is unclear, it asks a question first, with suggested answers and a box to answer in your own words.

If nobody on the site has allowed Canvas AI to send content yet, the panel asks for that permission first. Choose Allow to continue. The CanvasAI Engine needs to read the page to change it, and the permission covers the whole site, so it is asked once rather than on every request.

How To Review And Apply A Change

Every request that changes something ends in a review card headed Proposed changes. It lists each change in plain words, such as a block added after another or a heading's text changed from one wording to another, and tags each one as Added, Removed, Moved, Replaced or Changed.

From the review card you have three choices:

  • Apply changes puts the proposal on the page straight away.
  • Preview opens a window showing how the changed blocks will look, so you can judge the result before deciding.
  • Discard drops the proposal. Nothing is changed.

A change that removes blocks asks you to confirm and lists what it removes, because removed content is the easiest thing to miss in a long proposal.

Applied changes to the page sit in the editor like any edit you make by hand. Choose Save or Update to keep them, as you would after any other edit.

How To Undo A Change

Choose Undo this turn under the applied change. One click reverses the whole request, however many blocks and settings it touched, because the CanvasAI Engine applies a request as a single step. The editor's own Undo in the top bar reverses it as well.

Note

After you reload the editor, a change can only be undone with the editor's Undo. If you have edited the same blocks by hand since, the panel says so and asks you to undo those parts yourself, so your own later work is never thrown away.

How Credits And Refunds Work

Each request spends CanvasAI Engine credits from your license's allowance. These are separate from the credits used for writing and images, and the allowance depends on your license:

  • Yearly licenses include 125 CanvasAI Engine credits a month, on top of the 200 writing and image credits.
  • Lifetime licenses include 1,500 CanvasAI Engine credits once. They never expire, and up to 100 of them can be used in a month.
  • Starter subscriptions include 50 CanvasAI Engine credits a month, alongside 200 writing credits and 30 image credits.
  • ThemeForest purchases include no AI credits.

The panel shows the balance above the conversation. A monthly allowance shows the date it resets; one-time credits show how many are left and how many of them you can still use this month. Each finished request shows the credits it used. Requests you stop before they finish use none.

When a request fails, its credits are refunded automatically. The receipt under that request shows the amount refunded, and your balance is restored without you asking. If your balance is too low to start a request, the panel says how many credits a request needs and, for a monthly allowance, when it resets, with a See plans link. Credits And Plans covers allowances and plans, and When AI Is Unavailable explains the other messages you may see.

How To Let It Use Your Media Library

The CanvasAI Engine never looks at your media library without asking. The first time a request needs images, the panel asks whether it may see the library, and offers three answers:

  • Allow once lets it look for this request only.
  • Always allow on this site lets it look whenever a request needs images. The permission is yours alone, so another editor on the same site is still asked.
  • Don't allow keeps the library closed, and the request carries on without it.

With permission, it reads the titles, alt text and sizes of your images so it can choose ones that fit. It uploads nothing and deletes nothing. To take back a permanent permission, open the panel's options menu and choose Revoke media library access.

How To Change Theme Options

Some requests are best answered with a site setting rather than a block, such as switching the blog to a grid layout. The CanvasAI Engine can change Theme Options for these requests, and a few page settings as well.

Theme Options changes appear in their own Site-wide change section of the review card, because they apply everywhere the site uses them, not only on this page. Applying them opens a confirmation, Change site-wide settings?, which lists every setting that will change. They are saved as soon as you confirm, and Undo this turn restores the previous values.

Only administrators can apply Theme Options changes. License, security, White Label, tracking and custom code settings are never changed by the CanvasAI Engine, whoever asks.

The CanvasAI Engine can change the hero, header and footer that the page shows, in the same request as the page itself. Each one appears as its own group in the review card, named after the hero, header or footer it changes.

Most pages use the site's header and footer rather than their own. When that is the case, the group is labelled (site-wide), for example Header: Main Header (site-wide), and applying it changes that header or footer on every page that uses it. When the page has its own header or footer assigned, the label carries no such note and the change stays with the pages using that design.

The editor shows hero, header and footer changes straight away, before you save. Choose Save or Update to keep them; the save panel lists each hero, header or footer that changed alongside the page.

How Memory Works

The CanvasAI Engine keeps short notes between conversations on a site, such as your brand name or the spelling you prefer, and uses them in later requests. This saves you repeating the same preferences every time. When it saves a note, the reply shows it as Noted: with a Forget button beside it.

To see everything it remembers, open the panel's options menu and choose Memory. The Memory view has two lists:

  • About you holds notes about your own preferences. Only you see these.
  • About this site holds notes every editor of the site shares, such as the business name. Only editors who can edit other people's posts can change these.

Choose Forget beside any note to delete it, or Forget everything to clear a list. Deleting cannot be undone.

The Remember things between conversations switch at the top of the Memory view turns memory off for you on this site. While it is off, the CanvasAI Engine neither reads nor saves anything for you. Notes that go unused for 12 months are deleted automatically.

What Happens To Your Requests

Your requests, the replies and the proposed changes are kept for 30 days, then deleted. The page content sent with a request is deleted within an hour. Notes in Memory follow their own rule, described above.

Animations In The Editor

Animations, sliders, tickers and other scripted effects run on the live page, not in the editor. The editor shows a still frame instead, so you can select and edit the block comfortably. A block with an effect like this carries a small hint, and its settings explain why it looks still. Use Preview in the editor's top bar to see the effect play, including on anything the CanvasAI Engine added.

Pitfalls

The CanvasAI Engine panel is missing. The panel needs Canvas Core 1.1.0 or later, an active license whose plan includes CanvasAI Engine credits, and your account in the Available To setting on the AI tab of Theme Options. It also only opens in the visual editor.

A header change appeared on other pages. The header was labelled (site-wide) in the review card, so the change went to the site's header. Choose Undo this turn, assign the page its own header, then ask again.

The proposal did not include a Theme Options change you expected. Only administrators can apply them. Ask an administrator to make the request, or change the setting in Theme Options by hand.

An animation does not play after a change. Animations play on the live page only. Use Preview to see them.

Credits And Plans explains allowances, and Heroes and Footers And Copyright Bars cover the same designs by hand.

Was this page helpful?
How To Use The CanvasAI Engine · Canvas WP Docs