---
title: Automations Reference
description: Reference for Capawesome Cloud automations — trigger pattern syntax, skip-CI keywords, and build-settings fields.
---

# Reference

## Trigger pattern syntax

An automation can have up to 10 trigger patterns. Patterns match the full branch or tag name using glob wildcards:

| Pattern | Matches |
| --- | --- |
| `main` | the `main` branch exactly |
| `v*` | tags like `v1.0.0`, `v2.3.4` |
| `release/*` | branches like `release/1.0`, `release/2.0` |
| `release/**` | branches like `release/1.0` and `release/hotfix/1.0.1` |
| `!v*-*` | excludes tags like `v1.0.0-rc.1` |
| `*` | any branch or tag without a `/` in its name |

`*` matches any characters except `/`, `**` matches any characters including `/`, and a pattern starting with `!` excludes the names it matches.

### Combining patterns

A branch or tag triggers the automation when no exclude pattern matches it and either no other pattern is set or at least one of them matches. An automation without any pattern therefore runs for every branch or tag of its trigger type.

For example, the patterns `v*` and `!v*-*` match `v1.0.0` but not `v1.0.0-rc.1` or `v1.0.0-prod.1`.

## Skip keywords

Include any of these in the **head commit** message to skip an automation (case-insensitive):

- `[skip ci]`
- `[ci skip]`
- `[skip capawesome]`
- `[capawesome skip]`

## Build settings

| Setting | CLI option | Description |
| --- | --- | --- |
| Platform | `--platform` | Android, iOS, or Web |
| Build Type | `--type` | The [build type](../native-builds/build-types.md) |
| Build Stack | `--stack` | The [build stack](../native-builds/build-stacks.md) |
| Signing Certificate | `--certificate` | The [certificate](../native-builds/certificates/index.md) to sign with |
| Native Configuration | `--configuration` | The [native configuration](../native-builds/native-configurations.md) to build with |
| Environment | `--environment` | The [environment](../native-builds/environments.md) (variables/secrets) |
| Store Destination | `--destination` | A [store destination](../app-store-publishing/destinations/index.md) to submit to |
| Live Update Channel | `--channel` | A [Live Update channel](../live-updates/channels.md) to publish to |

The CLI options apply to [`apps:automations:create`](../cli/commands.md#appsautomationscreate) and [`apps:automations:update`](../cli/commands.md#appsautomationsupdate). The certificate, native configuration, environment, store destination, and Live Update channel are referenced by name rather than by ID.