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

# Settings

The Settings module provides an interface for managing various aspects of your organization. It offers access to basic information, subscription and billing details, configuration options for Single Sign-On (SSO), and sensitive functionalities within the Danger Zone, including the ability to delete the organization.

<figure><img src="/files/ToAuvYBIMp8nA8WWmg0H" alt=""><figcaption><p>Organization settings</p></figcaption></figure>

## Organization Info

The Organization Info section of Settings displays important details about your organization. This includes:

* **Organization name** - The name of your organization.
* **Organization Id -** Unique organization identifier
* **Description -** optional field to describe organization

### Subscription & Billing

In the Subscription & Billing section, you can access information related to your organization's subscription and billing. This includes:

* **Subscription Plan -** Details of the current subscription plan.
* **Billing Account -** Email address of the account responsible for Organization limits
* **Next billing date:** Information about the next billing date.

{% hint style="warning" %}
**Payment Method** and **Invoice History** are only visible in the billing account detail.
{% endhint %}

### Single Sign-On (SSO)

Configure SSO for your organization. (More information how to set SSO up, you can find [here](/doc/access/cloud/single-sign-on-sso.md#how-do-i-set-up-a-single-sign-on-access-for-my-organization).)

#### Update SSO

By clicking on edit icon new dialog will be opened.

<figure><img src="/files/UsAFSc7lawGMOdmxLumP" alt="" width="375"><figcaption><p>Update SSO</p></figcaption></figure>

### AI Assistant Configuration

When running DecisionRules with Docker or on-premise, you have the option to configure your AI assistant. You’ll find setup details [here](/doc/ai-assistant/assistant-setup.md).

#### Update AI Assistant Configuration

By clicking on edit icon new dialog will be opened.

<figure><img src="/files/We3KH4GNwZAwfu0wjtII" alt=""><figcaption></figcaption></figure>

### Organization branding

Organization branding lets you customize how your organization appears in the DecisionRules application. Depending on your subscription plan or license, you can configure a custom logo, a custom color theme, or both.

Branding is configured on the organization level. After saving, the selected logo and custom theme are applied to all spaces that belong to the organization.

#### Logo

Use the **Logo** section to upload a custom organization logo.

The logo replaces the default DecisionRules logo in the application header for the organization. You can upload one image file, preview it before saving, and remove the current logo by using **Clear logo**.

To update the logo:

1. Open **Organization settings**.
2. Find **Organization branding** and select the edit icon.
3. Open the **Logo** tab.
4. Select or drag an image file into the upload area.
5. Check the preview.
6. Select **Update** to save the change.

If you clear the logo and save the change, the organization returns to the default logo.

<figure><img src="/files/1KK9XCnkdtWh2ZXBXXUN" alt=""><figcaption></figcaption></figure>

#### Custom theme

Use the **Custom theme** section to customize organization theme colors. Empty color fields keep the default DecisionRules theme value, so you only need to configure the colors you want to override.

The theme is divided into these color palettes:

* Primary
* Accent
* Info
* Success
* Warning
* Danger

Each palette contains shade levels from **50** to **900**. Lighter shades are used for subtle backgrounds and highlights, while darker shades are used for stronger UI states.

You can configure colors in two ways:

* Enter a hex color manually.
* Use the color picker.

Valid values are 3-digit or 6-digit hex colors, with or without `#`, for example `#583ed1`, `583ed1`, or `#abc`.

The preview strip shows how the selected palette looks across all shade levels. Each shade can be edited individually or cleared to return that shade to the default value.

**Generate shades**

The **Generate shades** action helps create a complete palette from one base color.

Enter a base color, then select **Generate shades**. The system uses the base color as shade **500** and automatically fills the other shade levels. Generated shades remain editable, so you can adjust or clear individual values before saving.

Select **Update** to save the custom theme.

<figure><img src="/files/vlYTC3K94JpVaE6g7F5x" alt=""><figcaption></figcaption></figure>

## Linked Organization

Organization Linking allows you to establish a hierarchy by categorizing organizations into managing (parent) and managed (child) entities. This feature streamlines management and provides centralized [statistics](/doc/organization/statistics.md), including visibility into the spaces of child organizations.&#x20;

<figure><img src="/files/Khskg0neQiDohWjd6r3d" alt=""><figcaption></figcaption></figure>

## Danger Zone

{% hint style="danger" %}
The ability to permanently delete the organization. This action is irreversible and will result in the loss of all associated data. Exercise extreme caution when using this feature. Only billing account can delete organization.
{% endhint %}

<figure><img src="/files/hNYMNtXD8cvIfV8EUixl" alt=""><figcaption><p>Delete Organization</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.decisionrules.io/doc/organization/settings.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
