---
title: Image editor
slug: agent-platform/docs/image-editor
docTags: 
createdAt: 2026-07-20T15:44:51.000Z
---

Use the image editor in Agent Platform to refine a generated image without recreating it. Select an element, draw over an area, or outline a region with a shape to edit the image. Create variants of the finished image to use across multiple channels.

## Open the image editor

To open the image editor, use one of the following methods in [Mark chat](docId\:dtNBEttEGVvkhNkwNypLM):

- Upload a starting image and enter the following prompt: *Create this image as is.*
- Prompt Mark to generate an image. For example, *Create an image for Opticon 2026*.

Click **Edit** on the generated image to display the editor.

![Screenshot of a generated image in Mark chat where Edit opens the image editor](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/x9l4QhI3FSxG3JMHjYlfq_use-opal-generate-image0.png)

## Image editor layout

The image editor displays the image and Mark chat side by side. The toolbar holds the three editing modes: **Select**, **Draw**, and **Shape**. It also contains a drop-down list to change the aspect ratio of the image. Use **Variants** to create variants of the image for multiple channels.

![Screenshot of the image editor where the toolbar lists the Select, Draw, and Shape modes and the aspect ratio drop-down list](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/PaBeVTuajitNIVkx0xKLB_use-opal-image-editor-layout0.png)

The image editor also opens at a default zoom level. Click **Zoom** to set a custom zoom level or select a preset.

![Screenshot of the image editor where the Zoom menu lists the zoom presets](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/wscVW6kPxBEoRXAcLXBBn_use-opal-image-editor-zoom0.png)

## Edit an image

Edit your image using the three editing modes.

### Select individual elements

**Select** mode detects the separate parts of an image, such as text, shapes, and objects. Change one part without affecting the rest.

1. Click **Select**.
2. Click the element you want to edit.

![Screenshot of the image editor where the headline text is selected for editing](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/0LBM9SLWqOlE64oZikmkW_use-opal-image-select-mode0.png)

Mark displays the edit element options.

![Screenshot of the image editor where the headline text edit box offers Remove, Add to Queue, and Run Now](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/CGEMHGkyhxRt0oXwIil-k_use-opal-image-edit-element-options0.png)

Depending on how you want to edit the element, see the following options:

**Remove element** – Click **Remove**. Mark queues the element removal. See [Queue and run edits](docId\:W8pZzvN4HlbsgeW5762it).

**Edit the element** – The edit box depends on the element type:

- **Text element** – The edit box displays the current text in the text field.
  1. Replace the text with the text you want.

     ![Screenshot of the image editor where the headline text placeholder is replaced with Opticon](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/YpyNzsobtkaYPcgwjNNjF_use-opal-image-change-headline-text0.png)
  2. Click **Run**.
  3. Select **Run Now** or **Add to Queue**.
- **Other element** – The edit box displays a text field for your change instructions.
  1. Describe the change you want Mark to make. Optionally, drag an image from your computer into the text field, or paste a copied image.

     ![Screenshot of the image editor where the left photo placeholder is selected and the replacement options display](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/j9OFnHFytXQVQH4GTuJAK_use-opal-image-photo-edit0.png)
  2. Click **Run**.
  3. Select **Run Now** or **Add to Queue**.

### Draw over an area

Use **Draw** mode to paint over the exact area you want to change. This mode gives finer control than **Select** mode. Use it when a change does not match a single detected element. Use it to target only part of an element.

1. Click **Draw**.
2. (Optional) Drag the **Brush size** slider to set the brush width.

   ![Screenshot of the Edit brush area box where a text field accepts change instructions for the painted area](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/gA-8KUuS09vqdgK2VKtv-_use-opal-image-brush0.png)
3. Paint over the area you want to change.
4. In **Edit brush area**, describe the change you want Mark to make. Optionally, drag an image from your computer into the text field, or paste a copied image.

   ![Screenshot of the Edit brush area box where a text field accepts change instructions for the painted area](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/0icRmEzVhdvEqo2Za8Q0s_use-opal-edit-brush-area-image0.png)
