> For the complete documentation index, see [llms.txt](https://docs.biodock.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.biodock.ai/projects-and-models/project-settings.md).

# Project settings

*What you'll get: how to rename a project, pick its thumbnail and cover image, choose the channels a model trains on, see who has access, and delete the project.*

To open a project's settings, go to **Projects**, open your project, and click **Settings** at the top of the page. These settings are for this one project, not your account.

<figure><img src="https://3806122466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fk3DfNQKoMy1JXdaDLvpG%2Fuploads%2Fgit-blob-b47aa535985f3f809512ecd2f0641e51ed1a30f3%2Fv2-project-settings-general.png?alt=media" alt="Project Settings, General section"><figcaption><p>The <strong>General</strong> section of a project's <strong>Settings</strong>.</p></figcaption></figure>

The page has these sections: **General**, **Appearance & channels**, **Access** and, for project owners, **Delete project**. Changes save as you make them, and you can **Undo** each one from the message that appears at the bottom of the page. Only a project owner can change these settings or delete the project.

### General

* **Name**: shown on Projects and Home, and to everyone with access.
* **Description**: optional. Say what the project is for, such as the cell type, the stain, or what you segment.
* **Project ID**: click **Copy** to copy it. Quote it to support, or use it with the API.

### Thumbnail and cover image

Both are in **Appearance & channels**.

* **Thumbnail**: the small image that identifies the project on Projects and Home. Pick one from the options shown.
* **Cover image**: shown when someone picks a model from this project to run an analysis, and used to preview channel colours. Click one of the project's images to make it the cover, or click **Browse all images** to choose from all of them. You need to add images to the project first.

### Channels

A channel is one layer of intensity in an image, such as one stain, marker or wavelength. Most colour images have three channels (red, green, blue). Electron microscopy images usually have one. In immunofluorescence, each channel is usually one marker. Check how many channels your images have, and what each one shows, before you train.

The project's channel settings decide which channels a model sees when it trains, and how bright they look:

* With **3 channels or fewer**, Biodock fills in defaults (channel 1 red, channel 2 green, channel 3 blue). You only need to change them to drop a channel or adjust brightness and contrast.
* With **more than 3 channels**, an owner must choose the channels before anyone can label.

Keep only the channels that show what you label. Models usually perform best with 3 channels or fewer, unless your channels are sparse.

{% hint style="info" %}
These settings only decide what the model sees for segmentation. Intensity metrics are still measured for every channel in the image.
{% endhint %}

#### Choose the channels

You need a cover image first, because the channels are previewed on it.

<figure><img src="https://3806122466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fk3DfNQKoMy1JXdaDLvpG%2Fuploads%2Fgit-blob-5feef5a845a275c8578b5e98eacba40d3861269d%2Fdocs-projects-choose-channels.gif?alt=media" alt="In Appearance and channels click Edit, click Remove channel on two cards, type Hoechst as the Channel name, click Save channels"><figcaption><p><strong>Channels</strong> → <strong>Edit</strong>, keep the channels you need, then <strong>Save channels</strong>.</p></figcaption></figure>

1. In **Appearance & channels**, find the **Channels** row and click **Edit**. If your images have more than 3 channels and none have been chosen yet, the button reads **Choose channels**.
2. In the **Configure channels for training** window, each card is one channel the model will see. Click **Add channel** to add one, or **Remove channel** to drop one.
3. For each card, choose the **Image channel** it comes from, a **Color**, and a **Channel name**. The colour is only for your eyes. With more than 3 channels, each channel needs a unique name.
4. Adjust **Brightness** and **Contrast** if a channel is dim. Both start at 50, which leaves the image as it is. These apply to every image in the project and at analysis time, so keep changes small if your images vary a lot.
5. Click **Save channels**.

<figure><img src="https://3806122466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fk3DfNQKoMy1JXdaDLvpG%2Fuploads%2Fgit-blob-71d30b84c5fae9a0b50801089694e00d945312a0%2Fv2-configure-channels.png?alt=media" alt="The Configure channels for training window"><figcaption><p>The <strong>Configure channels for training</strong> window, with a live preview on the cover image.</p></figcaption></figure>

New channel settings apply to the next version you train. Versions you already trained keep the settings they were trained with. When you run an analysis, you can map your images' channels to these channels, even if they are in a different order.

The **Channels** button on the labeling screen only changes your own view while you label. It does not change what the model trains on. In projects with more than one size group, you can also save channel settings per size group from the labeling screen; see [Label and train](https://docs.biodock.ai/start/path-2-train-a-fully-automated-ai-model/label-and-train.md).

### Access

**Access** shows who can open the project and their role. Owners manage settings and people; labelers label and train. In a workspace, it also shows whether everyone in the workspace can open the project. See [Sharing in your personal account](https://docs.biodock.ai/workspaces/sharing-in-your-personal-account.md#ai-projects) and [Sharing and visibility](https://docs.biodock.ai/workspaces/workspaces/sharing-and-visibility.md).

### Delete the project

1. In **Settings**, scroll down to **Delete project** and click **Delete project…**.
2. Type the project name to confirm, then click **Delete project**.

This removes the project's images, labels and trained models, and every evaluation and analysis run made with them, for everyone with access. It cannot be undone.

<figure><img src="https://3806122466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fk3DfNQKoMy1JXdaDLvpG%2Fuploads%2Fgit-blob-9e7dbc49e491caa72cdff3d291f46921280c75fa%2Fdocs-project-settings-access.png?alt=media" alt="Project Settings, Access and Delete project sections"><figcaption><p>The <strong>Access</strong> and <strong>Delete project</strong> sections.</p></figcaption></figure>


---

# 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.biodock.ai/projects-and-models/project-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.
