Manage environment variables

Environment variables store credentials, API keys, and configuration values that Promptless uses when interacting with your systems. The most common use case is storing login credentials for Promptless Capture to capture product screenshots.

Add environment variables

1. Open Settings. Navigate to the Settings page in your Promptless dashboard and select Agent Env Vars.

2. Enter a key and value. The Add Variable form sits on the page below your existing variables. Type a Key Name and a Value. Use clear, descriptive names that indicate the variable’s purpose.

3. Mark sensitive values as secret. For passwords, API keys, and other sensitive values, turn on the Secret toggle, which masks the Value field as you type.

4. Submit the variable. Click Add Variable. The new variable appears in the variables table above the form.

Agent Env Vars settings page

Note

Variable names are flexible. Use whatever naming convention fits your organization—TEST_ACCOUNT_USER, QA_USERNAME, STAGING_LOGIN_EMAIL, or any descriptive name that makes sense to your team.

Keep secrets secure

Caution

Use dedicated test or service accounts for credentials rather than personal accounts. This ensures screenshots don’t contain personal data and provides consistent results.

Adding a secret environment variable

Variables marked as secrets are encrypted and hidden in the dashboard after saving. Use this option for passwords, API keys, and other sensitive values.

Example: Screenshot capture credentials

For Promptless Capture, add these variables to let Promptless log into your application:

Variable	Example Value	Secret?
TEST_ACCOUNT_URL	https://app.yourcompany.com/login	No
TEST_ACCOUNT_USER	qa-screenshots@yourcompany.com	No
TEST_ACCOUNT_PASS	(your password)	Yes

Tip

Create a test account with access to all the features you want documented. If certain features require specific permissions or plan tiers, ensure your test account has the appropriate access level.

Update and delete variables

To update an existing variable, locate it in the variables table, click the Update button in the Actions column, edit the value, and click Save. For secret variables, re-enter the entire value — Promptless doesn’t display the original.

To delete a variable, click the Delete button in its row of the Actions column. Deleted variables are immediately removed and are no longer available to the Promptless agent.

Need help? Contact us at help@gopromptless.ai.