5. Click **Run**, then select **Run Now** or **Add to Queue**.

### Outline an area with a shape

**Shape** mode lets you select a specific area of the image.

1. Click **Shape**.

   ![Screenshot of the image editor toolbar where Shape mode is selected](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/K6XCn3q9IQapiCfVNuaBT_use-opal-shape0.png)
2. Click and drag to create a rectangle.
3. In **Edit brush area**, describe the change you want Mark to make. Optionally, drag an image from your computer into the text field, or paste a copied image.

   ![Screenshot of the Edit brush area box where a rectangle is drawn on the image](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/IqxFSiYkBLI6eteAmviHH_use-opal-edit-shape0.png)
4. Click **Run**, then select **Run Now** or **Add to Queue**.

### Refine a painted area

In **Draw** and **Shape** modes, refine the painted area before you run the edit:

- To clear the painted area, click **Clear**.
- To refine your selection, click **Eraser**, then click and drag over the area you want to erase.

## Queue and run edits

Run an edit immediately, or add it to a queue to run several edits together. Each editing mode has its own queue, and you cannot mix the modes in a single run.

When you finish an edit, click **Run** and select an option:

- **Run Now** – Applies the edit immediately and creates a version.
- **Add to Queue** – Holds the edit so you can add more edits of the same mode before you run them.

![Screenshot of the Run menu where Run Now and Add to Queue are the options](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/sc7owJwiXZSa9z6chXz_S_use-opal-image-add-to-queue0.png)

To run queued edits, follow these steps:

1. Add one or more edits of the same mode to the queue.
2. Click **Run**, then select **Run Now** to run the queue.

![Screenshot of a queued edit where Run Now runs the edit](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/4efB0yKVid8QcWKz5WVSj_use-opal-image-run-queue0.png)

If you switch editing modes while edits are pending, Mark prompts you to run or clear them first.

### How Mark applies queued edits

Mark combines the queued edits into a single instruction and applies them at the same time. Mark then creates a version with the result.

When the queue holds more than one edit, the order sets how Mark writes the instruction. The order affects the results because each edit reads as part of a sequence. For example, you queue the following changes:

- *Change the background to a night sky.*
- *Add stars in the sky.*

The current order makes sense. The reverse order does not, as the night sky would hide the stars.

### Manage queue

Manage the queue in **Queued Image Edits** in Mark chat:

- Drag a queued edit to change its position in the instruction.

![Screenshot of Queued Image Edits in Mark chat where queued edits can be reordered](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/SJ-5t7gk3Ak9OQcljrSqT_use-opal-image-move-queued-item0.png)

- Click **Delete** to remove a queued edit.

![Screenshot of Queued Image Edits in Mark chat where Delete removes a queued edit](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/xsePT4CI8cooqjYyOc64U_use-opal-image-delete-queued-item0.png)

## Change the aspect ratio

Change the aspect ratio to resize the image for a different placement. For example, use 1:1 for a social post or 16:9 for a banner. Aspect ratio changes apply immediately. Mark does not add them to the queue.

1. Click the aspect ratio drop-down list.

   ![Screenshot of the aspect ratio drop-down list where a filter field narrows the list](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/TA5zOVo0Icuzk9wOUkZQc_use-opal-image-change-aspect-ratio0.png)
2. (Optional) Enter a ratio in the filter field to narrow the list.
3. Select an aspect ratio.

Mark resizes the image and creates a version with the result.

## Create variants of an image

Create variants of your images for use across multiple channels. A variant is your image regenerated at one aspect ratio. Mark generates each variant from your current image, so you do not have to resize the image for each channel. Changing the aspect ratio resizes the image and creates a version. Variants display alongside your original image.

Open an image in the image editor and wait for Mark to finish any running edit. **Variants** is unavailable while Mark processes an edit.

To create variants, follow these steps:

1. Click **Variants**.
2. Do one of the following:
   - Select a channel pack.
   - Expand **Select sizes**, then select the aspect ratios you want.
