> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognigy.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Packaging
> Export and import project resources, such as flows or lexicons, with packages to share them with other teams.
*Packaging* lets you create *packages* to export and import project resources, such as agents and flows, to share with other teams. With packages, you can transfer resources from one project to another. When you create a package, it automatically includes its direct dependencies for supported resources. After you download a package, you can share it as a ZIP file.
Compared to [snapshots](https://docs.cognigy.com/ai/agents/deploy/snapshots.md), packages give you more control over which resources you import and export.
Packages support the following project resources:
* [Connections](https://docs.cognigy.com/ai/platform-features/connections.md)
* [Copilot configurations](https://docs.cognigy.com/ai/escalate/agent-copilot.md)
* [Endpoints](https://docs.cognigy.com/ai/agents/deploy/endpoints/overview)
* [Flow agents](https://docs.cognigy.com/ai/agents/develop/flow-agents/overview)
* [Flows](https://docs.cognigy.com/ai/agents/develop/projects-and-flows/overview), including nodes and intents
* [Goals](https://docs.cognigy.com/ai/agents/analyze/goals-and-tasks/goals.md)
* [Handover providers](https://docs.cognigy.com/ai/escalate/handovers.md)
* [Knowledge stores](https://docs.cognigy.com/ai/agents/develop/knowledge-ai/knowledge-store.md)[1](#footnote1)
* [Language models](https://docs.cognigy.com/ai/agents/develop/gen-ai-and-llms/llms)
* [Lexicons](https://docs.cognigy.com/ai/platform-features/nlu/slots/user-defined/lexicon.md)
* [NLU connectors](https://docs.cognigy.com/ai/platform-features/nlu/external/nlu-connectors/overview)
* [Playbooks](https://docs.cognigy.com/ai/agents/test/playbooks)
* [Scenarios](https://docs.cognigy.com/ai/agents/test/simulator/scenarios.md)
The Cognigy UI lists new agents as **Agents**, together with their **Personas**, **Tools**, **Skills**, and **MCP servers**. Functions appear in the list but can't be exported yet.
## Limitations
* The maximum package size depends on how you create or upload it:
* **Cognigy UI**: You can create and upload packages of up to 8 GB. For on-premises installations, you can increase this limit by setting the `RESUMABLE_UPLOAD_MAX_FILE_SIZE` environment variable in `values.yaml`. The same limit also applies to [snapshots](https://docs.cognigy.com/ai/agents/deploy/snapshots.md).
* **Cognigy API**: You can create and upload packages of up to 2 GB. Packages that exceed this limit can't be created or uploaded. For on-premises installations, you can increase this limit by setting the `PACKAGE_MAX_FILE_SIZE` environment variable in `values.yaml`.
* [Endpoints](https://docs.cognigy.com/ai/agents/deploy/endpoints/overview) in packages must have a name with up to 180 characters. Endpoints with longer names cause the package export to fail.
* You can't export retired LLMs. You also can't select retired LLMs during the import.
## Restrictions
* Importing packages from a later Cognigy version into an earlier version can cause unexpected errors.
* Cognigy skips unsupported resources while importing a package, for example, deprecated endpoints or LLMs with outdated configuration schemas.
* If you export a package from a project with [extensions](https://docs.cognigy.com/ai/for-developers/extensions.md), you must also install the respective extensions in the target project before importing the package.
## Work with packages
> [tab] GUI
>
> You can export and import packages in **Deploy > Packaging**. You can also export a resource as a package from the respective resource page by selecting  **> Export as package**.
>
> To export a package, do the following:
>
> 1. Go to **Deploy > Packaging**.
> 2. On the **Select resources** step, select the resources to export. To find a resource, use the search field. You can't select all resources while a search filter is active.
> 3. Click **Next**.
> 4. On the **Dependencies** step, review the dependencies required by the selected resources and select the ones to include. Cognigy skips this step if the selected resources have no dependencies.
> 5. Click **Next**.
> 6. On the **Configuration** step, enter a package name. The default name is `Package-`.
> 7. Click **Export**.
> 8. When the package is ready, click **Download package**. To create another package, click **Create another package**.
>
> To import a package, do the following:
>
> 1. Go to **Deploy > Packaging**.
> 2. On the **Select resources** step, click **Import package** and select a ZIP file, or drop the ZIP file anywhere on the page.
> 3. On the **Configuration** step, select the resources to import under **Resources to be imported**. By default, Cognigy selects all resources except retired LLMs.
> 4. If the package contains duplicates of project resources, [resolve the conflicts](#resolve-import-conflicts).
> 5. Review the warnings that appear before the import runs. They report incomplete packages, references that can't be resolved in the project, and resources outside the package that a replacement also changes.
> 6. Depending on whether the package requires [locale mapping](#map-locales-before-importing-flows-and-endpoints), continue as follows:
> * If the package requires locale mapping:
> 1. Click **Next**.
> 2. On the **Locale mapping** step, map the locales and click **Import**.
> * If the package doesn't require locale mapping, click **Import**.
> 7. On the **Done** step, wait until the message **The package import is complete** appears. To start another import or export, click **Start over**.
> [tab] API
>
> You can [view](https://docs.cognigy.com/api-reference/packages/get-packages.md), [create](https://docs.cognigy.com/api-reference/packages/create-a-package.md), and [delete](https://docs.cognigy.com/api-reference/packages/delete-a-package.md) packages using the Cognigy API as well as [download](https://docs.cognigy.com/api-reference/packages/create-a-download-link.md) and [upload](https://docs.cognigy.com/api-reference/packages/upload-a-package.md) them.
> [!NOTE]
>
> * Don't import packages for deploying Knowledge AI resources in a production project. Agents' knowledge may be temporarily unavailable during the import.
> * Node IDs remain unchanged during the import to ensure that hardcoded links between flows and nodes don't break. If you need to import a flow multiple times into a project, delete and recreate the nodes before importing the package to prevent node ID conflicts.
### Map locales before importing flows and endpoints
Locales aren't imported automatically. However, packages that include a flow or endpoint with an assigned locale also include the project's locales. During the import, you can map these package locales to locales in the target project.
Before importing the package, create the required locales in the target project. On the **Locale mapping** step, select a **Project locale** for each **Package locale**. To skip a locale, select **Don't import**.
You must map the project's primary locale to at least one locale of the package. You can map any package locale to the target project's primary locale. If a non-primary package locale has incomplete localized content, Cognigy copies the missing content from the package's primary locale.
When you replace a flow, its localized content from the package overwrites the corresponding content in the target project.
If you don't create the required locale, Cognigy uses the target project's primary locale instead.
### Resolve import conflicts
If the package contains a resource that already exists in your project, you can resolve the conflict in the **Conflict management** section that appears during the import. For each resource that already exists in the project, select one of the following options:
* **Replace existing resource**: Overwrites the version in the project with the version from the package.
* **Import as a copy**: Imports the resource as a new resource and keeps the existing one. Cognigy adds a counter to the name of the copy. For example, if the resource is a duplicate of a flow named `Main`, the new flow is named `Main (2)`. Imported resources that reference the package resource keep that reference. This option is selected by default.
To apply the same option to all resources, select it in **Select how to handle conflicts for all resources** and click **Apply**.
Knowledge stores can't be imported as a copy. Imported knowledge stores replace the current version.
> [accordion] FAQ
>
> **Q1**: What should I do if I encounter errors during knowledge store import?
>
> **A1**: Try to upload the package again. During the reupload, select only the knowledge stores that weren't fully imported.
>
> **Q2**: How can I avoid browser request timeouts during knowledge store package upload?
>
> **A2**: To avoid browser request timeouts, keep the package size low. Separate your resources into smaller packages.
## More information
* [Localization](https://docs.cognigy.com/ai/platform-features/translation-and-localization/localization)
***
When you import a [package](https://docs.cognigy.com/ai/agents/deploy/packages.md) with knowledge stores, the source and target projects must use the same embedding model. If they use different embedding models, recreate the [knowledge sources](https://docs.cognigy.com/ai/agents/develop/knowledge-ai/knowledge-source/overview) to generate new embeddings with the target project's model.