> ## 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.

# External release tags

> Use external release tags for deployment and dependency in Prophecy

<Callout icon="/images/icon.png" color="#FFC107">
  Available for [Enterprise Edition](/data-engineering/administration/platform/editions) only.
</Callout>

If you use external CI-CD tools to merge and release your projects, you can use [release tags](https://git-scm.com/book/en/v2/Git-Basics-Tagging) from those tools within Prophecy for deployment and dependencies.

Once you've deployed an external tag in Prophecy, you can add that release as a dependency in a project.

## View external release tags

Any externally created release tag that you pull into Prophecy is visible on the **Releases & Deployments** tab of your project metadata.

<img src="https://mintcdn.com/prophecy-62973bd0/6yiaaii50cGrpbpw/data-engineering/ci-cd/deployment/img/external_release_tag_list.png?fit=max&auto=format&n=6yiaaii50cGrpbpw&q=85&s=0be56f80cb297e06276d21a8aa9adf8f" alt="External_tags_list" width="2880" height="1726" data-path="data-engineering/ci-cd/deployment/img/external_release_tag_list.png" />

Tags that are created externally are labeled with an **(1) External** tag. If your latest tags aren't showing, click on the **(2) Refresh** button to refresh the list of tags.

## Deploy an external release tag

To deploy an existing tag, follow these steps:

1. From `...` in the top right corner, select **(1) Deploy**. This opens the Deploy dialog.

   <img src="https://mintcdn.com/prophecy-62973bd0/6yiaaii50cGrpbpw/data-engineering/ci-cd/deployment/img/external_release_tag_deploy.png?fit=max&auto=format&n=6yiaaii50cGrpbpw&q=85&s=a61dd377f119a1b95adf7ab54b5694cf" alt="Deploy button" width="2880" height="1726" data-path="data-engineering/ci-cd/deployment/img/external_release_tag_deploy.png" />

2. Select a release version you wish to deploy by using the **(1) Choose a release** dropdown. Once you select a version, the table below shows the jobs that are going to be modified (there might not be any jobs). Click **(2) Deploy** to start the deployment.

   <img src="https://mintcdn.com/prophecy-62973bd0/6yiaaii50cGrpbpw/data-engineering/ci-cd/deployment/img/external_release_tag_deploy_start.png?fit=max&auto=format&n=6yiaaii50cGrpbpw&q=85&s=c628bf9726433a29870dc26596309f27" alt="Deploy start" width="2880" height="1726" data-path="data-engineering/ci-cd/deployment/img/external_release_tag_deploy_start.png" />

   <Info>
     If you have enabled [Selective Job Deployment](./deployment#deployment-modes), then you can pick the jobs you wish to deploy. Additionally, you have the option to override the fabrics for these jobs. Job selection **is not required** to deploy the release.
   </Info>

This deploys a new release. You can access deployment logs from the Deployment History tab.

## Use the release as a dependency

Once you've deployed a tag, you can use the release as a dependency in a project.

First, navigate to the **(1) Dependencies** tab of the relevant project and click **(2) + Add Dependency**.

<img src="https://mintcdn.com/prophecy-62973bd0/6yiaaii50cGrpbpw/data-engineering/ci-cd/deployment/img/external_release_tag_dependency.png?fit=max&auto=format&n=6yiaaii50cGrpbpw&q=85&s=135d94caffb1661b2f45a4e3582f70e1" alt="Add dependency" width="2880" height="1726" data-path="data-engineering/ci-cd/deployment/img/external_release_tag_dependency.png" />

Next, in the **Create Dependency** dialog:

1. For **Type**, select **Package Hub Dependency**.
2. For **Name**, choose the project that contains the external release tag.
3. For **Version**, select the option that matches your external release tag.
4. Click **Create Dependency**.

<img src="https://mintcdn.com/prophecy-62973bd0/6yiaaii50cGrpbpw/data-engineering/ci-cd/deployment/img/external_release_tag_create_dependency.png?fit=max&auto=format&n=6yiaaii50cGrpbpw&q=85&s=bc54fcbc3bce4f0c4ff040238e554967" alt="Add another dependency" width="2880" height="1726" data-path="data-engineering/ci-cd/deployment/img/external_release_tag_create_dependency.png" />

You can also edit a dependency and update its version to an externally released version.

## FAQ

**How does Prophecy support tags from a repo that is linked to multiple Prophecy projects?**

A Git tag is a pointer to a specific commit in the repo. It's not linked to a subfolder in the repo. So in this case, if you create a tag, it would be available for all projects linked to the repo.

**Do the tags have to follow a certain pattern to be recognized?**

No. Prophecy supports all tag patterns supported in Git. Prophecy automatically recognizes external tags after you visit the Release and Deployment page or refresh the page.