---
title: "Creation"
slug: "creation"
abstract: "How to add a component that lets users create entities."
---
# Creation

The **Creation** component allows users to create entities. There must be a **Search** component available on the page because these two components work together. For the **Creation** button to be visible on the page, you must turn on at least one of the creation switches. When you enable several creation options, the **Creation** button displays as a list.

> [!note]
> The **Link Items** and **Paste from clipboard** options are only available for details pages. For additional information on Excel imports, see [Excel import configuration](https://doc.sitecore.com/ch/en/users/content-hub/export-excel-data.html "Export Excel data").

> [!tip]
> You can create multiple values for an entity field using a pipe **|** to separate the values. For additional information, see [Import users example](https://doc.sitecore.com/ch/en/users/content-hub/edit-excel-data.html "Edit Excel data").

To add a **Creation** component:

1. On the menu bar, click **Manage** :mdiCogOutline:.
2. On the **Manage** page, click **Pages**.
3. On the **Pages** page, select the page you want to modify.
4. On the **Layout** tab, [add the page component](https://doc.sitecore.com/ch/en/users/content-hub/add,-modify,-or-delete-page-components.md "Add, modify, or delete page components").
5. Click the component to open its details page and modify the settings on the following tabs, and then click **Save**.

::::tabs
:::tab{title="General"}

| Field | Type | Description | Value | Mandatory |
| --- | --- | --- | --- | --- |
| **Label type** | List | Button type. | *Default/Custom* | Yes |
| **Label** | String | Sets the **Custom** button label. | Label of the button. | No |
| **Refresh page entity** | Toggle switch | If enabled, refreshes the page upon an entity creation. | *Enabled/Disabled* | No |
| **Button style** | List | Visual aspect of the **Creation** button. | *Primary / Secondary / Default / Link* | Yes |
| **Roles** | Selection list | The component is only visible to users with at least one of the selected roles. Only available for detail pages. | All roles defined in your solution. | No |

:::
:::tab{title="Upload"}

| Field | Description | Value |
| --- | --- | --- |
| **Ignore permissions** | Ignores the default security check that only displays the component if a user or user group has the required permissions to files. | *Enabled/Disabled* |
| **Label type** | Button type. | *Default/Custom* |
| **Label** | Sets the **Custom** button label. | Label of the button |
| **Repository** | Defines the new created files repository. | *Standard(default) / Avatar / Chili / Content / DRM / Import / KPI / Packages / Portal / Print / Processing / Product / Project / Subtitle / Template* |
| **Life cycle** | Defines the uploaded files status. | *Created(default) / Approved / Archived / Rejected / UnderReview* |
| **Media processing flow** | Defines the media processing flow used to process the uploaded files. | *Portal / Print / Project / Vision / Chili* |
| **Allowed extensions** | Limits the accepted file types. | *Only* + accepted extensions / *All except* + rejected extensions. The extensions must not begin with a dot. For example, **png jpg svg**, not **.png .jpg .svg**. |
| **Life cycle relation** | Defines the lifecycle flow. | All available lifecycle flows defined in your solution. *Final lifecycle status* is the default value. |
| **Life cycle status property** | Sets the lifecycle status property. | Available values vary with the *Lifecycle relation*. |
| **Default values** | Sets default values of the newly created file. | All asset relations and file properties defined in your solution. |

:::
:::tab{title="New"}

> [!note]
> If there are multiple entity definitions available, you need to select the correct definition when creating a new entity.

| Field | Description | Value |
| --- | --- | --- |
| **Ignore permissions** | Ignores the default security check that only displays the component if a user or user group has the permission to create the desired entity. | *Enabled/Disabled* |
| **Label type** | Button | *Default/Custom* |
| **Label** | Sets the **Custom** button label. | Label of the button. |
| **Detail page** | Defines the detail page to which the newly created entities are linked. | Available detail pages in your solution. |
| **Window type** | Sets the window type. | *Small modal / Medium modal / Large modal / Extra large modal / Drawer* |
| **Has fixed modal width** | Sets the modal to its maximum size regardless of its content. | *Enabled/Disabled* |
| **Use the detail page title as the modal title** | Names the modal after the defined detail page title. | *Enabled/Disabled* |
| **Redirect page** | Defines a detail page to which the newly created entities will be redirected if required. | Available detail pages in your solution. |
| **Default values** | Sets default values linked to the newly created file. | All asset relations and file properties defined in your solution. |

:::
:::tab{title="Link"}

> [!note]
> At least one *NESTED* **Search** component needs to be created on the page to use the **Link items** option of the **Creation** component.

| Field | Description | Value |
| --- | --- | --- |
| **Label type** | Button type. | *Default/Custom* |
| **Label** | Sets the *Custom* button label. | Label of the button. |
| **Search component** | Links the **Search** component to be used. | *Nested* **Search** components available on the page. |
| **Relation** | Specifies the entity definitions that are allowed to be added using the **Link items** option. | Available entities in your solution. |

:::
:::tab{title="Paste"}

| Field | Description | Value |
| --- | --- | --- |
| **Label type** | Button type. | *Default/Custom* |
| **Label** | Sets the *Custom* button label. | Label of the button. |
| **Relation** | Specifies the relations authorized to use the **Paste from clipboard** option. | Available relations in your solution. |

:::
:::tab{title="Import"}

Excel files are used to create or update entities.

| Field | Description | Value |
| --- | --- | --- |
| **Label type** | Button type. | *Default/Custom* |
| **Label** | *Custom* button label. | Label of the button |
| **Enable migration mode** | Enables migration between Sitecore Content Hub versions through an Excel import, in order to persist timestamps and content creator information. This mode lets you update the *Created by*, *Modified by* , *Created on*, and *Modified on* system properties.<br><br>For *Created by* and *Modified by*, you must provide a *username* value.<br><br>For *Created on* and *Modified on*, you must provide a date value in one of the following formats:<br><br><ul><li>`2018-10-04T10:`13:25`.8881042Z`</li><li>`2020-10-16 `10:27`:40 AM GMT+02:00`</li></ul><br><br>The format of the Excel spreadsheet is as follows:<br><br>![migration-mode-excel.png](https://doc.sitecore.com/api/markdown-image/ch/en/users/content-hub/images/migration-mode-excel.png)<br><br>> [!important]<br>> These properties can only be set during entity creation. You can update only the properties you are interested in and do not need to override all properties. | *Enabled/Disabled* |
| **Add definition** | Specifies default values for uploaded entities. | Available entities in your Sitecore Content Hub solution. |

:::
::::

## Format

In the following example, the **Import Excel** option is set to import *M.Assets* entities with the **DEFAULT VALUES** of:

- **Area of Origin** set to *EMEA*.
- **Description** set to *Added through Excel Import*.

If you import the following Excel workbook, **Area of Origin** and **Description** are updated with default values because they are not included in the worksheet. This means that the **Area of Origin** for the asset is updated from *North American* to *EMEA*.

| identifier | Title | FileName | FinalLifeCycleStatusToAsset | ContentRepositoryToAsset |
| --- | --- | --- | --- | --- |
| nl6bV-87dkKwkD63FUp03A | bundo-kim-558517.jpg | bundo-kim-558517.jpg | M.Final.LifeCycle.Status.Approved | M.Content.Repository.Standard |