---
title: Trigger Builds on Tags
description: Automatically trigger a Capawesome Cloud build when you create a Git tag — ideal for release builds using tag name patterns like v*.
---

# Trigger on Tags

Tag automations are ideal for releases: you cut a tag, and Capawesome Cloud builds — and optionally submits — the release automatically. Because a tag marks a deliberate point in your history, it maps neatly onto "this is the version we want to ship," which keeps release builds separate from the day-to-day branch builds.

## Create the automation

1. Open the [Automations](https://console.cloud.capawesome.io/apps/_/automations){:target="_blank"} page and click **Create automation**.
2. Set the **Trigger type** to **Tag**.
3. Set the **Trigger pattern** to match your release tags — for example `v*` to match `v1.0.0`, `v1.2.3`, and so on. See the [pattern syntax](reference.md#trigger-pattern-syntax) for more.
4. Choose the **Platform** and any [build settings](attach-build-settings.md).

When you push a matching tag, Capawesome Cloud builds the exact commit the tag points to.

## Build a full release pipeline

A tag automation becomes a one-step release when you attach a publish target in its [build settings](attach-build-settings.md):

- Attach a [store destination](auto-submit.md) to submit the tagged build to TestFlight or Google Play.
- Attach a [Live Update channel](auto-publish-live-update.md) to publish a web build over the air.

## Next steps

- [Auto-submit to a store](auto-submit.md) — build and submit releases from a tag.
- [Auto-publish a Live Update](auto-publish-live-update.md) — ship web releases over the air.
- [Attach build settings](attach-build-settings.md) — sign and configure the triggered builds.