> For the complete documentation index, see [llms.txt](https://docs.ninox.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ninox.com/builder-hub/manage-your-organization-and-workspace/manage-your-organization/manage-organization-settings.md).

# Manage organization settings

Update your organization details, branding, navigation color, and workspace background.

Manage settings that apply across your organization.

In **Organization settings** you can:

* change the **Organization name**
* review and update the **Internal name**
* customize the logo, navigation color, and workspace background
* delete the organization

Changes you make here affect all workspaces and apps in the organization.

Use the **Details** tab to manage organization information. Use the **Custom branding** tab to customize its appearance.

{% hint style="info" %}
Only users with the role **Admin** can update or delete an organization. For role details, see [Manage organization access](/builder-hub/manage-your-organization-and-workspace/manage-your-organization/manage-organization-access.md).
{% endhint %}

## Change organization details

Use this screen when the displayed organization name changes or when you need to review the internal name.

{% stepper %}
{% step %}

#### Open organization settings

If you are not already on the settings screen, click the gear icon **Settings** in the main navigation.

Under **ORGANIZATION**, open the organization settings screen.
{% endstep %}

{% step %}

#### Update the organization details

Select the **Details** tab.

Edit **Organization name**.\
Choose a clear name that matches your company or team.

Review **Internal name** and change it only if you need a different value.\
Change the internal name only when you need a specific value for your setup.
{% endstep %}

{% step %}

#### Update the organization

Confirm the change in the settings screen with **Update organization**.\
The updated details apply across the organization.
{% endstep %}
{% endstepper %}

## Customize organization branding

Customize the organization appearance for everyone in your workspaces.

{% hint style="info" %}
Select the **Custom branding** tab before making these changes.
{% endhint %}

### Customize the organization logo

Use your logo to give every workspace a recognizable identity.\
It replaces the global menu icon <i class="fa-grid-round">:grid-round:</i> in the main navigation.

{% stepper %}
{% step %}
**Upload the logo**

Under **Custom logo**, click **Upload**, then select a PNG or JPEG file up to 5 MB.
{% endstep %}

{% step %}
**Save the logo**

Click **Update organization** to save your changes.
{% endstep %}
{% endstepper %}

### Customize the navigation color

Choose a navigation color that reflects your organization and makes the interface feel familiar.

{% stepper %}
{% step %}
**Choose a color**

Under **Navigation color**, click the color picker next to **Select color**. Then pick a color or enter an RGB, HEX, or color name.

Click **Confirm**.

The main navigation updates immediately. Check the new color before saving your changes.
{% endstep %}

{% step %}
**Save the color**

Click **Update organization**.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Want to return to the default navigation color? Click **Reset** to remove your selection, then click **Update organization** to save the change.
{% endhint %}

### Customize the workspace background

Give the Workspaces page a distinct look for your organization.

Choose one of these background options:

* **Default** uses the default background.
* **Color** lets you pick a custom solid color.
* **Gradient** lets you define a gradient.
* **Image** lets you upload and adjust an image.

#### Use the default background

Select **Default** to use the default background. Select another tab to customize it.

#### Set a color background

After choosing **Color**, set the solid color that fits your organization.

{% stepper %}
{% step %}
**Select the color**

Under **Background color**, select a solid color or enter an RGB, HEX, or color name. Click **Confirm**.
{% endstep %}

{% step %}
**Save the background**

Click **Update organization**.
{% endstep %}
{% endstepper %}

#### Set a gradient background

After choosing **Gradient**, define colors and direction for the background.

{% stepper %}
{% step %}
**Set the gradient colors**

Choose the start and end colors.
{% endstep %}

{% step %}
**Set the gradient direction and angle**

Select **Vertical**, **Horizontal**, or **Custom angle** for **Direction**. Set the **Angle**.
{% endstep %}

{% step %}
**Save the background**

Click **Update organization**.
{% endstep %}
{% endstepper %}

#### Set an image background

After choosing **Image**, upload and position an image for the background.

{% stepper %}
{% step %}
**Upload the image**

Click **Upload image** and select a PNG, WEBP, JPG, or JPEG file up to 10 MB.
{% endstep %}

{% step %}
**Adjust the image**

Set the **Size** to **Contain**, **Cover**, or **Stretch**.\
Choose a **Position** for the image.

Use **Replace** to upload a different image. Use **Remove** to delete the image.
{% endstep %}

{% step %}
**Save the background**

Click **Update organization** to apply the background.
{% endstep %}
{% endstepper %}

## Delete an organization

Delete an organization only when you no longer need any workspace or app inside it. When you start deletion, Ninox asks you to confirm the action explicitly before it is carried out.\
Deleting an organization cannot be undone.

{% hint style="warning" %}
Deleting the organization permanently deletes all workspaces inside it and all related data.
{% endhint %}

Before you delete the organization, make sure you have saved anything you still need. In **Organization settings**, select the **Details** tab and click **Delete organization**. Then complete the required confirmation steps.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.ninox.com/builder-hub/manage-your-organization-and-workspace/manage-your-organization/manage-organization-settings.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.