# 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](https://knowledgebase.autorabit.com/product-guides/arm/arm-features/salesforce-dx/create-an-unlocked-managed-package).)

***

### 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="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FlWGWzZTf9ITf9FqeAn4E%2Fimage.png?alt=media&#x26;token=00bd0e99-78c9-4679-abf0-c0f7a7addb92" 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="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FFu1lRYMCxx2vgi1yHe8y%2Fimage.png?alt=media&#x26;token=9ef1bd21-c6a2-4070-89a9-26b0aa4008aa" alt="List of packages and versions"><figcaption></figcaption></figure>
6. **View dependencies** – click **View Dependency Packages** to see related packages.

   <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2Fn6sDFJlWkZFQLoTYda9N%2Fimage.png?alt=media&#x26;token=7432ee1e-432d-4238-9504-4340816393ba" 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="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FtExHdfBhTBFKqn95IXUx%2Fimage.png?alt=media&#x26;token=1c86acc8-dcfe-42ef-86c9-ea2baeac3e78" alt="Save confirmation window" width="559"><figcaption></figcaption></figure>
9. Click **IMPORT** to begin. The **Import Packages Log** opens.

   <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2Fshv1jMWHPNzLLxLKLuri%2Fimage.png?alt=media&#x26;token=e99c0e0e-92cf-491e-92f6-267b470ba8a4" 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="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FT3o1YakK458JtASzcJww%2Fimage.png?alt=media&#x26;token=64053ae6-b5e8-4a2d-a7a7-8fb9eb3cd6c8" 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="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2F4NEG7mJqLyU3aCSQtL4z%2Fimage.png?alt=media&#x26;token=a968d58b-d329-4fbb-afea-f0fdaaec631b" 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="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FzvYVyuxZRq8P684DCmQy%2Fimage.png?alt=media&#x26;token=bc49f42b-5d5c-49af-8e70-a596c820348d" alt="Package Log showing version creation"><figcaption></figcaption></figure>