> 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/harness-platform/use-harness-platform/triggers/triggers-overview.md).

# Triggers overview

Harness uses triggers to automate and streamline deployment workflows. A trigger starts a pipeline execution in response to an event, such as a new artifact or manifest, an external webhook, or a schedule. Triggers give you a versatile, event-driven way to initiate pipelines based on specific events, changes, or conditions.

***

### What you will learn in this topic <a href="#what-you-will-learn-in-this-topic" id="what-you-will-learn-in-this-topic"></a>

By the end of this topic, you will be able to:

* Identify the [four trigger types](#types-of-triggers) available in Harness and when to use each.
* [Add a trigger](#add-a-trigger-to-a-pipeline) to a pipeline.
* [View trigger events](#view-trigger-events) for the triggers in a pipeline.

***

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

Before you create a trigger, ensure you have the following:

* **Harness pipeline**: An existing pipeline to attach the trigger to. Go to [Triggers](/harness-platform/use-harness-platform/triggers.md) for more information on trigger setup.
* **Pipeline access**: [Permissions](/harness-platform/use-harness-platform/platform-access-control/add-manage-roles.md#manage-roles-in-harness) to create and edit triggers on the pipeline.
* **Event source access**: Access to the Git repository, artifact registry, or Helm repository that the trigger listens to.

***

### Types of triggers <a href="#types-of-triggers" id="types-of-triggers"></a>

Harness supports four trigger types. Select the one that fits your use case:

* **Webhook**: Trigger Harness pipelines in response to Git events that match specific payload conditions you set up in a Harness trigger. Go to [Trigger pipelines using Git events](/harness-platform/use-harness-platform/triggers/triggering-pipelines.md) to configure Git event triggers.
  * Trigger Harness pipelines in response to specific Slack events. Go to [Trigger pipelines using Slack events](/harness-platform/use-harness-platform/triggers/trigger-pipelines-using-slack-events.md) for more information on Slack event triggers.
  * Trigger Harness pipelines in response to events from third-party artifact repositories that match specific payload conditions. Go to [Trigger pipelines using Generic events](/harness-platform/use-harness-platform/triggers/trigger-pipelines-using-generic-events.md) for more information on generic event triggers.
* **Artifact**: Trigger Harness pipelines in response to a new artifact version being added to a registry. Go to [Trigger pipelines on a new artifact](/harness-platform/use-harness-platform/triggers/trigger-on-a-new-artifact.md) for more information on artifact triggers.
* **Manifest**: Trigger Harness pipelines in response to a new Helm chart version being added to an HTTP Helm repository. Go to [Trigger pipelines on new Helm chart](/harness-platform/use-harness-platform/triggers/trigger-pipelines-on-new-helm-chart.md) for more information on manifest triggers.
* **Scheduled**: Schedule Harness pipeline executions using Cron-based triggers. Go to [Schedule pipelines using triggers](/harness-platform/use-harness-platform/triggers/schedule-pipelines-using-cron-triggers.md) for more information on scheduled triggers.

***

#### Webhook triggers <a href="#webhook-triggers" id="webhook-triggers"></a>

Use a webhook trigger to run a pipeline in response to Git events that match specific payload conditions you set up in a Harness trigger. For example, when a pull request or push event occurs on a Git repo and your trigger settings match the payload conditions, a CI or CD pipeline runs.

Webhook triggers enable event-driven CI/CD and support the practice of every commit building or deploying to a target environment. Role-based access control (RBAC) does not apply to webhook triggers, because the events occur on the repository side.

Harness supports the following source control management (SCM) providers:

* Artifact Registry
* Azure Repos
* Bitbucket
* Custom
* Event Relay
* GitHub
* GitLab
* Harness

***

#### Artifact triggers <a href="#artifact-triggers" id="artifact-triggers"></a>

Use an artifact trigger to run a pipeline automatically when a new version of an artifact is added to a registry. For example, when a new Docker image is uploaded to your Docker Hub account, it can trigger a CD pipeline that automatically deploys the image.

{% hint style="info" %}
Currently, this feature is behind the feature flag `CD_TRIGGERS_REFACTOR`. Contact [Harness Support](mailto:support@harness.io) to enable it.
{% endhint %}

**Supported artifact providers for artifact triggers**

You can use the following artifact providers to trigger pipelines:

* [Harness Artifact Registry](/artifact-registry/use-artifact-registry/manage-registries/ar-webhooks.md)
* ACR (Azure Container Registry)
* Amazon Machine Image (AMI)
* Amazon S3
* Artifactory
* Azure Artifacts
* Bamboo
* Custom
* Docker Registry
* ECR (Amazon Elastic Container Registry)
* GCE Image (Google Compute Engine Image)
* GCR (Google Container Registry)
* GitHub Package Registry
* Google Artifact Registry
* Google Cloud Storage
* Jenkins
* Nexus2
* Nexus3

Google Container Registry (GCR) is deprecated and was shut down on March 18, 2025. Migrate to Google Artifact Registry (GAR) instead. Go to [Google's official transition documentation](https://cloud.google.com/artifact-registry/docs/transition/transition-from-gcr) to review the migration path, and go to the [Harness GCR documentation](/continuous-delivery/use-continuous-delivery/cd-building-blocks/services/artifact-sources.md#google-container-registry-gcr) to review GCR support in Harness.

***

#### Manifest triggers <a href="#manifest-triggers" id="manifest-triggers"></a>

Use a manifest trigger to automate deployments when a new Helm chart version is published. Helm chart triggers listen to the repo where one or more of the Helm charts in your pipeline are hosted. You can set conditions on the triggers, such as matching one or more chart versions.

***

#### Scheduled triggers <a href="#scheduled-triggers" id="scheduled-triggers"></a>

Use a scheduled trigger to run pipelines at fixed times without a source event. With scheduled triggers, you automate pipeline executions by setting up Cron-based triggers to run pipelines at specific times and intervals, which makes your workflow more efficient and reliable.

***

### Add a trigger to a pipeline <a href="#add-a-trigger-to-a-pipeline" id="add-a-trigger-to-a-pipeline"></a>

Add a trigger to connect a pipeline to the event that should start it. To add a trigger to a pipeline, do the following:

1. Open your Harness pipeline in Pipeline Studio.
2. Select **Triggers**.
3. Click **+ New Trigger** or **Add New Trigger**. The **Triggers** pane opens.
4. Select the Webhook, Artifact, Manifest, or Scheduled trigger.
5. Complete the required fields for your trigger type. Go to the [Triggers documentation](/harness-platform/use-harness-platform/triggers.md) for more information on setting up each trigger type.

{% hint style="info" %}
You can also add Git, Generic, and Slack Webhook trigger for account level, organization level, and project level using:

* **Account Level**: Account Settings → Account-level Resources → Webhooks → New Webhook
* **Organization Level**: Organization Resources → Organization-level Resources → Webhooks → New Webhook
* **Project Level**: Project Settings → Project-level Resources → Webhooks → New Webhook
  {% endhint %}

***

### View trigger events <a href="#view-trigger-events" id="view-trigger-events"></a>

View trigger events to monitor how and when your triggers fire. You can view trigger events for all triggers created within a pipeline in the **Events** tab.

{% hint style="info" %}
Currently, this feature is behind the feature flag `PIPE_TRIGGER_EVENTS_PAGE_UI`. Contact [Harness Support](mailto:support@harness.io) to enable it.
{% endhint %}

The **Events** tab provides information on **Event Correlation ID**, **Trigger Status**, **Time**, and **Trigger Name**.

<figure><img src="/files/vgCGfi9qtMCgnucvx7Hi" alt=""><figcaption><p>Click to view full size image</p></figcaption></figure>

Select the three dots next to each trigger to view additional details, including the **Payload** and **Trigger Details**.

<figure><img src="/files/WcQpLxucOKTBnzzKePXd" alt=""><figcaption><p>Click to view full size image</p></figcaption></figure>

You can filter triggers based on **Trigger Name**, **Trigger Type**, and **Status**:

* **Trigger Type** includes **All**, **Webhook**, **Artifact**, **Manifest**, and **Scheduled**.

  <figure><img src="/files/Qhx7enx1EFwcbVhl7Tg7" alt=""><figcaption><p>Click to view full size image</p></figcaption></figure>
* **Trigger Status** includes **Success**, **Failed**, and **Skipped**.

  <figure><img src="/files/aWYmP3RtTQl9VRYMOeR1" alt=""><figcaption><p>Click to view full size image</p></figcaption></figure>

***

### Related articles <a href="#related-articles" id="related-articles"></a>

* [Trigger pipelines using Git events](/harness-platform/use-harness-platform/triggers/triggering-pipelines.md)
* [Trigger pipelines on a new artifact](/harness-platform/use-harness-platform/triggers/trigger-on-a-new-artifact.md)
* [Trigger pipelines on new Helm chart](/harness-platform/use-harness-platform/triggers/trigger-pipelines-on-new-helm-chart.md)
* [Schedule pipelines using triggers](/harness-platform/use-harness-platform/triggers/schedule-pipelines-using-cron-triggers.md)
* [Trigger executor identity](/harness-platform/use-harness-platform/triggers/trigger-executor-identity.md): Run trigger-started pipelines under a specific user or service account's RBAC.