Actio
Macros

fragments + inject

Reusable step blocks spliced in with inject.

Deprecated: prefer _anchors: / templates:

fragments still compiles and expands exactly as shown below, but native YAML anchors now cover the same-file, no-param case: a - *alias whose anchor is a step list is flattened in place at compile time. Compiling a file that uses fragments: emits a fragment-deprecated warning. Migrate:

  • Same-file, no params: move the list under _anchors: with a &name anchor and call it with - *name (see below).
  • Params or cross-file: use templates: + inject ... with, or cross-file inject: ./lib#name.

Migrating to _anchors:

Same-file, no-param reuse maps one-to-one onto native anchors:

before (fragments)
fragments:
  setup:
    - uses: actions/checkout@v4
    - uses: actions/setup-node@v4
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - inject: setup
      - run: npm test
after (_anchors)
_anchors:
  setup: &setup
    - uses: actions/checkout@v4
    - uses: actions/setup-node@v4
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - *setup
      - run: npm test
before (fragments)
fragments:
  setup:
    - uses: actions/checkout@v4
    - uses: actions/setup-node@v4
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - inject: setup
      - run: npm test
after (_anchors)
_anchors:
  setup: &setup
    - uses: actions/checkout@v4
    - uses: actions/setup-node@v4
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - *setup
      - run: npm test

Both compile to the identical workflow. If you need typed params or cross-file reuse, use templates: instead.

Reference

Define reusable step blocks at the top of the file; splice them in with - inject: <name>.

fragments is stripped, inject expanded in place:

.actio.yml
name: Fragments
on: [push]
fragments:
  setup:
    - uses: actions/checkout@v4
    - uses: actions/setup-node@v4
      with:
        node-version: 20
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - inject: setup
      - run: npm test
generated .yml
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - run: npm test
.actio.yml
name: Fragments
on: [push]
fragments:
  setup:
    - uses: actions/checkout@v4
    - uses: actions/setup-node@v4
      with:
        node-version: 20
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - inject: setup
      - run: npm test
generated .yml
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - run: npm test

templates

Parameterized, named step lists spliced into jobs with inject … with.

static-if

Compile-time conditionals that keep or drop jobs, steps, and keys before any YAML is emitted.

On this page

Migrating to _anchors:Reference