---
title: "Images and screenshots"
url: "/help/demo/images-and-screenshots"
updated: "2026-09-11T02:26:23.065Z"
---
# Images and screenshots

Help articles are easier to follow when readers can see the screen you are describing. You can paste or upload images in the editor, or let Buuk capture pages from your product when it drafts an article. Captures always land in a **draft** — they never publish on their own.

## Add an image yourself

1. Open the article editor. Press `/` and choose **Image**, or drag a PNG, JPG, or WebP onto the page.
2. Write alt text that describes the screen, not “screenshot”.
3. Publish when the article is ready. Unpublished images stay out of the help center and the widget.

## Automated screenshots

When Ask Buuk drafts an article, or you accept a suggested update, Buuk can open your product and insert up to three screenshots under matching headings. This is best-effort: a missed capture still leaves you with the draft to edit.

1. **Set the product website**
   During onboarding, or later in **Customise**, set your product website. Buuk uses that domain for research, and as the fallback URL for public-page captures.

2. **Set the app URL and optional login**
   Open **Settings → General**. Under **Product screenshots**, set **App URL** to the logged-in app if it differs from the marketing site — for example `https://app.yourproduct.com`.
   
   If the screens you need sit behind a login, add a dedicated viewer account (email and password). The password is stored encrypted and is never shown again. Skip login for pages that are already public.

3. **Draft with AI**
   In the dashboard, open [Ask Buuk](./ask-buuk) (⌘J) and ask it to draft an article — for example “Draft an article about resetting a password.” You can also accept a suggested update from [Suggestions](./suggested-updates).

4. **Review the draft, then publish**
   Open the draft. Screenshots appear under the headings they illustrate. Replace, crop notes, or delete anything that is wrong. Publish only when the page is ready.

> [!TIP]
> Prefer a dedicated screenshot user with a viewer role, not an admin. Simple email-and-password login works; SSO, MFA, or unusual login pages often will not. If a capture misses, upload the image yourself.

> [!WARNING]
> Automated screenshots never publish themselves. Treat them as a starting point, the same as AI copy.