> For the complete documentation index, see [llms.txt](https://docs.brainboard.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.brainboard.co/settings/overview.md).

# Overview

## Settings

**Settings** in <mark style="color:$primary;">**Brainboard**</mark> provide a flexible and hierarchical configuration system allowing you to manage settings at different levels of your organization.

### Overview

Settings in <mark style="color:$primary;">**Brainboard**</mark> are organized in a hierarchical structure that follows this inheritance pattern.

{% hint style="info" icon="sitemap" %}
**Organization → Project → Environment → Architecture**
{% endhint %}

{% hint style="success" %}
This hierarchical approach ensures that configurations that are shared across the hierarchy can be managed efficiently while allowing for specific overrides at any level when needed.
{% endhint %}

### Accessing Settings

#### Organization Settings

To access the **Organization's settings,** go to the <mark style="color:$primary;">**`Settings`**</mark> option in the **left bar** and then click <mark style="color:$primary;">**`Organization`**</mark>**.** &#x20;

<figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2FgvU7oTFShg7GtcSC9Ndh%2Forg-settings.png?alt=media&amp;token=1b8c905c-59c7-4ec3-9bc1-ec9013f8a7ee" alt=""><figcaption></figcaption></figure>

#### Project Settings

To access the **Project's settings,** go to the <mark style="color:$primary;">**`Settings`**</mark> option in the **left bar** and then click <mark style="color:$primary;">**`Projects`**</mark>**.** Then, click the **ellipsis** (three dots) against the project name and click <mark style="color:$primary;">**`Change Settings`**</mark> in the dropdown menu. It will navigate you to the project's settings page.&#x20;

<figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2FdGhGlfgoobkpeS6inYKf%2FProject-settings.png?alt=media&amp;token=b2f20238-4508-42cb-a601-7c1a35ecdff0" alt=""><figcaption></figcaption></figure>

#### Environment Settings

Once you are on the <mark style="color:$primary;">**Project settings**</mark> page, you can also view the associated environments at the top. Click on the desired environment to go to its settings page.&#x20;

<figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2FwdAn74kUPif4f99VlpBb%2Fenv-settins.png?alt=media&amp;token=b3f7a8c5-726e-418e-b5f6-f40589e7660c" alt=""><figcaption></figcaption></figure>

#### Architecture Settings

1. Open your architecture.
2. Switch to the **settings** **tab** using the **settings icon** in the options bar at the top.&#x20;

<figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2FrUZ4ucZB2OT6wBfCM0B0%2Farch-settings.png?alt=media&amp;token=8eacc1fe-3dde-4699-b9fa-eca6e3d8a9de" alt=""><figcaption></figcaption></figure>

### Hierarchical Settings Management

#### Inheritance chain

Settings follow a clear inheritance structure:

1. **Organization Level**: The highest level, affects all projects, environments, and architectures.<br>

<figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2Fs7GIIyEN8QkSndIAYfQT%2FFrame%2015842.png?alt=media&amp;token=cc3456c5-2009-4196-8573-3a9ac9b84d22" alt=""><figcaption><p>Settings defined at organization level and not overridden at any lower level</p></figcaption></figure>

2. **Project Level**: Overrides organization settings for all environments and architectures within the project

<figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2FxVFeFhZZ8st5UcXaFTnX%2FFrame%2015852.png?alt=media&amp;token=90884101-2006-4295-8e0d-ef3a9c8a2784" alt=""><figcaption><p>Setting defined at organization level being overridden at a project level</p></figcaption></figure>

3. **Environment Level**: Overrides organization and project settings for all architectures within the environment

<figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2Fqtw2c8dWeffpYCtu1NDf%2FFrame%201586.png?alt=media&amp;token=90ab99ac-9f24-4f94-9a45-fb56f08618a6" alt=""><figcaption><p>Setting defined at organization level being overridden at a project level and again at an environment level</p></figcaption></figure>

4. **Architecture Level**: The most specific level, overrides all higher-level settings for a particular architecture

<figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2FPQVgVscnpO1b1arCy39G%2FFrame%201587.png?alt=media&amp;token=2514ce32-86ba-44a7-a74f-99f6f81de8c2" alt=""><figcaption><p>Setting defined at organization level being overridden at a project level , then overridden again at an environment level and finally at the architecture level</p></figcaption></figure>

#### Visual Indicators

When viewing settings at any level, you'll see visual indicators showing:

1. When a setting is locked at a higher level (with the source of the lock).

<figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2FWXQTm87naUsTymgrKq68%2Fproje-level-lock.png?alt=media&amp;token=829b9691-24e1-4e4a-8e34-57d67de357e2" alt="" width="272"><figcaption></figcaption></figure>

2. When a setting is overridden at your level (the reset button shows that the value is set at this level).

<p align="center"><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2FK1M2UevEj0kP3lV3qMVA%2Farch-level-lock.png?alt=media&amp;token=97a145c1-b5c8-4721-abf7-b0e42bc1cd2f" alt=""></p>

3. When a setting is locked at your level, preventing any lower levels from updating.<br>

<figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2Fhpn07h6Oit1GJfGlUayl%2Fprevent-lower-lock.png?alt=media&amp;token=925226ca-35a3-4769-830a-f88a7c3d6afb" alt="" width="298"><figcaption></figcaption></figure>
