Comments and editing

The preview panel shows the web page, email template, email draft or text message you're working on. This page covers how the panel keeps up with the assistant's changes and with saves made elsewhere, so you're always looking at — and editing — the latest version. It also covers Select, which lets you change an element's color, size, image or link by clicking it — see Select and the property panel — and Comment, which lets you pin a note or a request to an element — see Comments.

When the assistant changes what you're looking at

When the assistant finishes a reply that changed the item open in the panel, the panel loads the new version on its own. You don't need to press Refresh, and the panel doesn't flash a loading screen while it does it. If the reply didn't actually change the item's content, nothing reloads.

  • Web pages keep your place. If you had scrolled down the page, you stay at the same spot after it reloads.
  • Emails start at the top. An email whose content changed reloads from the top of the message.
  • Publishing and sending count too. When the assistant publishes or unpublishes the web page you have open, or sends, schedules, reschedules or cancels the email or text message you have open, the panel's status updates when the reply ends.
  • Text messages show the new wording and audience. When the assistant rewrites the text you have open or changes who it goes to, the panel shows the new version when the reply ends.

When the assistant changes the content of a web page, email template or email draft, the panel's header says Updated by the assistant. A reply that only publishes, sends, schedules or cancels the item updates its status without adding the label. The label stays until you start editing the item or the item changes again. To take the assistant's change back, click Undo in the panel's toolbar, or ask the assistant to undo it — see Version history.

Web pages and email templates also have a Refresh button in the panel's toolbar, for changes a teammate made while you had the panel open. Refresh brings Undo and History up to date along with the content.

While you're editing text

When you're editing with the pencil, the panel never replaces your text on its own. If the assistant changes the item while the editor is open, the panel shows The assistant updated this. with two choices:

  • Reload loads the assistant's version into the editor. Text you typed that hasn't been saved yet is discarded.
  • Keep editing carries on with your version. If the assistant's version is newer than the one you started from, your next save is refused and the panel asks you to reload (see below).

If you close the editor first, the message stays with just Reload.

Refresh is unavailable while the editor is open, so a stray click can't throw away what you're typing. Close the editor, or use the message's Reload, to load the newer version.

If an email draft is sent or scheduled while you're editing it, the editor closes as soon as the panel learns of it and tells you the email is no longer a draft, so it can't be edited. Text you hadn't saved yet isn't saved. When the assistant sends or schedules it, the panel learns of it as the reply ends and shows the email as the assistant left it. When a teammate does, it learns of it at the latest when your next save is refused.

When someone else changed it first

The saves you make in the panel are checked against the version you were looking at. If a teammate or the assistant saved a newer version in the meantime, your save is refused rather than overwriting theirs, and the panel says This was changed elsewhere, so your last edit wasn't saved. Choose Reload to see the latest version, then make your change again.

While that message is up, the editor stops saving as you type: every save would be refused the same way. Pressing Done tries once more, is refused, and keeps the editor open. Reload puts the latest version in the editor — for an email, its name, subject and preview text too — and discards the text you hadn't saved. Saving as you type starts again from there.

It works the other way round too. When the assistant makes a small edit to a web page, an email template, a blog post, a document or a social post — changing some text, a link or a color — at the same moment you save it, the assistant re-applies its edit on top of your saved version instead of overwriting it. A full redesign or rewrite by the assistant still replaces the content, as asking for one would.

Undo, Redo and restoring a version from History are checked the same way: if the item changed since the panel loaded it, nothing is undone, and the panel shows the newest version and says so. See Version history.

If the panel can't load the newer version

If a reload fails — a network hiccup, for example — the panel keeps showing what you had and says Couldn't refresh. Use Refresh to try again. If you're editing at the time, your edits are untouched. The panel never lets you edit an older version as if it were the latest: a save from it is refused and asks you to reload.

Select and the property panel

Select lets you change one element at a time — a section's background, a headline's size, a button's link, a picture — by clicking it. The element's settings open in a panel beside the page, and each change saves as you make it. You don't need to describe the change to the assistant.

Use Select for how an element looks and where it points. Use the pencil for the words themselves, and ask the assistant for anything bigger, like a new section or a different layout.

Where Select is available

Select is on the preview panel's toolbar for:

  • Web pages, on the Preview tab. Pages that draw themselves with their own script have no pencil, but they do have Select.
  • Email templates.
  • Email drafts, on the Template tab.

