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

# Adding records

> Add a record to a data type one at a time.

> [!NOTE]
>
> Required permission:
>
> * View data source
> * Create data

To add many records at once, see [Bulk add and edit](https://docsy3.mile.app/pages/workflow/data-source/bulk-add-and-edit.md).

## Add a record

1. Open **Data Source** and pick the data type in the list beside the records.
2. Click **New**. The **New \<data type>** dialog opens, for example **New Customer**.

   If the data type already holds as many records as your plan allows, **New** opens an **Upgrade plan** dialog instead, for example *You have reached your limit of 100 data for this data type on the Free plan.* Click **Upgrade to** a higher plan to change it.

![New Customer dialog](https://mintcdn.com/mile-app/JlYib2YfcGFk65pR/images/v4/workflow/data/data-source-new-record.png?fit=max\&auto=format\&n=JlYib2YfcGFk65pR\&q=85\&s=32cdbd8fe565d7646fb51384c3cbd06b)

3. Fill in the fields. The form has one input for each field of the data type, in the order set on the data type:
   * Fields marked **\*** are required. The first one is the **Title**, the code that identifies the record. It can hold letters, numbers, `-`, `_`, and single spaces between words (a data type that still works in the older version takes no spaces). A space typed at the start or end is removed when you save.
   * **Coordinate** takes a latitude and longitude, such as `-6.2088,106.8456`. Click the pin to pick the point on a map.
   * **Option** and **Multi option** fields open a list of their choices.
   * **Relation** fields open a list of records to link. See [Linked records](https://docsy3.mile.app/pages/workflow/data-source/linked-records.md).
   * The data type's rules apply: a number between its minimum and maximum, a phone number of 10 to 16 digits, and so on.
4. **Also create in**: shown only for data types with **Scope Data by Hub** on. The record is added to the hub you are working in. To add it to other hubs too, pick them here. Each hub gets a separate copy, and each copy is edited on its own.

![New Customer with Also create in](https://mintcdn.com/mile-app/JlYib2YfcGFk65pR/images/v4/workflow/data/data-source-also-create-in.png?fit=max\&auto=format\&n=JlYib2YfcGFk65pR\&q=85\&s=1aa6a9bd6fbe34b883cbcd30f240b9a8)

*Also create in adds a separate copy of the record in each hub you pick.*

5. Click **Save**. The web app says *Record created* and the record appears in the list.

If two records would share the same Title, or break a [unique together](https://docsy3.mile.app/pages/workflow/data-type/creating-a-data-type.md#unique-together) combination, the record isn't saved and the web app tells you which value is already used.

## Scope records by user

When the data type has **Scope Data by User** on, the dialog also has a **Scope Data by User** section.

![Scope Data by User](https://mintcdn.com/mile-app/JlYib2YfcGFk65pR/images/v4/workflow/data/data-source-limit-user.png?fit=max\&auto=format\&n=JlYib2YfcGFk65pR\&q=85\&s=577557ec4162de055dedd8252e0d829c)

1. **Choose users**: leave it empty and every user can see the record. Pick users to scope the record to them. Teams appear in the list too, with their member count, for example *Sales (4)*, to pick all their members in one click.

A field worker sees a scoped record only if they are one of the chosen users, both on the web app and when they fill a task from this data type.

## Use the records in tasks

Once the records exist, a flow can fill its fields from them. On the web app, a field set up this way shows a search icon: search for a record, pick it, and the mapped fields fill in. In bulk task input, typing or importing a record's Title fills the other fields in the same way. See [Flow Configuration › Data source](https://docsy3.mile.app/pages/workflow/flow/configuration.md#data-source).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.