> 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.

![](https://content.gitbook.com/content/ydySyCBmy6F7NnGn4bPa/blobs/InJA12vxuYVvzsHNKr4o/35166489649821)
{% 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.

![](https://content.gitbook.com/content/ydySyCBmy6F7NnGn4bPa/blobs/ml3Cd1wJnNtLw5D7R0eE/33266068257949)
{% 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.

![](https://content.gitbook.com/content/ydySyCBmy6F7NnGn4bPa/blobs/0AG3emkKLCx2lIAqV3ht/33266060517405)

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

![](https://content.gitbook.com/content/ydySyCBmy6F7NnGn4bPa/blobs/TReErk6FrbEQNAEoLyyi/34843063014941)
{% 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 ( ![](https://content.gitbook.com/content/ydySyCBmy6F7NnGn4bPa/blobs/RdctFh1QoyvPlPxBB6Cb/13006459493661)) 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.

![](https://content.gitbook.com/content/ydySyCBmy6F7NnGn4bPa/blobs/vnFPDNKwmyY33XzXs9IV/33266068260509)
{% 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.

![](https://content.gitbook.com/content/ydySyCBmy6F7NnGn4bPa/blobs/OceTw5LHIAOn09GOmaSC/33266060518685)

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

![](https://content.gitbook.com/content/ydySyCBmy6F7NnGn4bPa/blobs/RslJkmDx0Qn5DFwzq5qC/33266060519453) ![](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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.rhinofcp.com/data-schemas/creating-a-new-data-schema-or-data-schema-version.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.