> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/internal-developer-portal/new-to-idp/get-started/step-2-set-up-software-catalog-get-started/import-from-git-step-2-set-up-software-catalog-get-started.md).

# Import from Git

{% @harness-package-selector/package-selector platforms="%5B%7B%22label%22%3A%22Create%20Manually%22%2C%22slug%22%3A%22create-manually%22%2C%22path%22%3A%22internal-developer-portal%2Fnew-to-idp%2Fget-started%2Fstep-2-set-up-software-catalog-get-started%2Fcreate-manually-step-2-set-up-software-catalog-get-started%22%7D%2C%7B%22label%22%3A%22Auto-Discovery%22%2C%22slug%22%3A%22auto-discovery%22%2C%22path%22%3A%22internal-developer-portal%2Fnew-to-idp%2Fget-started%2Fstep-2-set-up-software-catalog-get-started%2Fauto-discovery-step-2-set-up-software-catalog-get-started%22%7D%2C%7B%22label%22%3A%22Import%20from%20Git%22%2C%22slug%22%3A%22import-from-git%22%2C%22path%22%3A%22internal-developer-portal%2Fnew-to-idp%2Fget-started%2Fstep-2-set-up-software-catalog-get-started%2Fimport-from-git-step-2-set-up-software-catalog-get-started%22%7D%5D" selectedPlatform="import-from-git" %}

### Import entities from Git <a href="#import-entities-from-git" id="import-entities-from-git"></a>

In Harness IDP, you can create new entities by importing their YAML definitions stored in Git repositories directly into Harness IDP. This feature allows teams to reuse pre-defined configurations, onboard services faster, and migrate from existing repositories.

***

#### Before you begin <a href="#before-you-begin" id="before-you-begin"></a>

Before you begin, ensure:

* You have a Git connector configured in Harness IDP (Harness Code Repository, GitHub, GitLab, Bitbucket, or Azure Repos) to import your entity YAMLs. Go to [Configure Git Connector](/harness-ai/use-harness-platform/connectors/code-repositories/connect-to-code-repo.md) to learn more.
* **API Access is enabled** for your Git connector (required for Harness Git Experience). For connection types where API access is not enabled by default, you must enable it from the Git connector settings. Go to [enable API access](/harness-ai/use-harness-platform/connectors/code-repositories/ref-source-repo-provider/git-hub-connector-settings-reference.md#enable-api-access).

***

#### Import an entity from Git <a href="#import-an-entity-from-git" id="import-an-entity-from-git"></a>

To learn more about entity scope rules, connector constraints, and advanced import options, go to [Import Entity in Harness IDP](/internal-developer-portal/use-idp/software-catalog/create-entity/import-from-git.md).

{% tabs %}
{% tab title="Interactive Guide" %}
{% embed url="<https://app.arcade.software/share/hr0isGxULM2WMhGiMJnJ>" %}
Import Workflow from Git
{% endembed %}
{% endtab %}

{% tab title="Step-by-Step" %}
**Step 1: Navigate to import**

1. Go to **Harness IDP** → **Create**
2. At the bottom of the page, find the option to create a new entity by importing YAML from Git.
3. Click on **Import from Git**

**Step 2: Select entity scope**

1. Select the **Entity Scope** (Account, Organization, or Project level)
2. The scope you select determines where your entity will be created.

{% hint style="warning" %}
**IMPORTANT**

Make sure your imported YAML includes the appropriate scope identifiers (`projectIdentifier` and `orgIdentifier`), otherwise, it will result in an error.
{% endhint %}

**Step 3: Choose Git provider**

Select your Git provider type:

**Option A: Harness Code Repository**

If using Harness Code Repository, provide the following details:

* **Repository**: Git repository where your entity YAML is stored
* **Git Branch**: Branch of your repository where your entity YAML is stored
* **YAML Path**: Path to your YAML file

**Option B: Third-Party Provider**

If using a third-party Git provider (GitHub, GitLab, Bitbucket, Azure Repos), provide:

* **Git Connector**: Git connector configured in your Harness IDP
* **Repository**: Git repository where your entity YAML is stored
* **Git Branch**: Branch of your repository where your entity YAML is stored
* **YAML Path**: Path to your YAML file

**Step 4: Import the entity**

1. Review the details you have entered.
2. Click **Import**
3. The entity will be created in your IDP directly from the YAML file stored in Git
   {% endtab %}
   {% endtabs %}

{% @harness-feedback/feedback %}