It isn't offered for text messages, blog posts or other kinds of artifact. It also isn't offered when the item can't be edited: an email that is no longer a draft (sent, scheduled or failed), or an archived web page or template.

Turn Select on

Click Select in the toolbar, next to the pencil. The button reads Close select while Select is on; click it again to turn Select off.

While Select is on, the item is shown as it looks, but clicking doesn't do what it normally would. Links don't open, forms don't submit and the page's own buttons don't run. An email is shown in its Web view.

The first time you use Select on an older item, the app gives its elements small hidden ids so the panel can tell them apart. That is saved as a version named Added element ids, made by System, which you may see in History. It doesn't change how the item looks. Undo skips over it: it takes back the change before it, not the ids. On a published page the ids don't by themselves turn the button into Publish changes.

If Select can't open, the toolbar says why, for example "This page has no elements that can be selected." or "Couldn't prepare this item for selecting. Try again."

Pick an element

Move the pointer over the item. A dashed outline shows what a click would select, and a label tells you what it is and where it sits, outermost first — for example Section › Hero. Click to select it. The outline turns solid and the panel opens.

If you click something that isn't an element of its own, Select picks the closest element around it.

To close the panel, click Close properties in its header, or press Esc. On a narrow preview the panel opens over the item instead of beside it; clicking outside it closes it too.

What the panel offers

The panel's header names the element by its place on the page, with its tag underneath. Below that are the fields for that kind of element:

ElementFields
Section or columnBackground, Padding, Corner radius, Border
TextText color, Text size, Weight, Align
ImageImage, Alt text, and Link when the image sits inside a link
ButtonBackground, Text color, Text size, Weight, Corner radius, Link
LinkText color, Weight, Link
DividerBorder, Padding
SpacerPadding
Anything elseNo fields, only the buttons for moving, copying and deleting

The panel shows only what it can change on that particular element, so you may see fewer fields than the table lists. For example, a button on a web page has no Link field.

In an email, the words inside a text block or a button can carry their own color, size, weight or alignment, which wins over the block's. Those fields show greyed out with the current value, under the note "This text sets its own style — ask the assistant to change it."

  • Colors. Your brand colors from Business DNA show as swatches, with the current one outlined. Click a swatch to use it. The dashed + (Custom color) opens a color picker and a box for a code like #1a2b3c. If you haven't set brand colors, only the custom color shows. A swatch saves at once. A drag in the picker saves once you pause. The box saves once you've typed all six digits.
  • Text size is 8 to 96 px. Corner radius is 0 to 200 px.
  • Weight is Normal, Medium, Semibold or Bold. Align is left, center or right.
  • Padding has a box for each side, labeled T, R, B and L (top, right, bottom, left), each from 0 to 200 px.
  • Border is None, Solid, Dashed or Dotted. For a visible border you also set the width, from 1 to 20 px, and its color.
  • Image. Replace image opens your image library. Pick an image, or use Upload new… or Generate new… to add one. You can also paste an address into the box below it; it saves when you press Enter or click away.
  • Alt text describes the image for people who can't see it, in up to 300 characters.
  • Link is the address a button, link or linked image goes to. It saves when you press Enter or click away, and can't be left empty.

Move, duplicate and delete

The row of buttons at the bottom of the panel works on the whole element:

  • Move up and Move down swap it with the element above or below it.
  • Duplicate puts a copy next to it.
  • Delete removes it. The panel closes and a small bar over the item says Element deleted. with an Undo button.

When the same element appears more than once, for example a card the page draws once for each item in a list, the panel says Applies to all N items. A change you make applies to every copy.

Undo in the panel

The panel has its own Undo, the arrow at the right of the bottom row (Undo property change). It takes back your last change in the panel, and you can keep pressing it. It remembers up to the last 20 changes while Select is on. A drag in a color picker, or a run of typing in a size box, counts as one change.

The toolbar's Undo is the other one. It works on versions, as described in Version history. It takes back the latest saved version, whoever made it, and Redo and History work the same way. Changes you make in the panel are saved as versions too. A burst of them within a few minutes is one version, listed in History as Edited by hand. The toolbar's Undo and Redo wait while a panel change is still being saved.

The panel's Undo starts empty each time you turn Select on, and it is cleared when the item changes in any way other than through the panel:

  • the assistant changes it;
  • you press Refresh;
  • you use the toolbar's Undo or Redo, or restore a version from History;
  • the panel finds out that someone else saved first (see When someone saved first).

