# Admin Settings UI

The Quilt catalog includes an admin panel that allows you to manage users and buckets in Quilt, as well as customize the Quilt catalog. You can access the panel via a dropdown menu under username in the navbar.

![](/files/-MgEVYDB-OIUp-dDFhyC)

The admin page is only accessible to designated administrators. The first admin is set during the CloudFormation installation. Subsequent admins may be designated through the panel. Only admins may create other admins.

Quilt requires at least one admin account per stack.

### Users and roles

This section provides comprehensive access control management for the following functions:

* Create/Delete user
* De/activate user
* De/admin user
* Assign roles to users
* Configure access policies

![](/files/-MgEVYDCmHXKpvdPe3Hp)

You may invite new users to your Quilt stack by clicking the + button, upper right. You must assign one or more roles to all new users (default role is pre-selected for you). You can edit existing users' attributes by clicking on underlined cells.

![](/files/FHlcju2RvqABa60mvC3H)

Users can switch between assigned roles via the dropdown menu in the navbar (if assigned more than one).

![](/files/B3wBdovQ6pXuMrLnbwA1)

![](/files/MJXQf11016hFGCKsn7OU)

You must select the default role for all new users, else they will not be able to sign in to the Quilt catalog. The default role is shown in bold.

![](/files/bHdgRSmaXDxg8aV5abS6)

You may create roles for different groups of users by combining up to 5 policies. Users of managed roles — including administrators — only see, list, and search buckets for which their role is explicitly granted read access.

![](/files/zeXotQRAbBFaQgNRt6pD)

![](/files/IyT6LDbdWSt60tI9Jxdk)

Alternatively, you may provide your own IAM roles via ARN:

![](/files/DWLkta1SqDQ5TBcnzpab)

You may create policies providing access to a selected set of buckets:

![](/files/vUwU6ScHSJoAVCvXMKk7)

![](/files/Jik0zXLzlG3YHPVpkp4Q)

![](/files/8m6omhEhtQFBNzIlnyhQ)

![](/files/sr5p5ngqfyLznXW7jLiN)

You may attach policies to managed roles from policy edit and create screens:

![](/files/sTffJUfVHM8xbTzH2Z7I)

You may also provide custom policies via ARN:

![](/files/1N8fLUnUb8EjF7StZfpZ)

The resulting permission set is equivalent to a union of all permissions provided by the policies attached to that role.

### Buckets

Here you can add or remove buckets from Quilt and configure bucket indexing and display settings.

![](/files/-MgEVYDEwNN3N0xuLZrH)

![](/files/-MgEVYDFzDYCaO9XXJ6F)

#### Reindexing

Stack admins can reindex a bucket via `POST /api/admin/reindex/<bucket>`. The request accepts an optional `prefix` field; when supplied, the existing Elasticsearch indices are left in place and only keys under that prefix are re-walked. This is useful for refreshing a slice of a large bucket without a full reindex.

#### S3 events

By default, when you add a bucket to the Quilt stack one of two things will happen:

1. If there is no existing bucket notification, Quilt will attempt to add a new notification
2. If there is an existing bucket notification, Quilt will use the existing notification if and only if it supports the required events (object creation and deletion)

If either of the above conditions fails, Quilt will not add the bucket in question.

See [S3 Events, EventBridge](/quilt-platform-administrator/advanced/eventbridge.md) for more.

### Settings

This section allows you to customize your Quilt catalog, including custom links in the navbar, custom logo, and default search mode. The Theme editor accepts a logo as either a direct file upload (PNG, JPEG, WebP, or GIF) or a URL (all of those plus SVG).

![](/files/-MgEVYDGQNdAfa67cnLw)

### Further settings

See [Preferences](/quilt-platform-administrator/preferences.md) for further control over the catalog user interface.


---

# Agent Instructions: 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:

```
GET https://docs.quilt.bio/quilt-platform-administrator/admin.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.