> For the complete documentation index, see [llms.txt](https://docs.unitlab.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.unitlab.ai/documentation/datasets/create-a-dataset.md).

# Create a dataset

Create a dataset from folders or files in Data Space and publish its first version.

Create a dataset when you know which files you want to label. You can add more files later and publish them as a new version.

## Before you begin

* The files are already in **Assets**. A dataset does not upload files; it selects existing ones. See [Upload data](https://docs.unitlab.ai/documentation/data/data-upload.md).
* You need the **Manage data** permission.

## Create the dataset

{% stepper %}
{% step %}

### Open New Dataset

In the sidebar, select **Datasets**, then **New Dataset**.
{% endstep %}

{% step %}

### Name it

Enter a name that says what the data is for, such as *Kitchen grasping - day and night*. Add a description if other teams will use it.
{% endstep %}

{% step %}

### Choose the files

Use the **Folders** and **Assets** tabs to pick folders, single files or grouped folders. Search to find them quickly. The summary shows how many sources you selected.

<figure><img src="https://292810646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGjVLUz4wthGkGlRKM6rM%2Fuploads%2FtTV3DGAKnXfhjdYyOeul%2Fdataset-create-modal.webp?alt=media" alt="New Dataset dialog with name, description and the Folders and Assets tabs listing robotics folders" width="560"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Create it

Select **Create Dataset**. The dataset opens and shows its folders and files. It is now a **draft**.
{% endstep %}

{% step %}

### Publish version 1

Select **Publish version**. Projects can attach published versions only.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
You can also skip the last step. When you attach an unpublished dataset to a project, the dialog lists it under **No published version yet** and offers **Publish them as v1 and attach**.
{% endhint %}

## Add more files later

Open the dataset and select **Attach Data** to add more folders or files to the draft. The version badge turns orange (**Draft vN**). Publish a new version when you are ready.

## Tips

* One dataset per purpose. Put "day" and "night" in one dataset if they are labeled together; split them if they go to different projects.
* Check a few files in **Grid** view before you publish.
* Include the whole Data Group, not single files, when files must be labeled together.

## Related

[Dataset versions and history](https://docs.unitlab.ai/documentation/datasets/dataset-versions-and-history.md) · [Attach datasets to projects](https://docs.unitlab.ai/documentation/datasets/attach-datasets-to-projects.md) · [Curate and filter data](https://docs.unitlab.ai/documentation/data/data-curation.md)
