---
deeplabcut:
  last_content_updated: '2025-06-30'
  last_metadata_updated: '2026-03-06'
  ignore: false
  visibility: online
  status: viable
  recommendation: move
  notes: Move to a dedicated GUI section. Making the config edit tool slightly easier to work with and updating the docs below to include additional fields would be helpful.
---

(file:manage-project-gui)=

# Editing and working with the configuration file

<img src="https://images.squarespace-cdn.com/content/v1/57f6d51c9f74566f55ecf271/1572296495650-Y4ZTJ2XP2Z9XF1AD74VW/ke17ZwdGBToddI8pDm48kMulEJPOrz9Y8HeI7oJuXxR7gQa3H78H3Y0txjaiv_0fDoOvxcdMmMKkDsyUqMSsMWxHk725yiiHCCLfrh8O1z5QPOohDIaIeljMHgDF5CVlOqpeNLcJ80NK65_fV7S1UZiU3J6AN9rgO1lHw9nGbkYQrCLTag1XBHRgOrY8YAdXW07ycm2Trb21kYhaLJjddA/DLC_logo_blk-01.png?format=1000w" width="150" title="DLC-live" alt="DLC LIVE!" align="right" vspace = "50">

The configuration file (`config.yaml`) is the central record of files in your project, as well as the settings for your models.
As a YAML file, it can be edited manually, but the GUI provides an easy way to edit it without needing to know the YAML format. In this guide, we will show you how to edit the configuration file using the GUI.

## Editing the configuration

After creating your DeepLabCut project, you'll be shown the main GUI window, where you can manage your project from the Project Management Tab.

- **Locate the Configuration File:** At the top of the main window, you'll find the file path to the configuration file.
- **Edit the File:** Click on **`Edit config.yaml`**.
  - A **`Configuration Editor`** window will open, displaying all the configuration details.
  - You will need to modify some of these settings to align with your experiment.
  - For example:
    - Update or define the bodyparts you wish to track.
    - *Optional:* Outline the skeleton structure.

## Step-by-step configuration walkthrough

### Defining & updating bodyparts

- **Locate the Bodyparts Section:** In the Configuration Editor, find the **`bodyparts`** category.
- **Modify the List:** Click on the arrow next to **`bodyparts`** to expand the list. Here, you can:
  - Update the list with the names of the bodyparts relevant to your study.
  - Add more entries by right-clicking on a row number and selecting **`Insert`**.

![Editing Bodyparts in DeepLabCut's Config File](https://images.squarespace-cdn.com/content/v1/57f6d51c9f74566f55ecf271/1717779624617-CIVZCM23U69NYK9BO3GY/bodyparts.png?format=500w)

<!-- This tool is rather unintuitive in my opinion, as it is difficult to cleanly insert new skeleton entries. Improving this could be useful. -->

### Defining the skeleton

- **Navigate to the Skeleton Section:** Scroll down to the **`skeleton`** category.
- **Adjust the Skeleton List:** Click on the arrow to expand this section.
  - You can then update the list of bodypart pairs: i.e. the connections that define the skeleton structure of your model.
  - In the list of bodypart pairs, each pair has an index. (ranging from 0 to the total number of pairs in the skeleton).
  - Each item of the pair (also indexed; 0 or 1) has a value: the name of the bodypart.
  - Each pair of two bodyparts represents a connection, where all connections together make the skeleton.

![Defining the Skeleton Structure in Config File](https://images.squarespace-cdn.com/content/v1/57f6d51c9f74566f55ecf271/1717779598505-HQNECHIKSQ6XL033JX8M/skeleton.png?format=500w)

```{tip}
Spend some time visualizing how the chosen bodyparts can be connected effectively to form a coherent, visually helpful skeleton.
```

### Saving changes

- **Save the Configuration:** Once you're satisfied with the modifications, click **`Save`**. This will store your changes and return you to the main GUI window.

## Next steps

Head over the guide for the {ref}`file:labeling-gui`, which will show you how to label your data using the napari-based labeling GUI.