> For the complete documentation index, see [llms.txt](https://docs.rhinofcp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rhinofcp.com/data-schemas/creating-a-new-data-schema-or-data-schema-version.md).

# Creating a New Data Schema or Data Schema Version

This article explains how to create a new data schema using the Rhino FCP UI.

> NOTE: To learn how to create a new data schema using the Rhino SDK, see [Creating a New Data Schema using the Rhino SDK.](/rhino-sdk/creating-a-new-data-schema-using-the-rhino-sdk.md)

### Opening the Data *Schemas Screen*

{% stepper %}
{% step %}

### Select Data Schemas

Select **Data Schemas** from the main menu. The Data Schemas window opens.

![](/files/77aaf541d57de7e3d24dc6f234a7fdd66d6d4667)
{% endstep %}

{% step %}

### Review existing data schemas

Data schemas that have already been created appear on the screen. The version, date the schema was created, the number of fields in the schema, number of datasets associated with the schema, and the creator of the schema are shown.
{% endstep %}

{% step %}

### Search for a data schema

To search for a data schema, use the text boxes located at the top right corner of the page. To search by name enter the full name or part of the name in the **Search Name** text box. To search by description, enter part of the schema's description in the **Search Description** text box. (The description is what was entered when the schema was created.)
{% endstep %}

{% step %}

### View more details

To see more details about the data schema, select it. The details for the selected data schema is shown.

![](/files/3abeda002dafac0c28d70988994f6679c3211c7a)
{% endstep %}
{% endstepper %}

### Creating New Data Schema

{% stepper %}
{% step %}

### Open the create screen

In the Data Schemas window, select the **Create New Data Schema** button in the upper right hand corner of the screen.

![](/files/86e9b0dfdc4e3db73599a43b3eddf1bde71be37f)

The **Create a New Data Schema** screen opens.

![](/files/d81e4406739659a259a80996b9d0c543d7c9ead8)
{% endstep %}

{% step %}

### Enter schema details

Enter a name for the data schema.

Enter a description. While a description that will help you understand the nature of the Data Schema, this is an optional field.
{% endstep %}

{% step %}

### Choose how to create the schema

Indicate whether you want to create a blank data schema or upload a data schema from a file.

* **If you chose to create a blank data schema:**
  * Select **Create a New Data Schema**. A blank schema appears that you can define and customize.
  * Add fields by selecting the **Add Field** button to the right of the table.
  * If you need to delete a variable (or column) from your data *schema*, click on the circle icon with the X inside ( ![](/files/193bac27125d6b66a1c34b34cc05b947f805cb11)) located at the top of each column.
  * Select the blue cell in the schema field row. Enter the name of the field.
  * Next, enter the unique identifier for the record in the identifier field (if needed)
  * Enter a description, select a type, indicate type parameters (if needed), and units.
  * To add another field, select Add Field button to the right of the table - and repeat these steps again. If there is an issue, an error appears. You’ll need to address it before the schema is created.
  * When complete, click **Save**.

> NOTE: If needed, visit the following links to view additional information on [Data Schema Field Attributes](/data-schemas/data-schema-field-attributes-and-field-permissions.md), [Supported Data Schema Data Types](/data-schemas/supported-data-schema-data-types.md).

* **If you chose to upload a data schema from a file:** Select the file that you want to upload (it should be a CSV file), then click **Open**. Here is an example of a CSV File with a structure that can be uploaded. If you chose to upload a data and are errors, fix the errors and try to upload again.

```plaintext
Variable Name,Age,Test Result A,TEST RESULT B,TEST RESULT C
Identifier,,,,
Description,Age of the patient,Result of test a,Result of test b,Result of test c
Type,Age,Percent,Percent,String
Type Parameters,,,,
Units,INT,Decimal,Decimal,STRING
Contains Sensitive Data?,FALSE,FALSE,FALSE,FALSE
Permissions,Default,Default,Default,Default
Required,TRUE,TRUE,TRUE,FALSE
```

{% endstep %}

{% step %}

### Finish creating the schema

When the schema is created, the schema entry and high-level details appears in the Data Schemas screen. If you want to see the schema fields, click the entry.

![](/files/b4b09c79e714c2cd70f0cdfa95d44e28150cf2ed)
{% endstep %}
{% endstepper %}

### Creating a New Data Schema Version

{% stepper %}
{% step %}

### Open the new version screen

In the Data Schemas screen, select the **New Version** button of the Data Schema that you want to create a new version of.

![](/files/ddc07a7cf0f2e4f50d54588f110998269155a179)

The **Create a New Schema Version** screen appears.

![](/files/3f35cfc5fff53c239036b5737c83ea3943303fd0) ![](https://docs.rhinohealth.com/hc/article_attachments/34843063015197)
{% endstep %}

{% step %}

### Add a description

Add a description (optional).
{% endstep %}

{% step %}

### Choose how to create the version

Choose to **Edit Latest Schema**, **Create Blank Data Schema**, or **Upload from File**.

* If you chose **Edit Latest Schema**, do the following.
  1. Select **Create New Schema Version**.
  2. Edit the schema, then select **Save**.
  3. On the Data Schemas page, a new version appears.
* If you chose create a blank data schema or upload the file, see step 5 of the [Creating New Data Schema topic in this article.](#h_01KF1XB2JG9ZDNCASTB95Z7M1C)
  {% endstep %}
  {% endstepper %}

**Getting Help**

If you have received an error or run into any issues throughout the process, please reach out to <support@rhinohealth.com> for more assistance.