Skip to content
FlagSwiftDocs

Settings

Your organization, its server settings, and links to the pages that configure your workspace.

What this page is for#

Settings begins with the organization panel and then groups links to the pages that configure the workspace, such as projects, environments, segments, alert rules, members, API keys and audit logs. Below that are export and import, and a deactivate control for the owner.

In the console it lives at /settings. Everyone signed in can open it.

What you can do#

  • Rename the organization

    Edit the organization name. Keys, links and SDKs are not affected.

  • Find a setting

    Type a word like keys, members or alerts to filter the links.

  • Jump to a configuration page

    Links are grouped under Workspace and Access and security, and only show for pages you may open.

  • Read server settings

    People who can rename the organization see a collapsed System card. Its badge reads Looks good or the number of things to check. Open it for any notices (for example a development build, rate limiting off, or the scheduler off), a live check of /health/ready with a button to check again, and the settings in three groups: Runtime and data (runtime, database, background scheduler), Protection and governance (rate limiting, self-approval of releases) and Observability (metrics collection, Prometheus endpoint).

  • Copy a variable name

    Each setting names the environment variable behind it. Click the name to copy it.

  • Export and import configuration

    Download the organization as JSON, or choose a file, check it first and apply it, keeping what exists or replacing it. Apply import asks you to confirm once more.

  • Deactivate or reactivate

    The owner can lock everyone out and stop SDK keys from serving flags, without deleting anything. Reactivating, here or from the banner shown on every page while deactivated, asks you to confirm.

Good to know#

  • Renaming needs organization.update. Export and import need config.export and config.import.
  • Deactivating is reserved for the owner. SDKs fall back to their default values while it is deactivated.
  • An import is checked first and nothing changes until you apply it. Replacing never changes environments.
  • Each export is recorded in the audit log.
  • System values are read only here. Each one is set with a server environment variable and changes only when you redeploy. Secrets and connection strings are never shown.
  • The logo appears on every page, including the sign-in screens and the branded page not found and error pages, each of which links back to the console.
  • When the Database row says MongoDB, make sure npm run db:init-mongo has been run: the app never builds Mongo indexes itself. See Switch from PostgreSQL to MongoDB in the guides.