> ## Documentation Index
> Fetch the complete documentation index at: https://docs.puntego.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration

> Tune appearance, consent, voice, rollout flags, and observability for Puntego from your dashboard.

Puntego reads its settings from the workspace configuration returned by `/boot`, so you change the guide's behavior from the dashboard without editing your site or redeploying.

## Appearance

Set branding, copy tone, and install metadata from **Dashboard → Customize**.

Keep the public install snippet stable. Change runtime behavior through workspace settings, not by rewriting the script tag on every deploy — that keeps your install reviewable and lets non-engineers adjust the guide. See [Install](/install) for the snippet and its data attributes.

## Consent

Choose how visitors are told about the guide from **Dashboard → Privacy**. A same-request legal acknowledgment confirms you have reviewed the notice your visitors will see.

| Mode              | Behavior                                                  | Same-request legal acknowledgment |
| ----------------- | --------------------------------------------------------- | --------------------------------- |
| `always_opt_in`   | Visitors opt in before the guide activates.               | Not required                      |
| `always_opt_out`  | Default launch mode: a light notice plus a clear opt-out. | Required                          |
| `disclosure_only` | A disclosure notice, with no opt-out gate.                | Required                          |

<Note>
  Global Privacy Control opt-out is always honored, independent of region. Consent follows your configured workspace mode — a missing visitor country does not force a stricter mode.
</Note>

For what is and is not redacted before model and guardrail calls, see [Privacy and PII](/privacy-and-pii).

## Voice

Voice is optional per workspace and is enabled from your settings. When voice provider credentials are absent, Puntego falls back to an internal mock voice.

The bubble experience is the cursor launcher's fallback: on touch-primary or narrow (under 768px) screens, the cursor mode switches to the bubble. The default floating launcher keeps its floating button on those screens.

## Feature flags

These environment flags govern rollout at the worker:

| Flag                    | Effect                                                                                     |
| ----------------------- | ------------------------------------------------------------------------------------------ |
| `GP_KILLSWITCH=true`    | `/boot` returns `503` and the boot script silently no-ops, so nothing renders on the page. |
| `GP_PRODUCTION_TENANTS` | When configured, gates which workspaces are allowed to boot and chat in production.        |

See [Boot errors](/errors) for the full set of `/boot` responses.

## Observability

Puntego scrubs personally identifiable information from error reports before they leave the app, so you can monitor application errors without exposing visitor data. Roughly 10% of route traces are sampled, and raw request bodies, visitor data, and prompt text are not captured by default.

Model traces stay isolated per workspace and redacted at the worker; the dashboard only renders the redacted summaries the worker surfaces. Operator traces never become a second copy of raw visitor data.

<Note>
  Operator note: error reporting is wired through `SENTRY_DSN_DASHBOARD` (server and edge) and `NEXT_PUBLIC_SENTRY_DSN_DASHBOARD` (browser). To turn it off, blank both DSNs and redeploy.
</Note>

## Next steps

<CardGroup cols={2}>
  <Card title="Install attributes" icon="sliders" href="/install">
    Set launcher mode, routes, voice, and wake behavior on the script tag.
  </Card>

  <Card title="Privacy and PII" icon="shield-check" href="/privacy-and-pii">
    See consent enforcement and exactly what is redacted.
  </Card>

  <Card title="Domains" icon="globe" href="/domains">
    Allow the origins where the guide may mount.
  </Card>

  <Card title="Security" icon="lock" href="/security">
    Review the trust model behind boot, chat, and traces.
  </Card>
</CardGroup>