Skip to content
AM

Tenant settings

Use Portal > Settings at /settings for organization identity, appearance, business type, AI model preferences, and links to other management surfaces. Some panels are previews; this guide distinguishes persisted behavior from browser-only state.

Persisted organization settings

The Organization panel loads the active organization and saves through updateOrganizationSettings:

  • Organization display name.
  • PNG or SVG logo stored as a data URL.
  • Default timezone.
  • Default currency, until baseCurrencyLockedAt is set.
  • Business type/persona.

Changing an existing business type requires confirmation and resets onboarding state. Organization slug is derived for display and is not sent by this form.

Theme and light/dark/system mode are also persisted through updateOrganizationSettings and shared across the SPAs. The AI COO panel display choice is local component state only.

Members & Roles links to /team and /team/roles; it does not duplicate member-management forms.

The Billing & Plan cards currently contain fixed example values, and Open Billing Portal has no handler. Use the reviewed /billing page for current subscription data and Stripe access.

AI models and BYOK

The AI Models panel is connected to the model-negotiation API. Eligible organization administrators can:

  • View the effective model and the catalog returned for the active tenant.
  • Select or reset a model preference.
  • Add, replace, validate, and delete BYOK provider keys.
  • Review model usage and recent settings activity.

Supported BYOK providers in the current UI are Anthropic, OpenAI, Google, xAI, Moonshot, and Qwen. The selectable model list is dynamic backend data, filtered by eligibility and current configuration; there is no fixed per-tier model list in the Portal source. Managed-externally or ineligible organizations see read-only controls.

Preview-only panels

The following controls currently modify React state or show a success toast without calling a persistence API:

  • Portal module toggles.
  • Notification address, switches, and test buttons.
  • Authentication controls, including 2FA, allowed domains, session timeout, and the displayed SSO provider options.
  • Portal API key rows, creation, and revocation.
  • The Billing & Plan summary.

These controls reset on reload and do not configure ZITADEL, issue credentials, send test notifications, or change organization authorization. Do not use the displayed SSO provider list as a statement of production identity-provider support. Use Studio’s API-key surface for persisted storefront credentials.

Agentic Commerce

This panel is informational and links to Studio’s site list. Site-scoped UCP, ACP, and developer-key controls belong to the Studio workflows.