Skip to content

Variables

Variable Value
${name} Test vars, project vars, data row values, flow params, set:
${env.NAME} An environment variable; ${env.NAME:-default} with a default
${secret.NAME} From the environment, .env or .sisyphus/secrets.env; masked as ••• in results
${project_dir} The folder holding sisyphus.yaml, absolute
${random} 10 digits, different on every use, also across workers
${timestamp} The current time
${index} The pass number inside repeat
${worker} The parallel worker running the test, from 0
${os} The OS the test runs on: macos, windows or linux. For steps that differ: if: { equals: ["${os}", macos] }
${output} · ${exit_code} From the last run:
${text(<sel>)} An element’s text
${value(<sel>)} A field’s value
${count(<sel>)} How many elements match
${url()} · ${title()} The page URL and title
${clipboard()} The clipboard (trailing newlines dropped; macOS and Windows)

Precedence, lowest to highest: project vars, test vars, data row, --var.

Variables may use other variables, in any order, and so may defaults: ${env.URL:-${base}/api}. $${ is a literal ${. An undefined variable fails the step with VARIABLE_UNDEFINED.

Made by Bussin Bytes© 2026 Bussin Bytes Ltd · sisyphus.bussinbytes.io