> ## Documentation Index
> Fetch the complete documentation index at: https://docs.collabase.ch/llms.txt
> Use this file to discover all available pages before exploring further.

> Configure schema details, control who can see your schema, and manage schema-level actions including deletion.

# Settings

# Schema Settings

Each Registry schema has its own settings panel where you can update its name, icon, color, and description, and control who can access it. Open a schema and click the **Settings** tab to access these options.

## Schema details

| Field           | Description                                                                                                                                                   |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**        | The display name of the schema. Shown in the Registry sidebar and the schema list.                                                                            |
| **Description** | An optional summary explaining what this schema models and what it is used for. Helps other users understand the schema's purpose when browsing the Registry. |
| **Icon**        | A visual identifier shown in the sidebar and in object headers throughout the Registry.                                                                       |
| **Color**       | An accent color applied to the schema's icon and cards across the UI.                                                                                         |

Click **Save** after changing any detail field.

## Schema permissions

Access to a schema is controlled by role assignments — you decide who can see it and what they can do. This is separate from the space-level Permission Scheme; Registry is an instance-wide module.

### Schema roles

| Role            | What they can do                                                                |
| --------------- | ------------------------------------------------------------------------------- |
| **Admin**       | Edit schema structure, manage all objects, import/export CSV, delete the schema |
| **Editor**      | Edit field definitions, create/edit/delete objects, import CSV                  |
| **Contributor** | Create new objects and read all objects                                         |
| **Viewer**      | Read objects only — no create or edit access                                    |

Users with a **Registry Admin** module role (granted in **Admin → Roles & App Access**) can access all schemas regardless of per-schema assignments.

### Managing schema permissions

<Steps>
  <Step title="Open the schema and go to Settings → Permissions">
    The Permissions tab shows all current user and group assignments.
  </Step>

  <Step title="Add a user or group">
    Click **Add Access**, search for the user or group, and select a role.
  </Step>

  <Step title="Save">
    Access is granted immediately. Users see the schema in their Registry sidebar.
  </Step>
</Steps>

To remove access, click the remove icon on the user's or group's row. They immediately lose access to the schema and all its objects.

### Default role

You can set a **Default role** for the schema. Any user with the **Registry User** module access who is not explicitly assigned a role receives this default role when they open the schema.

| Default role       | Effect                                                          |
| ------------------ | --------------------------------------------------------------- |
| *(none — private)* | Only explicitly assigned users and groups can access the schema |
| **Viewer**         | All Registry Users can read objects — no editing                |
| **Contributor**    | All Registry Users can create and read objects                  |

## Renaming a schema

1. Open the schema and click the **Settings** tab.
2. Edit the **Name** field.
3. Click **Save**.

The new name appears in the Registry sidebar and throughout the UI immediately.

## Changing the icon or color

1. Open the schema settings.
2. Click the **Icon** field to open the icon picker and select a new icon.
3. Click the **Color** field to choose a new accent color.
4. Click **Save**.

## Schema ownership

The user who created a schema is its owner. There is currently no way to transfer ownership of a schema to another user.

<Note>
  Registry is not scoped to a Space. Space admins have no special access to Registry schemas — access is controlled exclusively through the schema's **Settings → Permissions** tab and the module access role granted in **Admin → Roles & App Access**.
</Note>

## Deleting a schema

<Warning>
  Deleting a schema permanently and irreversibly removes all object types, all attribute definitions, all objects, all field values, and all relations within the schema. This cannot be undone. Export any important data before proceeding.
</Warning>

<Steps>
  <Step title="Open Schema Settings">
    Open the schema you want to delete and click the **Settings** tab.
  </Step>

  <Step title="Scroll to the Danger Zone">
    Scroll to the bottom of the settings page to find the **Danger Zone** section.
  </Step>

  <Step title="Click Delete Schema">
    Click **Delete Schema**. A confirmation dialog appears.
  </Step>

  <Step title="Confirm by typing the schema name">
    Type the exact schema name in the confirmation field to confirm you intend to delete it, then click **Delete**.
  </Step>
</Steps>

After deletion, the schema no longer appears in the Registry sidebar. Any project tasks that had a Registry Object field pointing to objects in this schema will show an empty value for that field.