Skip to Content
DeploymentEnvironment Variables

Environment Variables

Required

VariableDescription
VARD_API_KEYYour workspace API key. Found in Developer → API Keys.

Optional

VariableDescription
VARD_SITE_IDSite UUID used by analytics and commerce. Found in Developer → API Keys.
VARD_API_BASEOverride the Vard API base URL. Defaults to https://vard.app. Only needed for self-hosted or local dev setups.
VARD_SCHEMA_VERSIONSchema version tag. Use for staging/branch environments. Defaults to "default". See Schema Versioning.
VARD_DEBUGSet to "true" to enable verbose SDK logging. Useful for debugging content fetching issues.

Setting variables in different environments

Local development

.env.local
VARD_API_KEY=vard_live_xxxxxxxxxxxx

Vercel

Add environment variables in your project settings under Settings → Environment Variables. Make sure VARD_API_KEY is available for all environments (Production, Preview, Development).

Vard never writes these values to Vercel. Add VARD_SITE_ID yourself in environments that use analytics or commerce.

Other hosts

Consult your hosting provider’s documentation for setting environment variables. The variable must be available at build time (not just runtime) if you’re using static export or ISR.

Security

VARD_API_KEY grants read access to your workspace’s published content. It is safe to include in server-side environment variables but should never be exposed to the browser.

Do not commit .env.local or any file containing your API key to version control.

Last updated on
Vard SDK Documentation