---
title: "Images and screenshots"
url: "/help/buuk/images-and-screenshots"
updated: "2026-11-13T13:32:02.572Z"
---
# Images and screenshots

Help articles are easier to follow when readers can see the screen you are describing. You can 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**, then pick a PNG, JPG, or WebP. Large files are compressed on upload, so pages stay fast.
2. Use a descriptive file name — it doubles as the alt text and caption readers see.
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 a web URL from 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.

## If your product is a mobile app

Capture runs in a browser. It cannot open iOS or Android. Point Automations → Product screenshots at a page Buuk can load — your web app, marketing site, or store listing — if you want those captured automatically.

For screens inside the native app, screenshot a simulator or device, or export from App Store Connect or Play Console. Then press `/` in the editor and choose **Image** to upload the file.

> [!NOTE]
> Leave the automation off, or leave App URL empty, unless you also have a web app. The product website from Settings → General is still used for research.

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

2. **Turn on Product screenshots**
   Open **Automations** and add **Product screenshots**. Set **App URL** to a page Buuk can open in a browser — for example `https://app.yourproduct.com`.
   
   If the screens you need sit behind a login, write numbered steps for a dedicated demo account. Those steps are stored encrypted. Skip sign-in for pages that are already public. Pause the automation to stop captures without deleting the URL.

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.