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
Walkthrough videos/Set environment variables for your test copy

Set environment variables for your test copy

Updated 30 Oct 2026

On this page

Use project environment variables to give Ellie's test copy of your app the settings it needs for screenshots and walkthrough videos. You can also turn on features in the test copy that are off until the right variable is set.

Step by step

  1. Open Project → Settings → Advanced.
    The Environment variables card in Project Settings
  2. In Environment variables, add a row with Add variable if you need a new one.
  3. Enter the variable name in the field with the NAME placeholder, then enter its value in the value field.
    An empty environment variable row ready for a name and value
  4. Repeat for any other variables you need, then click Save.
  5. To change an existing variable, edit its row and click Save.
  6. For saved values that are hidden, the value field shows Hidden. Leave blank to keep it. Leave it blank to keep the stored value, type a new value to replace it, or delete the row if you want to remove that variable entirely.
  7. To remove a variable, click the bin icon on that row, then click Save.
  8. If you want to undo unsaved edits before saving, click Discard.

Good to know

  • These variables are only passed to Ellie's test copy of your app. They never reach your live app, and projects that take screenshots from your live app don't use them.
  • Variable names can use letters, digits, and underscores, but cannot start with a digit. Duplicate names are not allowed. If there is a problem, you'll see an error such as "1-BAD" isn't a valid name. Use letters, digits and underscores, not starting with a digit. or MY_VAR is listed twice. You must fix the problem before you can save.
  • You can save up to 100 variables. Each value is text and can be up to 8,192 characters.
  • After saving, you'll see Saved. The next screenshot run or video will use these. Changes apply to the next screenshot run or video only; existing screenshots and videos are not updated automatically.
  • If no repository is connected yet, there is no test copy to pass these to. The variables will take effect once you connect GitHub. For that setup, see Connect GitHub and choose your repositories.
If a screenshot run or walkthrough video cannot reach a page or misses a feature, the test copy often needs an environment variable for that part of your app.
If your project uses an Ellie sandbox copy, Ellie stores the test login it creates in this list as E2E_TEST_EMAIL and E2E_TEST_PASSWORD, so you will see them here (the password value is hidden). Ellie uses them to sign in to the test copy. Editing or deleting them can break that sign-in, so leave them as they are.

Troubleshooting

Why does a page in my screenshot run or video return 404 or miss a feature? This usually means the test copy needs an environment variable for that feature. Add it in Project → Settings → Advanced → Environment variables, click Save, and retry the screenshot run or video.

Recent updates

All updates →
On this page