Capture Screenshots

Annotate and edit screenshots

Add annotations, crop and edit screenshots, save them to a draft, and configure annotation brand colors.

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.

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.
ToolUse it to
RectangleOutline a button, field, or section.
EllipseCircle an element.
ArrowPoint to the next control or area of interest.
TextAdd a short label.
LineDraw a straight line.
PathDraw a freeform line.
EraserErase annotations.

If your workspace has an annotation palette, its colors appear in the color control. See 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

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.

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.