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

# Creating a dataset

> Walk through creating a custom dataset in the Tilebox Console, from choosing the right dataset kind to defining your schema fields and organizing groups.

This page guides you through the process of creating a dataset in Tilebox using the [Tilebox Console](/console).

## Related documentation

<Columns cols={2}>
  <Card title="Datasets" icon="database" href="/datasets/concepts/datasets" horizontal>
    Learn about Tilebox datasets and how to use them.
  </Card>

  <Card title="Timeseries Datasets" icon="diamonds-4" href="/datasets/types/timeseries" horizontal>
    Learn about Timeseries datasets, which link each data point to a specific point in time.
  </Card>
</Columns>

## Creating a dataset in the Console

<Steps>
  <Step title="Navigate to the Create dataset form">
    Create a dataset in Tilebox by going to [My datasets](https://console.tilebox.com/datasets/my-datasets) and clicking the `Create dataset` button.
  </Step>

  <Step title="Select a dataset kind">
    Choose a [dataset kind](/datasets/concepts/datasets#dataset-types) from the dropdown menu. Required fields for the selected dataset kind are automatically added.

    <Frame>
      <img src="https://mintcdn.com/tilebox/TYquvc9froFIydg1/assets/console/datasets-create-light.png?fit=max&auto=format&n=TYquvc9froFIydg1&q=85&s=f621749a2c3cd3e4a52d52f383fdf4a5" alt="Tilebox Console" className="dark:hidden" width="1536" height="970" data-path="assets/console/datasets-create-light.png" />

      <img src="https://mintcdn.com/tilebox/TYquvc9froFIydg1/assets/console/datasets-create-dark.png?fit=max&auto=format&n=TYquvc9froFIydg1&q=85&s=923e3fbad80aad921904a21d84491d5c" alt="Tilebox Console" className="hidden dark:block" width="1536" height="970" data-path="assets/console/datasets-create-dark.png" />
    </Frame>
  </Step>

  <Step title="Specify a name, code name, and description">
    Complete these fields:

    * `Name` is the name of your dataset.
    * `Code name` is a unique identifier for the dataset within your team. It's automatically generated, but you can adjust it if needed.
    * `Description` is a brief description of the dataset purpose.

    <Frame>
      <img src="https://mintcdn.com/tilebox/TYquvc9froFIydg1/assets/console/datasets-create-temporal-light.png?fit=max&auto=format&n=TYquvc9froFIydg1&q=85&s=ed5df70c7b79fdf4ae0f99a7633b2296" alt="Tilebox Console" className="dark:hidden" width="1536" height="970" data-path="assets/console/datasets-create-temporal-light.png" />

      <img src="https://mintcdn.com/tilebox/TYquvc9froFIydg1/assets/console/datasets-create-temporal-dark.png?fit=max&auto=format&n=TYquvc9froFIydg1&q=85&s=86c68c69b524cff41a339f36308741eb" alt="Tilebox Console" className="hidden dark:block" width="1536" height="970" data-path="assets/console/datasets-create-temporal-dark.png" />
    </Frame>
  </Step>

  <Step title="Define the dataset schema">
    Specify the fields for your dataset.

    Each field has these properties:

    * `Name` is the name of the field (by convention it is recommended to be in `snake_case`).
    * `Type` is the data type of the field.
    * `Array` can be set to indicate that the field contains multiple values of the specified type.
    * `Description` is an optional brief description of the field. You can use it to provide more context and details about the data.
    * `Example value` is an optional example for this field. It can be useful for documentation purposes.

    <Frame>
      <img src="https://mintcdn.com/tilebox/TYquvc9froFIydg1/assets/console/datasets-create-temporal-light.png?fit=max&auto=format&n=TYquvc9froFIydg1&q=85&s=ed5df70c7b79fdf4ae0f99a7633b2296" alt="Tilebox Console" className="dark:hidden" width="1536" height="970" data-path="assets/console/datasets-create-temporal-light.png" />

      <img src="https://mintcdn.com/tilebox/TYquvc9froFIydg1/assets/console/datasets-create-temporal-dark.png?fit=max&auto=format&n=TYquvc9froFIydg1&q=85&s=86c68c69b524cff41a339f36308741eb" alt="Tilebox Console" className="hidden dark:block" width="1536" height="970" data-path="assets/console/datasets-create-temporal-dark.png" />
    </Frame>
  </Step>

  <Step title="Save">
    Once you're done completing the fields, click "Create" to create and save the dataset. You are redirected to your newly created dataset.
  </Step>
</Steps>

## Automatic dataset schema documentation

By specifying the fields for your dataset, including the data type, description, and an example value for each one, Tilebox
is capable of automatically generating a documentation page for your dataset schema.

<Frame>
  <img src="https://mintcdn.com/tilebox/TYquvc9froFIydg1/assets/console/datasets-overview-light.png?fit=max&auto=format&n=TYquvc9froFIydg1&q=85&s=584bc56b71a1e57fbd53677d334b37e6" alt="Dataset schema overview" className="dark:hidden" width="1536" height="970" data-path="assets/console/datasets-overview-light.png" />

  <img src="https://mintcdn.com/tilebox/TYquvc9froFIydg1/assets/console/datasets-overview-dark.png?fit=max&auto=format&n=TYquvc9froFIydg1&q=85&s=2dfb5e334ffb2a83f7e9f3fbe0f996fa" alt="Dataset schema overview" className="hidden dark:block" width="1536" height="970" data-path="assets/console/datasets-overview-dark.png" />
</Frame>

## Adding extra documentation

You can also add custom documentation to your dataset, providing more context and details about the data included data.
This documentation supports rich formatting, including links, tables, code snippets, and more.

<Frame>
  <img src="https://mintcdn.com/tilebox/TYquvc9froFIydg1/assets/console/datasets-documentation-light.png?fit=max&auto=format&n=TYquvc9froFIydg1&q=85&s=503b75faaeaf17928f99fd2733072530" alt="Tilebox Console" className="dark:hidden" width="1536" height="970" data-path="assets/console/datasets-documentation-light.png" />

  <img src="https://mintcdn.com/tilebox/TYquvc9froFIydg1/assets/console/datasets-documentation-dark.png?fit=max&auto=format&n=TYquvc9froFIydg1&q=85&s=6cf8569b38ddd2bf4ee85b66ae6d417c" alt="Tilebox Console" className="hidden dark:block" width="1536" height="970" data-path="assets/console/datasets-documentation-dark.png" />
</Frame>

To add documentation, click the edit pencil button on the dataset page to open the documentation editor.
You can use Markdown to format your documentation; you can include links, tables, code snippets, and other Markdown features.

<Note>
  If you don't see the edit pencil button, you don't have the required permissions to edit the
  documentation.
</Note>

Once you are done editing the documentation, click the `Save` button to save your changes.

## Changing the dataset schema

You can always add new fields to a dataset.

If you want to remove or edit existing fields, you'll first need to empty all collections in the dataset, to ensure that
no existing data points relying on those fields exist. Then, you can freely edit the dataset schema in the console.
