Project

Project options decide how many creatives a user can hold in one workspace, and whether the ads they make are saved back to your Voxify dashboard. Both default to off — the simplest embed is a single ad that lives only in the browser.

Allow multi-creatives

What it is — lets a user keep several ad variations side by side in the same project, switching between them in a creatives list.

Why / when — turn it on for A/B testing, or when one brief needs to be tailored to multiple audience segments or markets. Leave it off when each session is about a single ad and you want the leanest possible UI — for example a one-shot generator. When off, applying a recommendation replaces the current script; when on, it can be added as a new creative.

How — set project.allowMultiCreatives to true (Builder: Project → Allow multi-creatives). This also unlocks the creatives-panel layout options — see Layout.

project: {
  allowMultiCreatives: true,
}

Enable persistence

What it is — automatically saves every ad created in your embed to the Voxify platform.

Why / when — turn it on when you want your team to be able to review, tweak, or continue your end-users' work. Persisted projects show up under Projects → Audio Creatives in your own Voxify dashboard. Leave it off for ephemeral flows — when disabled, projects live only in the browser session, and it's on your backend to persist anything you need to keep (you can capture results via the editor handle).

How — set project.persistence to true (Builder: Project → Enable persistence). With persistence on, the editor handle's flush() forces a save immediately; with it off, flush() is a no-op.

project: {
  allowMultiCreatives: true,
  persistence: true,
  // projectId: 'your-stable-id',   // optional: pin a project across reloads
}

You can optionally pass project.projectId to reuse a specific project across sessions; omit it and each session gets a fresh project id (also exposed on the resolved editor handle).