Instance Configuration
These settings are configured via environment variables on your Preface instance. They control plan-level limits and branding behaviour — useful for enforcing tier restrictions and white-labelling.
Plan limits
Published demos (MAX_PUBLISHED_DEMOS)
Controls the maximum number of demos that can be in the Published state at once, per workspace.
MAX_PUBLISHED_DEMOS=3
| Value | Behaviour |
|---|---|
| Integer | Workspace can have at most this many published demos simultaneously |
| (unset) | No limit |
When the limit is reached, the Publish button remains visible but clicking it shows a friendly message: "You've reached the maximum of N published demos. To publish more, please upgrade your plan."
The same check is enforced server-side, so the limit cannot be bypassed via the API.
To publish a new demo when at the limit, unpublish an existing one first.
Leads per month (MAX_LEADS_MONTH)
Controls the maximum number of leads that are visible per calendar month, counted across all demos in a workspace.
MAX_LEADS_MONTH=50
| Value | Behaviour |
|---|---|
| Integer | Only the first N leads per month (by submission time) are visible in the UI and included in CSV exports |
| (unset) | No limit — all leads are visible |
All leads are always stored in the database regardless of this limit. The cap only affects visibility in the admin UI and CSV exports. This makes it safe to use as an upsell prompt — no data is lost.
When one or more months contain more leads than the limit, a notice is shown on the Leads page:
Your account is limited to N leads per month. We still collect all leads. Currently, there are X leads across your account that cannot be seen or downloaded. Upgrade to get access.
The monthly window resets at the start of each calendar month (UTC). Leads are included in chronological order — the oldest submissions are always visible first.
Branding
Remove "Powered by Preface" badge (REMOVE_BADGE)
Controls whether the Powered by Preface badge is displayed in the demo player.
REMOVE_BADGE=false
| Value | Behaviour |
|---|---|
false (default) | Badge is shown in the player |
true | Badge is hidden |
Set REMOVE_BADGE=true to white-label the player for plans that include badge removal.