---
title: "Create dataset Attributes"
slug: "create-a-data-source-entity-attribute"
updated: 2024-08-22T10:21:27Z
published: 2024-08-22T10:21:27Z
---

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

# Create dataset Attributes

## Introduction

This article explains how to create dataset Attributes.

🎦 Watch related video:

[Attributes - Part 2: Datasets](/v1/docs/create-attributes-part-2)

### Predefined options

Unlike basic Attributes, dataset Attributes are predefined options that become options in a dropdown field or set of checkboxes. When the customer or agent selects one of the options, that becomes the value of the Attribute.

Dataset Attributes are used for managing data like which prescription plan a customer selects, which items they are purchasing, or what country they are from.

![](https://cdn.document360.io/473bb8c5-ff1b-4930-8109-2321ac6ab967/Images/Documentation/image-1674050372564.png)

### Associated properties

Another feature of dataset Attributes is that each option in a dataset Attributes can be associated with other values or properties, enabling you to collect more comprehensive data. For example, you can build a dropdown Attribute consisting of three subscription plan options. For each option you can associate properties such as the price of the plan and number of licensed users. Then, in addition to the name of the plan, you can also use it's properties to build conditions into your workflow.

![](https://cdn.document360.io/473bb8c5-ff1b-4930-8109-2321ac6ab967/Images/Documentation/image-1674047952066.png)

### Dataset sources

There are three ways to create a dataset source:

- Upload a dataset CSV file to Lightico. See [Create an Attribute from a CSV file](/v1/docs/create-a-data-source-entity-attribute#create-an-attribute-from-a-csv-file).
- Manually when you create the Attribute (does not allow associated properties), See [Create a dataset manually](/v1/docs/create-a-data-source-entity-attribute#create-a-dataset-manually).
- Import from an external source. See [Import a dataset from an external source](/v1/docs/create-a-data-source-entity-attribute#import-a-dataset-from-an-external-source).

## Create an Attribute from a CSV file

### Summary of steps

Creating a dataset Attribute from a CSV file involves the following 3 steps:

1. [Create a dataset CSV file](/v1/docs/create-a-data-source-entity-attribute#create-a-dataset-csv-file)
2. [Upload a dataset](/docs/create-a-data-source-entity-attribute#upload_dataset)
3. [Add a dataset Attribute](/docs/create-a-data-source-entity-attribute#add_attribute)

### Create a dataset CSV file

First you'll need to create a CSV file and save it on your local drive.

**To create a dataset CSV file:**

1. Create a CSV file and name the first column **id**(number or character to identify each option in the system) and the second column **name** (name of the option). The entries in the name column are the names of the values that will appear in the relevant field.

In the following example, we've created a dataset for a dropdown field that will contain 3 options: *standard*, *premium*, and *enterprise*.

![](https://cdn.document360.io/473bb8c5-ff1b-4930-8109-2321ac6ab967/Images/Documentation/dataset_example_no_properties.PNG)
2. If you want to associate different properties with each of the values, add additional columns to the right of the **name** column and add the relevant properties. The column name should be unique and in lowercase. It should not include spaces or special characters other than underscore (_).

In the following example, we've associated 2 properties with each of the values in the name column: the price of each plan (*price*column) and the number of licensed users allowed in each plan (*users*column).

![](https://cdn.document360.io/473bb8c5-ff1b-4930-8109-2321ac6ab967/Images/Documentation/table%20fixed.png)

Note:

Do not include any empty rows in the CSV file.
3. Save the changes to your CSV file.

### Upload a dataset

Once you have [created the dataset](/docs/create-a-data-source-entity-attribute#create_dataset) as a CSV file, you can upload it to the Datasets page.

**To upload a dataset:**

1. In the Lightico Administration page, in the left pane, click **Workflow > Datasets.**

![](https://cdn.document360.io/473bb8c5-ff1b-4930-8109-2321ac6ab967/Images/Documentation/Snag_1018e883.png)

The Datasets page opens.

![](https://cdn.document360.io/473bb8c5-ff1b-4930-8109-2321ac6ab967/Images/Documentation/Snag_10221034.png)
2. In the **Upload New Dataset** box, enter the name of your dataset using the following naming conventions:
  - Unique name between 3 and 50 lower case characters
  - No special characters other than underscore (_)
3. Click **Upload file** and upload the relevant CSV file you created earlier.

![](https://cdn.document360.io/473bb8c5-ff1b-4930-8109-2321ac6ab967/Images/Documentation/Snag_104b182b.png)

The new data set appears in the list of datasets in the right panel with an indication of how many rows are included. For example:

![](https://cdn.document360.io/473bb8c5-ff1b-4930-8109-2321ac6ab967/Images/Documentation/Snag_104ef54e.png)

You can also update the file or export the data using the relevant buttons.

### Add an Attribute from an existing dataset

After you have [uploaded the dataset](/docs/create-a-data-source-entity-attribute#upload_dataset), you can use it to create an Attribute.

**To add a dataset Attribute:**

1. In the Lightico Administration page, in the left pane, click **Attributes mapping**.

The Attributes mapping page opens, displaying the existing Attributes.
2. On the top right corner of the page, click **Add Custom Attribute**.

![](https://cdn.document360.io/473bb8c5-ff1b-4930-8109-2321ac6ab967/Images/Documentation/Snag_1052c1c7.png)

The Add Custom Attribute dialog opens.
3. In the **Entity**field, choose **Data Source**and under Datasets, select**Pick From Existing**.

Note:

To [create a dataset manually](/v1/docs/create-a-data-source-entity-attribute#create-a-dataset-manually) or [import a dataset from an external source](/v1/docs/create-a-data-source-entity-attribute#import-a-dataset-from-an-external-source), see the sections below.
4. From the dropdown, select the dataset you created.

![](https://cdn.document360.io/473bb8c5-ff1b-4930-8109-2321ac6ab967/Images/Documentation/Snag_1155e91a.png)
5. Complete the remaining fields.

| **Field** | **Description** |
| --- | --- |
| Name | The unique name of the Attribute. |
| Description | The description of the Attribute. This is the default label of the field that is visible to the customer in the document wizard. |
| Type | The type of Attribute. Choose from the following types: - Dropdown List - Radio Button Group - Checkbox group |
| Sensitive Data | Define this Attribute as "sensitive". Fields containing sensitive Attribute data can be: - [assigned data deletion rules](https://portal.document360.io/v1/docs/data-deletion) - [masked from the agent](https://portal.document360.io/v1/docs/mask-sensitive-data-in-a-document) |
| Tags | You can assign a tag to the Attribute to categorize the Attributes and to make it easier to search for them. |
6. Click **Save**.

## Create a dataset manually

If you don't need your dataset to be related to associated properties, you can create it manually from the Attribute mapping page without creating a separate dataset CSV file.

**To create a dataset manually:**

1. In the **Add custom Attribute** dialog, under **Entity**select **Data Source**, and under **Datasets**select **Create Manually**.

![](https://cdn.document360.io/473bb8c5-ff1b-4930-8109-2321ac6ab967/Images/Documentation/image-1670860797166.png)
2. Enter the data options in the box as key:value pairs and press ENTER to start a new pair.

![](https://cdn.document360.io/473bb8c5-ff1b-4930-8109-2321ac6ab967/Images/Documentation/Snag_261caa9a.png)
3. Complete all other fields (see [above](/v1/docs/create-a-data-source-entity-attribute#add-an-attribute-from-an-existing-dataset)) and click **Save**.

## Import a dataset from an external source

If you've created a Lightico integration for an external app or data source, you can import the dataset from there.

**To import a dataset from an external source:**

1. In the Add Custom Attribute dialog, under **Entity**select **Data Source**, and under **Datasets**select **Import From Source**. The Add Source button appears.
2. Click the **Add Source** button.

![](https://cdn.document360.io/473bb8c5-ff1b-4930-8109-2321ac6ab967/Images/Documentation/Snag_2622e5b2.png)

The import settings appear.
3. See [Map Salesforce data to Lightico](/v1/docs/mapping-salesforce-data-to-lightico-sessions) for an example of how to complete these settings.

![](https://cdn.document360.io/473bb8c5-ff1b-4930-8109-2321ac6ab967/Images/Documentation/Snag_29a165d2.png)
4. Complete all other fields (see [above](/v1/docs/create-a-data-source-entity-attribute#add-an-attribute-from-an-existing-dataset)) and click **Save**.

## Related

- [Attributes - Part 2: Datasets](/create-attributes-part-2.md)