> 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/organize-your-workspace/manage-workspace-settings.md).

# Manage workspace settings

Change workspace details, customize branding, and delete a workspace when needed.

Manage settings that apply to one workspace.

In **Workspace settings** you can:

* change the **Workspace name**
* review and update the **Internal name**
* customize the workspace home background
* delete the workspace

Changes you make here affect this workspace only.

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

### Change workspace details

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

{% stepper %}
{% step %}

#### Open workspace settings

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

Under **WORKSPACE**, select **Settings**.
{% endstep %}

{% step %}

#### Update the workspace details

Edit **Workspace name**.\
Choose a clear name for the team or business area.

Review **Internal name** and change it only if needed.\
The internal name is the system identifier for the workspace.
{% endstep %}

{% step %}

#### Save the changes

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

### Customize workspace branding

Customize the workspace home background. It appears across **Home**, **Inbox**, **Documents**, and **Bookmarks**.

In **Workspace settings**, select **Custom branding**.

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.

#### Set a color background

After choosing **Color**, set a solid color for the workspace.

{% 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 workspace**.
{% 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 workspace**.
{% 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 **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 workspace** to apply the background.
{% endstep %}
{% endstepper %}

### Delete a workspace

Delete a workspace only when you no longer need the apps and data inside it. When you start deletion, Ninox asks you to confirm the action explicitly before it is carried out.\
Deleting a workspace cannot be undone.

{% hint style="warning" %}
Deleting the workspace permanently deletes all apps and data inside that workspace.
{% endhint %}

Before you delete the workspace, make sure you have saved anything you still need.

{% stepper %}
{% step %}

#### Open the delete action

In **Workspace settings**, go to **Danger zone**.\
Click **Delete workspace**.
{% endstep %}

{% step %}

#### Confirm the deletion

Select the confirmation checkbox.\
Confirm your email address.\
Enter the exact workspace name.
{% endstep %}

{% step %}

#### Delete the workspace

Click **Delete workspace**.

The workspace and all data inside it are permanently deleted.
{% endstep %}
{% endstepper %}


---

# 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/organize-your-workspace/manage-workspace-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.