# Import an Unlocked/Managed Package

Learn how to bring an existing unlocked or managed package into AutoRABIT for further management.\
(Need a refresher on packages? See [Create an Unlocked/Managed Package](/product-guides/arm/arm-features/salesforce-dx/create-an-unlocked-managed-package.md).)

### Step 1: Import a Package <a href="#step-1-importing-a-package" id="step-1-importing-a-package"></a>

1. **Open Packages**\
   Hover over **Salesforce DX** and select **Packages**.
2. **Click Import Package**

   <figure><img src="/files/1WLtlxjCEeY4evISz9Vv" alt="Import Package button"><figcaption></figcaption></figure>
3. Choose the **Repository** and **Branch** that contain the package manifest.
4. All available **packages** and **package versions** in that branch appear.
5. Select the packages you want to import.

   <figure><img src="/files/iWbdxJkomeS5ZDlydOcJ" alt="List of packages and versions"><figcaption></figcaption></figure>
6. **View dependencies** – click **View Dependency Packages** to see related packages.

   <figure><img src="/files/PKMd0WrgehVqOUjHxHmi" alt="Dependency Packages dialog"><figcaption></figcaption></figure>
7. **Validate** – pick the **Dev Hub** and click **Validate Package**. A green tick confirms a match.
8. Click **Save** to review the summary.

   <figure><img src="/files/BhAfJvMswxWm3Q97QDwn" alt="Save confirmation window" width="559"><figcaption></figcaption></figure>
9. Click **Import** to begin. The **Import Packages Log** opens.

   <figure><img src="/files/oAglwBmKGqTvzFb42LtD" alt="Import Packages Log dialog" width="496"><figcaption></figcaption></figure>
10. Click **Close**. You return to the **Packages** home page, where the newly imported package appears.

    <figure><img src="/files/Z6PxJnK7m66EtkAJ11hV" alt="Packages home showing imported package"><figcaption></figcaption></figure>

{% hint style="info" %}
**Note:** You can import multiple packages with the same name if they come from different repositories or branches.
{% endhint %}

***

### Step 2: Create a Package Version <a href="#step-2-create-a-package-version" id="step-2-create-a-package-version"></a>

#### What Is a Package Version? <a href="#what-is-a-package-version" id="what-is-a-package-version"></a>

A **package version** is an immutable snapshot of metadata. You can install it in any org (scratch, sandbox, production) to deploy that exact set of components.

1. Click the **+** icon in the **Actions** column to add a version.

   <figure><img src="/files/qtwi7Ik6NTPar1lqtX43" alt="Create Package Version plus icon"><figcaption></figcaption></figure>
2. Fill in the details:
   * **Version Name** – auto-filled from the package name; editable.
   * **Version Number** – format `major.minor.patch.build` (e.g., `1.2.1.8`).
   * **Installation Key** – optional password to restrict installs.
   * **Tag** – release label (e.g., `Release 1.0.0`).
   * **Version Description** – brief notes.
3. Click **Create**.
4. Watch progress on the **Package Log** screen.

   <figure><img src="/files/wPx4QvO6ZeTT01oQXgrg" alt="Package Log showing version creation"><figcaption></figcaption></figure>


---

# Agent Instructions: 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://knowledgebase.autorabit.com/product-guides/arm-1/arm-features/salesforce-dx/import-an-unlocked-managed-package.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.