> 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/getting-started/builder-getting-started/intro-to-the-ninox-ui/settings-screen-user-organization-workspace.md).
# Settings screen - user, organization, workspace
The **Settings** screen is the central place where you configure your user account, organizations, and workspaces.
You can reach the **Settings** screen from different places:
* **Settings** in the main navigation
* **Global menu** in the main navigation
* **Profile** menu in the main navigation for your user settings
No matter where you open it from, the layout is similar and the left settings menu always contains the same main sections. What changes is which section is selected first, depending on how you opened the screen.
It helps to think of the three levels on the **Settings** screen as:
* **User account** settings apply only to you as a person, regardless of which organization or workspace you are in.
* **Organization** settings apply to everything inside that organization, including all its workspaces.
* **Workspace** settings apply only to the selected workspace and can differ from workspace to workspace in the same organization.
## User account and Profile settings
On the **Profile** screen you can:
* Check or update your name, display name, and email address
* Delete your account
{% hint style="info" %}
Changes you make here apply to your own user profile, not to a specific organization or workspace.
{% endhint %}
## Organization properties
The **Organization** section contains settings that apply only to the current organization, you can:
* Click the arrow next to the organization name to switch to another organization or set up a new one
* Change general organization details such as the name and internal name
* Manage organization users, roles, and permissions
* Manage the organization subscription and track usage
### Organization settings
In **Organization settings** you can:
* See and change the **Organization name** and **Internal name** of the organization
* Delete the organization
Changes you make here affect all workspaces and apps inside this organization.
If you choose to delete an organization, Ninox asks you to confirm the action explicitly before it is carried out.
{% hint style="danger" %}
Deleting an organization cannot be undone. All workspaces inside this organization are permanently deleted, and all data associated with those workspaces is lost.
{% endhint %}
To delete an organization:
1. Select the confirmation checkbox.
2. Confirm your email address.
3. Confirm the exact organization name.
4. Click **Delete organization**.
### Organization users and roles
The **Organization users & roles** screen is the central place to manage access across the current organization.
On this screen you can:
* Use **Search by email…** to find a specific user
* Use **Filter by status** to narrow the list by invitation or account status
* Click **+ Invite users** to add new organization users
* Select users with the checkboxes in the list for bulk actions
* Change a user’s organization role directly in the **Role** column
You can also see:
* Which workspaces a user belongs to in the **Workspaces** column
* When a user joined or when the invitation was sent in **Joined / Invited**
* Whether the email address is confirmed in **Verified**
* The current access state in **Status**, for example **Active**
Available organization roles include:
* **Member** for regular users who work in assigned workspaces
* **Admin** for full organization access
* **Billing** for subscription and payment management
* **User management** for managing users and invitations
* **Workspace management** for creating and managing workspaces
Learn more in [Manage organization access](/builder-hub/manage-your-organization-and-workspace/manage-your-organization/manage-organization-access.md).
### Subscription and usage
The **Subscription and Usage** screen lets you manage your organization plan and track usage.
In the **Subscription** tab you can:
* See which plan is active. The current plan is marked on its card.
* Switch between **Monthly** and **Annual** billing.
* Compare **Free**, **Team**, and **Business** side by side.
The available plans include:
* **Free** for individuals getting started
* **Team** for small teams building and sharing apps
* **Business** for teams that need advanced security and control
Use the plan cards to compare included features, limits, and pricing.
In the **Usage** tab you can:
* Switch between **Organization** and **Workspace** usage.
* Check when usage data was last updated.
* Review current usage against the included limit for each metric.
In **Organization** usage you can track:
* **Storage**
* **Records**
* **API calls**
* **Documents generated**
* **Linked emails**
In **Workspace** usage you can:
* Search for a workspace
* Compare usage across workspaces in one table
* Review **Storage**, **Records**, **API calls**, **Documents generated**, **Sent emails**, and **Linked emails** for each workspace
This gives you one place to manage billing and monitor usage for the organization and its workspaces.
## Workspace properties
{% hint style="info" %}
All changes you make here apply to the current workspace only.
{% endhint %}
In **Workspace** properties you can:
* Click the arrow next to the workspace name to switch to another workspace or set up a new one
* Change general workspace details such as the name and internal name
* Adjust workspace appearance, such as colors or the icon
* Manage workspace users, roles, and permissions
* Manage API access and integrations
* Connect and manage email settings
### Workspace settings
In the workspace settings section you can:
* See and change the **Workspace name**
* Adjust the **Internal name** of the workspace
* Delete the current workspace
If you choose to delete a workspace, Ninox asks you to confirm the action explicitly before it is carried out.
{% hint style="danger" %}
Deleting a workspace cannot be undone. The workspace is permanently deleted, and all data associated with this workspace is lost.
{% endhint %}
### Workspace users and roles
The **Workspace users and roles** screen is where you manage access for the current workspace only.
On this screen you can:
* Click **+ Invite users** to add users to the workspace
* Change a user’s workspace role directly in the **Role** column
* Use **Search by email** to find specific members
* Use **Filter by status** to review invitation and account status
You can also see:
* When a user joined or when the invitation was sent in **Joined / Invited**
* Whether the email address is confirmed in **Verified**
* The current access state in **Status**, such as **Active**
Available workspace roles include:
* **Admin**: Full access to the workspace.
* **Editor**: Can read, create, edit, and delete data.
* **Viewer**: Can read and export data, but cannot create, edit, or delete it.
* **None**: No default workspace role. Use this when access should come only from custom roles.
Learn more in [Manage workspace access](/builder-hub/manage-your-organization-and-workspace/organize-your-workspace/manage-workspace-access.md).
### API and integrations
The **API and integrations** screen is where you manage API access and workspace integrations for the current workspace.
The Ninox public API lets you access workspace data programmatically from external systems. An API key is required to authenticate requests. Each key only grants access to resources in this workspace.
On this screen you can:
* Click **Create new API key** to generate a new key
* Open the API documentation links for **Swagger UI**, **JSON schema**, and **YAML schema**
* Review all API keys created for this workspace
* Revoke keys that are no longer needed
For each API key, you can see its name, what it can access, when it expires, who created it, and when it was created.
### Email integration
Access all your emails directly in your Ninox workspace. This integration keeps your workspace and email communication in sync with just a few clicks. Connect your inbox to Ninox and start syncing your emails.
To connect your inbox, open **Email integration** in the navigation.
Click either **Continue with Google** or **Continue with Microsoft**. Ninox will automatically use your prefilled email information to connect your account.
Once connected, your email address will be displayed along with an option to disconnect if needed.
Select **Disconnect** to remove your email account connection.
---
# 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.ninox.com/getting-started/builder-getting-started/intro-to-the-ninox-ui/settings-screen-user-organization-workspace.md?ask=&goal=
```
`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.