Permissions & Review
An agent writes into a page's unsaved changes, the same ones your typing in the Panel creates. By default, you review them in the Panel and publish or discard them as you would your own; an agent with Publish changes can publish them itself.
What Each Permission Allows
Every permission stops at your role: a page your role can't update, the agent can't change, and a page your role can't access, the agent can't reach. A change to your role applies at once.
Read Content
Lets the agent read the site's languages and the pages, drafts, and files your role can access, with their fields, and view images. Where content has unsaved changes, the agent reads those. To show you what publishing would change, it reads the published values too.
Prepare Changes
Lets the agent write field values to the unsaved changes of a page, a file, or the site, one language at a time. It also creates pages as drafts and uploads files to drafts.
- The title is a field. It goes into the unsaved changes like any other, if your role may change it.
- The slug isn't a field. Changing it takes Publish changes, since the new URL is live at once.
- Disabled fields stay.
- Some field types stay. A plugin's own field type is yours to edit in the Panel, unless it extends a core field or a plugin maps it to a core type.
- Shared fields go in the default language. A field with one value for all languages is written in the default language only.
- Scripts stay out. The agent can't add scripts, script links,
<style>elements, inline SVG, embeds, or event attributes to a field, whether written out or produced by KirbyText. Markup an editor placed survives a rewrite.
Publish Changes
Lets the agent publish or discard unsaved changes, change a page's status to listed, unlisted, or draft, change its slug, and move it below another parent. Changes with validation errors stay unpublished. A draft's changes publish anyway, but the draft stays a draft while it has validation errors or unsaved changes, or while a subpage or file going live with it has unsaved changes.
Like the Panel's Save button, the agent publishes all unsaved changes of a page in one language, whoever made them – your own unfinished edits included. Publish or discard those yourself first if they aren't ready.
It also uploads files to published pages and the site, since such an upload is live at once. Only a new file's field values, such as its alt text, wait for review. The file template's accept options apply, as in the Panel.
Delete Content
Lets the agent delete pages and files, their unsaved changes included. A page with subpages stays, and so does a page or file a colleague is editing in the Panel.
Deleting a page deletes its files too, so the agent deletes a page only where you may delete each of its files.
Review an Agent's Changes
Each write hands the agent a link to the changed content in the Panel to pass on to you. Where the page has a preview, the link opens the comparison of the unsaved changes and the published page, in the language the agent wrote. Publish or discard the changes there, one page and one language at a time.
For up to 10 minutes after an agent's write, colleagues see the page as being edited by you.
Working Alongside an Agent
An agent writes to a page even while you have it open in the Panel, so you can ask it to rework the page in front of you.
While a colleague is editing the page, the agent can't change it and tells you who is editing.
Unsaved changes a colleague left on the page stay: the agent's write adds to them, and the Panel then shows them as yours. The agent tells you, so you can review both before publishing.
An Open Page Reloads
When an agent writes to a page you have open in the Panel, the view reloads within seconds, and a notification says An agent changed this content, so the view was reloaded. Typing in the meantime keeps what the agent wrote; only a field you both changed keeps the value written last. If you click Save or Discard before that reload, the view reloads instead, and a notification says why. Check what would go live or be thrown away, then click again.