3. Click **Create**.

The number next to **Variants** displays how many aspect ratios you selected.

![Screenshot of the Variants panel where the Social basics, Web and display, and Paid ads channel packs display](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/uxrDgbYLbFVFEI_IlOm9M_variants-channel-pack-options.png)

Mark creates a variant for each selected aspect ratio and displays them side by side with your original image.

### Channel packs

A channel pack is a set of aspect ratios for a specific use. Select a pack to select all of its aspect ratios at once. Select the pack again to clear the selection.

| Channel pack      | Description                          | Aspect ratios       |
| ----------------- | ------------------------------------ | ------------------- |
| **Social basics** | Square, portrait, and story formats  | 1:1, 4:5, 9:16      |
| **Web & display** | Landscape, banner, and display sizes | 16:9, 5:4, 4:1      |
| **Paid ads**      | Multi-format ads for paid channels   | 1:1, 4:5, 16:9, 4:1 |

### Select sizes

To choose individual aspect ratios, expand **Select sizes** and select the ones you want. If you change the selected aspect ratios, Mark clears the pack selection and keeps your chosen aspect ratios.

![Screenshot of the Variants panel where Select sizes lists aspect ratios by category and three are selected](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/FPEatc0GNfxHvCYjjyAan_variants-select-sizes.png)

| Category               | Aspect ratio | Common use                                      |
| ---------------------- | ------------ | ----------------------------------------------- |
| Social feed            | 1:1          | Instagram, Facebook, LinkedIn, Twitter          |
| Social feed            | 4:5          | Instagram, Facebook                             |
| Social feed            | 3:2          | Facebook, LinkedIn, Twitter                     |
| Social feed            | 2:3          | Pinterest                                       |
| Stories and short-form | 9:16         | Instagram Stories, TikTok, Snap, YouTube Shorts |
| Stories and short-form | 3:4          | Snap                                            |
| Web and digital        | 16:9         | YouTube, web hero, blog header                  |
| Web and digital        | 5:4          | Blog, display                                   |
| Web and digital        | 4:1          | Leaderboard ad, web banner                      |
| Web and digital        | 21:9         | Cinematic web hero                              |
| Wide and banner        | 8:1          | Billboard, display ad                           |
| Print and other        | 4:3          | Print standard                                  |
| Print and other        | 1:4          | Signage                                         |
| Print and other        | 1:8          | Tall signage                                    |

### Review and manage variants

Mark displays your original image and each variant labeled with its aspect ratio.

![Screenshot of the variant results where the original image and each variant display with their aspect ratios](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/7L4n8E2aAA2m2TURiay_I_channel-variants-results.png)

- Click **Edit** to open a variant in the image editor and continue editing it.
- Click **Download** to save a variant on your computer.
- Click **Remove** to take a variant out of the results. The original image does not have this option.
- Click **Download all** to save every variant on your computer. Mark does not include the original image.

## Manage versions

Every run creates a version that displays as a card in Mark chat. Use versions to compare results and revert to an earlier image when an edit does not look correct.

- Each card displays a preview of the image.
- Click **Edit** to open that version in the image editor and continue editing from that point.
- Click **Download** to save a version on your computer.

![Screenshot of version cards in Mark chat where Edit and Download are the options](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/JxUhtTu8Rsp6jkJH-DH_u_manage-versions-1.png)

Select different versions in the image editor from the drop-down list.

1. Click the version drop-down list.

   ![Screenshot of the version drop-down list where a filter field narrows the versions](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/XowMH-Jhu8Opi-NCWEAK0_manage-versions-2.png)
2. (Optional) Enter a version number or an edit to filter the list.
3. Click a version to open it in the editor.

:::hint{type="info"}
**Note**

If you use Opti ID, administrators can turn off generative AI in the Opti ID Admin Center. See [Turn generative AI off across Optimizely applications](docId\:X5U0kKD2azV5cIdNqwGNj).
:::