Source: https://docs.pageloop.ai/guides/image-editor

# Annotate and edit screenshots

# Annotate and edit screenshots

Use the image editor to point out a control, label part of a screenshot, or crop away distractions before publishing an article. You can edit screenshots captured through Pageloop and external images already in your article.

## Open the image editor

Start with an article draft or an article with pending updates that contains the image you want to edit.

1. Open the article in the article editor. If you are reviewing an **Inbox** item, select the article and open the **Article** tab.
2. Hover over the screenshot to reveal its toolbar in the top-right corner.
3. Select **Edit Image**, the pencil icon. Wait for the image to load in the **Edit Image** dialog.

> [!NOTE]
>
> These steps apply to the article editor's **Edit Image** control. The native Knowledge Base page editor's image alignment and **ALT** controls do not open this dialog.

## Add annotations

The editor opens with **Annotate** selected.

1. Choose an annotation tool from the toolbar.
2. Draw on the screenshot. For a text label, choose **Text**, place the label, and enter the text.
3. Select an annotation to adjust its position or style. Use the color control to choose a color and the line-width control to adjust shape or line thickness. For text, adjust the font size as needed.
4. Repeat for the other elements you need to explain. Keep annotations clear of the labels and controls readers need to see.

| Tool          | Use it to                                      |
| ------------- | ---------------------------------------------- |
| **Rectangle** | Outline a button, field, or section.           |
| **Ellipse**   | Circle an element.                             |
| **Arrow**     | Point to the next control or area of interest. |
| **Text**      | Add a short label.                             |
| **Line**      | Draw a straight line.                          |
| **Path**      | Draw a freeform line.                          |
| **Eraser**    | Erase annotations.                             |

If your workspace has an annotation palette, its colors appear in the color control. See [Set annotation brand colors](#set-annotation-brand-colors) for how the palette and defaults work.

## Crop and adjust the screenshot

1. Select **Crop** from the left-side menu.
2. Drag the corner and edge handles to frame the part of the screenshot you want to keep.
3. Check that the crop still includes enough context to identify the screen and the annotated control.

For other adjustments, select **Filter** and choose a preset to preview its effect. Use **Redact** to mark areas you want to obscure. Inspect the edited result for personal or sensitive information before saving or publishing; annotations intended to highlight a control are not a substitute for redaction.

## Save the result to the draft

1. Review the crop, annotations, and any other adjustments in the image editor.
2. Select **Save Changes** in the top-right corner. Wait for the upload to finish and the dialog to close.
3. Check the replacement image in the article, alongside the instructions it illustrates. Wait for the article's changes to finish saving before leaving the draft.

Saving the image updates the draft; it does not publish the article. Continue with your normal review and publishing process when the draft is ready. If saving fails, keep the editor open and try **Save Changes** again.

To leave without applying the image edits, select **Cancel** instead.

## Set annotation brand colors

> [!NOTE]
>
> Only workspace **Admins** can configure the annotation palette. Editors and Contributors cannot change the palette. The saved palette supplies colors to the image editor for the workspace, not just the Admin who configured it.

1. Open **Account** in the top bar and select **Settings**.
2. Under **Writing**, select **Style** and scroll to **Brand colours**.
3. Select **Add brand color**. Enter a **Label** and choose a color using the swatch, or enter a six-digit hex value such as `#3960DD`.
4. Add the other colors you need. You can configure up to 20 colors; each label must contain no more than 40 characters.
5. Drag a row's reorder handle to arrange the palette. Put the color you want as the default first.
6. Select **Save changes** and wait for the save confirmation.

![Brand colours in Style settings, showing an unsaved palette row with a color swatch, hex value, Label field, and reorder handle](/images/uploads/screenshot-1cb01332.png)

### How the palette applies

The image editor offers the configured colors in their saved order, followed by **Transparent**, **Black**, and **White**. Configuring brand colors replaces the built-in preset palette.

The first brand color supplies the default outline or line color for shapes, arrows, lines, and paths, and the default text color for labels. Shape and text backgrounds start transparent. You can choose a different color while editing an annotation.

Changing the palette does not recolor annotations already saved in an image. Use the updated palette when creating annotations in a subsequent editing session. If no brand colors are configured, the editor uses its built-in palette and blue as the default annotation color.

For help finding the article review area and workspace settings, see [The Pageloop sidebar](/guides/pageloop-sidebar).