The version underneath has changed, so the panel's steps no longer fit it. The Undo is greyed out until you make a new change in the panel.

When a change is refused

Some changes can't be made safely from the panel. The panel tells you why, in a short line under its header, and changes nothing. Most of these end with "ask the assistant instead", and that is the way forward: describe the change in the chat.

  • Forms. "Forms can't be removed, copied or moved here — ask the assistant instead." Fields inside a form are protected the same way.
  • The page's app. "This holds the page's app, so it can't be removed, copied or moved." This is the element the page's script draws into.
  • Code on the page. "This is set by the page's code — ask the assistant instead." The value comes from the page's script, so a change here would be overwritten. Other messages explain that an element holds some of the page's code, or that a change "would break the page's code".
  • An email's unsubscribe link. "The footer with the unsubscribe link can't be removed, copied or moved." and "The unsubscribe link can't be removed." Every email has to keep a working one.
  • Merge tags. "Write merge tags like {{ contact.first_name }}." If you type a merge tag in an older style, the panel asks for the standard form instead of rewriting it. A change that would cut through a merge tag, or move an element past a condition in the email, is refused too.
  • An image with no link. "This image isn't linked — ask the assistant to add a link."
  • A value that isn't allowed. A size, color, address or alt text outside the allowed range or format gets a short message saying what is allowed, such as "Image addresses must start with https:// or /."
  • Items that can't be edited. "This page is archived.", "This template is archived." or "This email was sent or scheduled, so it can't be edited." Select closes and the toolbar shows the reason.

Other messages you may see are Couldn't save that change. (try again), Couldn't open Select. Try again. and Couldn't load the latest version.

When someone saved first

Your changes are checked against the version you're looking at, like your other saves. If a teammate or the assistant saved a newer version first, the panel says Updated elsewhere, and your last change isn't saved. The preview loads the newer version quietly. Look at it, then make the change again if you still want it.

If the element you had selected is gone from the newer version, the panel closes and says This element was removed.

Published pages and sent emails

Select always edits the draft. If a web page is already published, your changes don't reach the live page until you publish again; the Publish button switches to Publish changes to remind you. See Web artifact.

An email that has been sent or scheduled can't be edited with Select, or in any other way. Ask the assistant to draft a new one. See Email.

Select and the pencil

The pencil and Select can't both be open. Opening one saves your work and closes the other. If you click Select while the pencil is open, what you typed is saved first. If you click the pencil while Select is on, any panel change still waiting is saved first. If the pencil can't save what you typed, it stays open and Select stays off, so nothing is lost.

Comments

Comments let you point at one element on the page or in the email and say what you want. Each comment is a small pin on the element it's about. You can send a comment to the assistant to act on, or keep it as a note for yourself and your teammates.

Use a comment when it's easier to point than to describe: "shorter headline here", "this button should say Book now". For how an element looks and where it points, Select is quicker, because you make the change yourself.

Where Comment is available

Comment is on the preview panel's toolbar, next to Select, for:

  • Web pages, on the Preview tab.
  • Email templates.
  • Email drafts, on the Template tab.

It isn't offered for text messages, blog posts or other kinds of artifact. Unlike Select, it's also there when the item can't be edited, where it takes notes only — see Sent emails and archived items.

Pin a comment

Click Comment in the toolbar. The button reads Close comment while Comment is on; click it again to turn Comment off. As in Select, the item is shown as it looks but clicking doesn't do what it normally would, and an email is shown in its Web view.

  1. Move the pointer over the item. A dashed outline shows the element a click will pin to, and a label above it says where that element sits on the page.
  2. Click to drop a pin. A box opens beside it.
  3. Write your comment. Press Enter to post it, or Shift+Enter to start a new line.

To change your mind, press Esc to close a comment that's still empty, or click somewhere else to move an empty comment to that element. A comment with text in it is kept.

A comment you've started typing is never lost. If you switch to Select, or open the editor with the pencil, your words are kept, and they're back in the box when you turn Comment on again.

Comment, Select and the pencil take turns: turning one on closes the others. Pins are drawn over the preview at desktop width, in Comment and in Select. They aren't shown in the plain view or while you're editing text with the pencil.

Send it to the assistant, or keep it as a note

Under the box, Send to the assistant is ticked when you're working inside a task, so the comment goes to the assistant as soon as you post it. Untick it to keep the comment as a note that only people can see. A note can be sent later: reply to it with Send to the assistant ticked.

