---
title: "Promoting Smart Components"
slug: "promoting-smart-components"
updated: 2026-09-14T16:06:30Z
published: 2026-09-14T16:06:30Z
canonical: "docs.unqork.io/promoting-smart-components"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unqork.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Promoting Smart Components

Promotion copies a Smart Component definition from one environment to another. Use it to move components from a development or lab environment into a higher environment like QA or Production.

> [!WARNING]
> Smart Components cannot be promoted through the Release Management Dashboard. Promotion must be done from the Smart Components Hub.

## Promote a Single Smart Component

To promote one component:

1. Click ![LibraryBig](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/base64-converted-image-1789401962850.png?sv=2026-02-06&spr=https&st=2026-11-10T12%3A00%3A21Z&se=2026-11-10T13%3A00%3A21Z&sr=c&sp=r&sig=yWzWImTmLkyiFjyhG%2ByKSkqnKIkDpkcCRAgAHIWqtIw%3D) **Libraries** in the global header, then select ![Puzzle](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/base64-converted-image-1789401962853.png?sv=2026-02-06&spr=https&st=2026-11-10T12%3A00%3A21Z&se=2026-11-10T13%3A00%3A21Z&sr=c&sp=r&sig=yWzWImTmLkyiFjyhG%2ByKSkqnKIkDpkcCRAgAHIWqtIw%3D) **Smart Components Hub**.
2. Select the ![EllipsisVertical](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/base64-converted-image-1789401962855.png?sv=2026-02-06&spr=https&st=2026-11-10T12%3A00%3A21Z&se=2026-11-10T13%3A00%3A21Z&sr=c&sp=r&sig=yWzWImTmLkyiFjyhG%2ByKSkqnKIkDpkcCRAgAHIWqtIw%3D) (**ellipsis**) on the component's row.
3. Select **Promote**.
4. Select a destination environment and confirm.

The same **Promote** action is also available in the ![EllipsisVertical](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/base64-converted-image-1789401962855.png?sv=2026-02-06&spr=https&st=2026-11-10T12%3A00%3A21Z&se=2026-11-10T13%3A00%3A21Z&sr=c&sp=r&sig=yWzWImTmLkyiFjyhG%2ByKSkqnKIkDpkcCRAgAHIWqtIw%3D) (**ellipsis**) menu of the Smart Component Editor toolbar.

## Promote Multiple Smart Components

To promote several components at once, use the library-wide promotion dialog:

1. Click ![LibraryBig](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/base64-converted-image-1789401962850.png?sv=2026-02-06&spr=https&st=2026-11-10T12%3A00%3A21Z&se=2026-11-10T13%3A00%3A21Z&sr=c&sp=r&sig=yWzWImTmLkyiFjyhG%2ByKSkqnKIkDpkcCRAgAHIWqtIw%3D) **Libraries** in the global header, then select ![Puzzle](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/base64-converted-image-1789401962853.png?sv=2026-02-06&spr=https&st=2026-11-10T12%3A00%3A21Z&se=2026-11-10T13%3A00%3A21Z&sr=c&sp=r&sig=yWzWImTmLkyiFjyhG%2ByKSkqnKIkDpkcCRAgAHIWqtIw%3D) **Smart Components Hub**.
2. Select **Promote** in the Library toolbar.
3. Select a **Destination Environment**.
4. In the **Smart Components to Promote** list, select each component to include. Use **Bulk Actions** to select all at once.
5. Review any dependency warnings. If a selected component depends on another Smart Component that is not included in the selection, that dependency is flagged. Add the missing component to the selection or proceed without it.
6. Select **Promote** in the footer, then confirm in the dialog that follows.

All selected components are promoted as a single bundled job.

## Promotion History

The promotion dialog displays a history of previous promote actions for the library. Each row shows:

| Column | Description |
| --- | --- |
| **Target Environment** | The environment where the promotion was sent. |
| **Status** | The result of the promotion. |
| **Date** | When the promotion ran. |
| **Promoted By** | The Creator who initiated it. |

---

**Changelog**

| Date | Change |
| --- | --- |
| 2026-09-09 | Initial publication (EN-8038). |

Use your QA (quality assurance) environment to test applications to ensure reliability, security, and functionality before releasing them to the end-user.

The Production environment is the final stage of the development process. Use this environment to promote tested and functioning application so your end-user can interact with it.

Also known as Unqork Users, or Designer Users; is anyone who is inside the Unqork platform.