# Importing, Exporting and Cloning Entities

This tutorial will guide you through exporting, importing, and cloning entities in TilliT. We'll use "Edge" entities as an example, but the same process applies to other entity types. **Please note that not all entities are supported at the moment.**

## Exporting an entity

To export an entity, first navigate to the table that lists the entities you're working with. In this example, we're using the Edge entity table. Once there, select the entity you want to export by clicking the checkbox next to its name.

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-1589791c9add29b4fcaaf6d7dd06f060bd7f2a10%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

After selecting, click the dropdown menu and choose the export option.

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-36c35ea77984aeb4675e75396f4d47d4e26bce14%2Fimage.png?alt=media" alt="" width="384"><figcaption></figcaption></figure>

A JSON file containing the entity data will be downloaded automatically—check your browser's downloads list to verify the file is saved.

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-7c7039f08d3f16866e0f7261c589056434e7a2e3%2Fimage.png?alt=media" alt="" width="321"><figcaption></figcaption></figure>

## Importing an entity

To import an entity, stay in the entity table (we’ll continue with the Edge table for this example). Click on the **Import** icon next to the **Create** button.

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-4e0a8f61e9de3f43acdc33e598105e25ab1fe40d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

A modal will open, showing the first step: “Import Edge from a file.” Click on **Select File** and choose the JSON file you downloaded earlier.

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-18f57b6a6ccc55c74a687318b7ab96f662b7ca43%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-d2a05d3f833cad64897ccc334ae86965edb276b0%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

Once selected, the content of the file will be parsed into a table, allowing you to review and validate the data before proceeding.

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-2c3eca56fbb0a77d9330c5f9db91db4d96e4cedf%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

After reviewing, click **Validate Import** to check for any issues with the entities in the file. You can click on individual entities to view their details.

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-eff7184ed29fb585e6eb7758c3cb4c34df844059%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

If everything looks good, click **Apply Import**. Once the import is complete, you’ll see a success message saying "Created!" You can either close the modal or click **Open** to view the newly created entity's basic information panel.

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-c0cf4a7ea17ac647f659697de81fd58eb285eb3e%2Fimage.png?alt=media" alt="" width="392"><figcaption></figcaption></figure>

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-774495eb707a1841da0a083c281f5a9f1cb6918c%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

### Table view vs Detailed view

While validating your import, you can choose between two display options: **Table View** and **Detailed View**. Table View presents the data in a readable, simplified format, while Detailed View displays the raw JSON code, complete with indentation and line numbers for a more technical perspective.

#### Table View

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-fe9a21e1e3b46e63abc5befdcd7ea07ae8e345a3%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

#### Detailed View

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-3f0a6a5d775fafd238e3d2fb37e825cd5a829c64%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

## Cloning an entity

Navigate to the entity table that you want to clone. Click on the drop down button next to **Create** and click on **Clone**.

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-14c244d27e798567a626dddd696fcac642ce6066%2Fimage.png?alt=media" alt="" width="351"><figcaption></figcaption></figure>

After clicking on clone, you can choose whether to do a deep clone or a normal clone. A deep clone will clone all the settings and entities within the clone.

The name will automatically have the word "Clone" appended to it, but you are free to edit it.

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-a34812e13e8e40944a81f54d835970d27507a1d8%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Once ready, click **Create Clone** and you will see the entity populated in the table.

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-e7edd54a4e86994e17ea0281002d9c2797ddc62a%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Note for Edge Data Sources

During the import process, if you receive an error message saying, "Failed to Import the file. Check the entities to create for errors," it’s likely because the Edge Data Source isn’t valid for the production environment. This error is expected.

To resolve it, simply click on the red error message and select a valid Edge Data Source for production. Once the correct source is selected, the error will disappear, and you can continue with the import process.

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-64e13f047243f0c401fb5ba2080cbdc66f23f6b1%2Fimage.png?alt=media" alt="" width="561"><figcaption></figcaption></figure>

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-ece005952abcb5abebbd4b258b115ff7abe80535%2Fimage.png?alt=media" alt="" width="503"><figcaption></figcaption></figure>