Outside a task you can only leave notes — see Comments from the Library.

What the pins show

Each pin shows the initial of whoever wrote the comment. A small badge on it says where an assistant request has got to:

BadgeMeaning
ClockQueued. The comment is waiting its turn.
SpinnerWorking. The assistant is making the change.
Green checkDone. The assistant made the change.
Amber !Couldn't do. The assistant couldn't make the change; its reply says why.
Send again buttonNot completed. The request was stopped before it finished. Click Send again to retry it.
Clock and a Send from here buttonQueued in another task. The comment is waiting in the queue of a different task. Click Send from here to send it from the task you're in.

A note has no badge.

How the assistant works through comments

The assistant handles one comment at a time, each in its own turn in the task's chat. If you send several, the rest wait their turn.

The assistant changes only what the comment asks for, on that element, and leaves the rest of the page alone. When it's done, the preview refreshes on its own, and if Comment is on, the element flashes so you can see where it worked. Its reply appears in the comment's thread, starting Done — with what it changed, or Couldn't do — with the reason. A comment that only asks a question gets its answer in the thread, and nothing on the page changes.

If you press Stop while a comment is being worked on, that comment is marked not completed and the others wait. They don't start again on their own: they carry on once you send something yourself, or you can click Send again on the comment you stopped.

A comment waits in the queue of the task it was sent from. If you open the item from another task, a comment still waiting elsewhere shows Send from here: click it to move the comment to the task you're in, and it's sent from there. If you delete a task (or its campaign), the comments still waiting in it, or being worked on, are marked not completed, so you can click Send again from any other task.

Threads

