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

# Import projects

> Import projects from existing Git repositories

Import existing Prophecy projects from external Git repositories into your workspace. This connects your Prophecy project to the repository without creating a copy of the repository.

<Info>
  You can only import projects from external Git providers (GitHub, GitLab, Bitbucket, etc.). Projects stored in Prophecy-managed Git cannot be imported using this method.
</Info>

## Import a project

To import a project from Git:

1. Open **Create Entity** from the left sidebar.

2. Hover over the **Project** tile.

3. Click **Import**.

4. Connect to the Git account that hosts your project repository.

5. Select your repository from the **Repository** dropdown.

   If your repository doesn't appear (common with forked repositories), paste the repository URL directly into the Repository field.

6. Verify the **Default Branch** field auto-populates correctly.

7. Keep the default root path or specify a path to the project folder within the repository.

8. Click **Continue**.

9. Configure your project settings:

   * **Name**: Display name for the project in Prophecy
   * **Description**: Optional context about the project
   * **Team**: The team that will own this project
   * **Project type**: Prophecy automatically sets the language based on the repository content (cannot be changed)
   * **Provider**: Where pipelines will execute

10. Click **Complete**.

## Import vs. clone

Importing a project connects directly to the existing repository without creating a new copy. This means:

* Multiple Prophecy projects can point to the same Git repository
* Changes made in any connected project affect the shared repository
* All projects connected to the same repository will see each other's commits

Use caution when multiple projects share a repository, as changes are not isolated between projects.
