> For the complete documentation index, see [llms.txt](https://developer.kizen.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.kizen.com/docs/concepts/smartconnectors/smartconnector-export-import-and-duplication.md).

# SmartConnector Export, Import, and Duplication

{% hint style="success" %}
**Audience:** Administrators, Developers, Integrators, Solution Architects

**Purpose:** Explains how to export, import, and duplicate <code class="expression">space.vars.smartconnectors</code>, what each action includes, and why imported and duplicated <code class="expression">space.vars.smartconnectors</code> must be reviewed before activation.
{% endhint %}

## Overview

There are three ways to move or copy a <code class="expression">space.vars.smartconnector</code>: export, import, and duplication. Use export and import together to either move a <code class="expression">space.vars.smartconnector</code> across environments, or share with another business. Use duplication to make a copy of a <code class="expression">space.vars.smartconnector</code> within the same business, usually when you want to modify it before activating it.&#x20;

Each mechanism includes a different set of <code class="expression">space.vars.smartconnector</code> configuration, and each has specific behaviors that affect what you need to review before the new or copied <code class="expression">space.vars.smartconnector</code> can process data.

***

## Export

Exporting a <code class="expression">space.vars.smartconnector</code> packages its configuration into a downloadable file that can be imported into another business.

An export includes:

* The <code class="expression">space.vars.smartconnector</code> name
* The Live SQL script
* The reference data file

{% hint style="warning" %}
**Caution:** The Sample File is packaged inside the exported file and will be accessible to anyone who receives it. Before exporting a <code class="expression">space.vars.smartconnector</code> that will be shared outside your business, review the Sample File and remove any sensitive or business-specific data.
{% endhint %}

***

## Import

Importing a <code class="expression">space.vars.smartconnector</code> creates it in the target business from an exported package. The <code class="expression">space.vars.smartconnector</code> is created as-is. You cannot edit it during import, so make any changes after it is created.

#### **What is created**

The exported package contains only the Live SQL script. On import, it becomes the new Live script, and a Draft script is created from it.

If a <code class="expression">space.vars.smartconnector</code> with the same name already exists in the target business, the import is skipped. Delete or rename the existing one first if you need to re-import.

#### **What happens during import**

After the <code class="expression">space.vars.smartconnector</code> is created, pre-activation checks run automatically. There are three possible outcomes:

* **All checks pass:** The status is set to **Operational.**
* **Warnings are detected:** The import succeeds, but some references need manual review. The status is set to **Operational (Needs Attention**), and the warnings are listed in the import confirmation email. There is no in-app warning indicator, so check the email before activating.
* **Other errors are detected:** The import fails.

Warnings apply to these reference types:

* <code class="expression">space.vars.automation</code> references
* Filter group for seeding
* Matching or mapping field references

#### **What to do after import**

The active toggle is always off on import, so a newly imported <code class="expression">space.vars.smartconnector</code> will not process data until you turn it on. Before activating:

1. Review the import confirmation email.
2. Open the <code class="expression">space.vars.smartconnector</code> and confirm that the flagged references resolve correctly.
3. Verify the configuration matches what you expect.
4. Turn on the active toggle.

{% hint style="warning" %}
**Caution:** The **Operational (Needs Attention)** status tracks the most recent live run, not whether import warnings were resolved. If you run the <code class="expression">space.vars.smartconnector</code> before fixing the warnings and the run succeeds, the status changes to Operational even though the warnings still exist. Always resolve warnings from the import email before relying on status.
{% endhint %}

***

## Duplication

Duplicating a <code class="expression">space.vars.smartconnector</code> creates a copy within the same business. Duplication is intended for users who have edit permissions on the original <code class="expression">space.vars.smartconnector</code> and plan to modify the copy before activating it.

A duplicated <code class="expression">space.vars.smartconnector</code>r includes:

* All configuration from the original
* Both the Live SQL script and the Draft SQL script
* The Sample File
* <code class="expression">space.vars.automation</code> references

The following are updated on the duplicate:

* Name
* API name
* Owner: set to the user who performed the duplication

The key difference between duplication and import is scope. Duplication includes both the Live and Draft SQL scripts and is designed for a user who will continue editing the <code class="expression">space.vars.smartconnector</code> before going live. Import includes only the Live SQL and regenerates the draft, because the imported <code class="expression">space.vars.smartconnector</code> is expected to be reviewed and activated rather than edited further.

{% hint style="warning" %}
**Caution:** The active toggle is always disabled on the duplicated <code class="expression">space.vars.smartconnector</code>**.** Review the duplicate, make any required changes, and activate it manually when you are ready for it to process data.
{% endhint %}

***

## What's Next

Continue to [SmartConnector Data Model](/docs/concepts/smartconnectors/smartconnector-data-model.md) to learn how <code class="expression">space.vars.smartconnectors</code>, executions, and output are represented as data model entities within the platform.&#x20;

<details>

<summary>Related Topics</summary>

* SmartConnector Permissions **(Topic Coming Soon)**
* [SmartConnector Data Model](/docs/concepts/smartconnectors/smartconnector-data-model.md)
* [Running a SmartConnector](/docs/concepts/smartconnectors/running-a-smartconnector.md)

</details>


---

# 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:

```
GET https://developer.kizen.com/docs/concepts/smartconnectors/smartconnector-export-import-and-duplication.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.