Click a pin to open its thread: the comment, any replies, and the assistant's answer. In it you can:

  • Reply. Press Enter to post, Shift+Enter for a new line. A reply posted with Send to the assistant ticked goes to the assistant.
  • Resolve (the tick in the thread's header) when a comment is dealt with. A resolved comment leaves the Open list and its pin is hidden.
  • Reopen a resolved comment to bring it back.
  • Delete thread, from the ⋯ menu. It asks first. Deleting is permanent: the comment and all its replies are removed.

Comments are shared with your whole workspace. A teammate sees your new comments when they open or refresh the panel; there are no live updates while the panel is open.

The comments list

The comments button in the toolbar, with the number of open comments on it, opens the list of every comment on the item, and turns Comment on if it was off. On a narrow panel the list opens as a sheet over the preview.

  • Open and Resolved switch between the comments still to deal with and the finished ones. Choosing Resolved also puts the resolved comments' pins back on the preview.
  • Hide pins takes the pins off the preview so you can see the page clearly; the button then reads Show pins.
  • Click a comment in the list to scroll to its element. The element flashes and the comment's thread opens.

Detached comments

If the element a comment was pinned to no longer exists, the comment moves to Detached. This happens after the assistant redesigns the page, or after you go back to an earlier version without that element. A detached comment keeps its text and replies but has no pin.

Comments in the chat

When you send a comment to the assistant, it appears in the task's chat as a chip showing the comment. Click the chip to open the artifact in Comment mode, at that comment's pin.

Comments from the Library

On the Artifacts and Library pages you aren't inside the task that made the artifact, so comments there are notes. Instead of Send to the assistant, the box offers Open in session to send, which opens the artifact's own task so you can send the comment from there. It's greyed out when the artifact has no task.

Sent emails and archived items

An email that has been sent, scheduled or has failed or been skipped, and a web page or template that has been archived, take notes only. Send to the assistant isn't offered, because the assistant can't change them.

An email sent, or a page or template archived, before comments existed can't take comments at all. Comment stays off and the toolbar says why: This email was sent before comments existed., This page is archived. or This template is archived.

Comment on this

In Select, the property panel has a Comment on this button. It starts a comment on the element you've selected, so you don't need to switch modes and find it again. See Select and the property panel.

FAQ

Q: I didn't press anything, but the preview changed. Why? A: The assistant just finished a reply that changed this item, so the panel loaded the new version for you.

Q: Why was my save refused? A: Someone — a teammate or the assistant — saved a newer version after you opened the item. Reload to see it, then make your change again. Nothing of theirs was overwritten, and nothing of yours was saved over it.

Q: Why is Refresh greyed out? A: The text editor is open. Close it (your changes save automatically), then Refresh.

Q: What's the difference between Select and the pencil? A: The pencil edits the words on the page or in the email. Select changes how an element looks and where it points — its colors, size, spacing, border, image and link — and can move, copy or delete it. You can't open both at once.

Q: There's no Select button. Why? A: Select is offered for web pages, email templates and email drafts only, and only while the item can be edited. It's missing on an email that has been sent or scheduled and on an archived page or template. On a web page it sits on the Preview tab, and on an email draft on the Template tab.

Q: Why did a new version called "Added element ids" show up when I only turned Select on? A: The first time you use Select on an older item, the app gives its elements small hidden ids so it can tell them apart. It doesn't change how the item looks, and the toolbar's Undo skips over it. Items you open Select on afterwards already have ids, so this happens once.

Q: Does Select change what recipients see? A: No. The ids Select adds are invisible attributes; recipients see the same email.

Q: Why was my change refused? A: Some elements are protected because a change could break the page or the email: a form and its fields, the element that holds the page's app, a value the page's code sets, and an email's unsubscribe link. The panel says which. Ask the assistant in the chat and it can make the change safely. See When a change is refused.

Q: Why are some text settings greyed out in an email? A: The text inside that block sets its own color, size, weight or alignment, which wins over the block's, so a change in the panel wouldn't show. Ask the assistant in the chat to change it.

Q: Why does the panel say "Applies to all 3 items"? A: The element is one of several drawn from the same template in the page's code, such as the cards in a list. Anything you change in the panel changes every copy.

Q: The panel's Undo is greyed out. Why? A: There's nothing to take back yet, or the item changed in some other way since your last panel change — the assistant edited it, you pressed Refresh, or you used the toolbar's Undo, Redo or History. The panel's Undo only covers changes made in the panel. To go further back, use the toolbar's Undo or History — see Version history.

Q: What does "Updated elsewhere" mean? A: Someone — a teammate or the assistant — saved a newer version before your change reached the server. Your change wasn't saved, and the preview now shows the newer version. Make the change again if you still want it.

Q: I changed a page that's already published. Is it live? A: Not until you publish again. Select edits the draft, and the Publish button switches to Publish changes while the draft is ahead of the live page.

Q: There's no Comment button. Why? A: Comment is offered for web pages, email templates and email drafts only. On a web page it sits on the Preview tab, and on an email draft on the Template tab. If you click it and nothing opens, the toolbar says why. An email sent before comments existed can't take comments, and neither can a page or template that was archived before then.

Q: What's the difference between a note and a comment sent to the assistant? A: A note stays on the page for you and your teammates to read, and the assistant doesn't act on it. A comment sent to the assistant is a request: it changes the element the pin is on. Untick Send to the assistant to keep a note, and reply with the box ticked if you later want the assistant to act on it.

Q: Why is there no Send to the assistant box? A: You're outside a task, such as on the Library page, where comments are notes. Click Open in session to send to continue in the artifact's own task. The box is also missing on emails that have been sent or scheduled and on archived pages and templates, which take notes only.

Q: My comment shows a clock. Is it stuck? A: No. The assistant works on one comment at a time, so a queued comment waits for the ones before it. After you press Stop, the comment you stopped shows Send again, and the others wait until you send something yourself. If the comment is waiting in a different task, its pin shows Send from here: click it to send it from the task you're in. A comment whose task was deleted shows Send again, which works from any task.

Q: What does the amber ! on a pin mean? A: The assistant couldn't make that change. Open the pin to read why, in the reply that starts Couldn't do —. Reply with what you'd like instead, or ask in the chat.

Q: Did the assistant change anything else on the page? A: No. It changes only what the comment asks for, on the element the pin is on. If it went wrong, use Undo or History — see Version history.

Q: Where did my comment's pin go? A: Either the comment is resolved (choose Resolved in the comments list to see it), you chose Hide pins, or its element no longer exists and the comment has moved to Detached. Detached comments keep their text and replies but have no pin. Pins also aren't drawn in the plain view, while you're editing with the pencil, or in the Mobile preview: Comment and Select show the desktop width.

Q: Can my teammates see my comments? A: Yes. Comments are shared with your whole workspace. They see yours when they open or refresh the panel, and the panel doesn't update live while it's open.

Q: Can I get a deleted comment back? A: No. Delete thread is permanent and removes the comment and its replies. Use Resolve if you only want it out of the way; you can Reopen it later.

Q: I was typing a comment and switched to Select. Is it gone? A: No. A comment you've started is kept, and it's back in the box when you turn Comment on again. Only an empty comment is dropped when you leave Comment.