Ellie Help
Ellie Help Home What's new Getting started9 Work with Ellie4
Write and organise content7
Keep your docs up to date1 Publish and brand3 Walkthrough videos2 Changelog2 Measure and improve1 API reference1 Workspace and billing6 Connect AI tools1 Security and data3 Troubleshooting1
Powered by Ellie Docs
Write and organise content/Fix a blank, wrong or missing screenshot (retake or replace)

Fix a blank, wrong or missing screenshot (retake or replace)

Updated 19 Nov 2026

On this page

If a screenshot in your help centre is blank, shows a login page, shows the wrong screen or is missing, you can ask Ellie to retake it with guidance or replace it with your own image. You can also add a new screenshot block to an article. This is for anyone editing an article in a project help centre.

Before you start

Screenshots appear in two places in the article editor:

  • inline in the article as a screenshot block
  • in the right-hand Screenshots (captured/total) panel, which lists every screenshot Ellie planned for the article

Images added with a plain Image block do not appear in the Screenshots (captured/total) panel.

Step by step

  1. Go to Projects and open your project.
  2. Go to Content and open the article you want to edit.
  3. Use the right-hand Screenshots (captured/total) panel to review planned screenshots for the article.

Add a screenshot block

  1. In the article body, type /.
  2. Choose Screenshot.
  3. Add a description in Describe what this screenshot should show….
  4. Click away or press Enter to save the description.
  5. Click Upload to attach your image.

A hand-added screenshot block starts empty. Saving the article alone does not register that block for Ellie's capture runs, so upload an image if you want it to appear.

Replace a screenshot with your own image

  1. Open the article in Projects → your project → Content.
  2. Find the screenshot block you want to replace.
  3. Edit Describe what this screenshot should show… if needed.
  4. Click Replace.
  5. Choose a PNG, JPEG, WebP or GIF up to 10 MB.

Your replacement takes effect immediately, is marked captured and yours, and Ellie will not auto-replace or recapture it.

Uploaded screenshots cannot be retried. To change one later, upload a new image to replace it.

Retake a screenshot Ellie captured

  1. Open the article in Projects → your project → Content.
  2. Find the screenshot you want Ellie to capture again.
  3. If the screenshot is pinned, unpin it first.
  4. Click Recapture…. If the screenshot failed, click Retry… instead.
  5. In the guidance box, enter instructions if needed: Tell Ellie how to reach this screen — e.g. “Go to Settings → Team, invite someone, then open the invite link from the pending invites list.”
  6. Keep your guidance within 1,000 characters.
  7. Click Retry with guidance if you entered guidance, or Retry if you left the box empty.

Cancel closes the guidance box without submitting.

After you retry:

  • a captured screenshot changes to stale and shows Recapturing — this usually takes a few minutes.
  • a failed screenshot changes to pending
  • the panel re-checks every 15 seconds for up to 20 minutes

If you save guidance, it appears later as Your guidance: … and is pre-filled the next time you retry. If you clear the box and retry, the saved guidance is removed.

Pinned screenshots cannot be recaptured until you unpin them.

Keep a rejected capture anyway

  1. Open the article in Projects → your project → Content.
  2. Find the screenshot with a rejected capture preview.
  3. Review the image and the Verification: … note.
  4. Click Use anyway if the screenshot is correct.

This changes the screenshot to captured.

Good to know

Why can't I see a screenshot in the live help centre? Only screenshots with the status captured are shown to readers. pending, stale, and failed screenshots are hidden on the live help centre, and readers do not see Ellie's status labels.

What do the screenshot status chips mean? captured means Ellie has a usable image. pending means Ellie is waiting to capture it. stale means it is queued for a fresh capture. failed means the capture did not succeed. yours means you uploaded the image yourself. Hover a chip to read the verifier's note.

When is Use anyway available? Only when Ellie's checker rejected a real screenshot frame. It is not offered for near-blank frames, error pages, or the screen where Ellie gave up.

What should I do if a screenshot failed? Check the Verification: … note under the screenshot. Common causes include a screen that needed sign‑in when the project has no test account, an app that became unreachable during capture, or the app returning a 5xx server error while Ellie tried to seed example data. If the project has the Sample Data Map (test_data_map) enabled, empty or missing screens may be recorded as gaps and listed on the Sample Data Map card under “Screens waiting for data” with statuses, notes and links into the affected article or video; Ellie will attempt to add example data for those gaps and re‑capture them. If a 5xx occurred, Ellie opens a 'Product bug' suggestion for the failing endpoint and marks the journey as blocked by a product bug; the UI shows an app error badge on that journey and lists features excluded from seeding in Project Settings and in the Maintenance feed. Fix the underlying cause, then retry, or upload your own image instead.

My screenshot is blank or shows a login page. What do I do? Check the Verification: … note under the screenshot. A login page usually means the project has no working test account, so Ellie could not sign in. Follow Fix analysis problems and blank or wrong screenshots to re-run Provision account, then use Retry… or Recapture… here, or upload your own image.

A screenshot shows the wrong screen. How do I fix it? Click Recapture… (unpin it first if it is pinned) and, in the guidance box, tell Ellie how to reach the right screen, for example the page to open and what to click first. Then click Retry with guidance.

A feature is missing from my screenshot, but the page isn't a login page. What do I do? If your app needs environment variables to load that feature, add them under Project → Settings → Repositories, then retake the screenshot. See Set environment variables for your test copy.

A screenshot is missing in my live help centre. Why? Readers only see screenshots with the status captured. If yours is pending, stale or failed, retry it or replace it with your own image; once it is captured it appears on the live help centre.

Recent updates

All updates →
On this page