Manage Organization Settings

Organization Settings is where you configure environment types, brands, variables and secrets, and core organization details like name and operating regions.

To access Organization Settings, navigate to Settings in the left-hand navigation menu.

The Organization Settings page has four tabs: Environment Types, Brands, Variables & Secrets, and Manage.

Environment Types

The Environment Types tab is where you enable and configure any additional environment types you wish to use within your organization.

Environment types allow you to configure different categories of environments for your brands, enabling you to separate testing, staging, and production workflows based on your organizational requirements.

For detailed information on creating and managing environment types, including configuring environment type-level variables and secrets, read our Environment Types guide.

Brands

The Brands tab is where you enable and configure any additional brands you wish to use within your organization.

Brands let you tailor access, environments and features across different entities within your organization, such as different mastheads, regional editions, or product lines.

This functionality is off by default. To enable it, click 'Enable Brands'. A modal will pop up, explaining that enabling brands is a permanent action and cannot be undone. To continue, click 'Enable Brands', otherwise click 'Cancel'.

For detailed information on creating and managing brands, including configuring brand-level variables and secrets and using brand filters, read our Brands guide.

Variables & Secrets

The Variables & Secrets tab allows you to define key-value pairs at the organization level that can be consumed in workflows across all brands and environments, enabling you to separate configuration from logic.

Variables defined at an organization-level will apply to all workflows throughout your organization unless overridden by variables set at the brand, environment type, or brand-environment level.

Variables are useful for storing organization-wide configuration values like company-wide API endpoints, global feature flags, or other settings that apply across your entire organization. Secrets are a special type of variable designed for sensitive data like API keys, where the value cannot be viewed once saved.

Creating Variables & Secrets

To add a variable or secret, click 'Add Variable'.

You'll need to provide:

Key: The variable name (must start with a letter or underscore, contain only alphanumeric characters and underscores, maximum 64 characters)
Value: The variable content (stored as text)
Secret: Toggle this on to mark the variable as a secret

When you're ready to save, you can choose:

Save: Save the variable and return to the list
Save and Add Another: Save the variable and immediately create another one
Cancel: Discard changes and return to the list

Variable Precedence

Variables defined at the organization level have the lowest precedence and will be overridden by variables with the same key set at the brand, environment type, or brand-environment level.

Using Variables in Workflows

Variables and secrets are accessible in workflows through the env parameter:

export default ({ env }) => {
  console.log(env.SERVICE_URL);

  // Use variables for configuration
  const apiEndpoint = env.API_ENDPOINT;
  const secretKey = env.SECRET_API_KEY;
};

All variables are provided as strings and may be undefined if not set at any level.

Security Considerations

Secrets are designed for sensitive data:

Values cannot be viewed in the console once saved
Values are not accessible via the admin API
Use secrets for API keys, passwords, and other sensitive configuration

Variables are for non-sensitive configuration:

Values are visible in the console
Use for API endpoints, feature flags, and other non-sensitive settings

Note: Ensure you use the secret toggle for any sensitive data like API keys or passwords.

Managing Variables & Secrets

To edit a variable or secret, locate it in your variables & secrets list, then click the 'Edit' icon in the actions column.

This will bring up the same screen you used to configure your variable. Make any relevant changes and click 'Save'.

To delete a variable or secret, locate it in your variables & secrets list, then click the 'Delete' icon in the actions column.

You will be prompted to confirm you wish to remove the variable. This action cannot be undone.

To continue, click 'Delete'. Otherwise, click 'Cancel'.

When updating a variable, the change will propagate to all relevant environments automatically.

Manage

This tab allows you to alter the name and description of your organization.

The organization name is visible to your team members and used throughout the app.

This area is also where you select the operating regions we will write data to.

We recommend you select the regions where your users are primarily located. Choosing regions closer to your users will reduce latency and improve API speed.

Select each relevant region, then click 'Update'.

Delete Organization

On rare occasions you may wish to delete your organization. Doing so will permanently delete your organization and all its data. This option is only available to users with certain user permissions.

If you can see the option, click the 'Delete' button. You will be prompted to confirm that you wish to remove the organization. This action cannot be undone. If you wish to continue, click 'Delete'. Otherwise click 'Cancel'.

If you cannot see the option to delete an organization, contact the organization owner.

On this page