---
title: assembler content-source match cli command
description: Checks whether a repository at a specific branch or tag should be included in the next build. Emits the following $GITHUB_OUTPUT variables: content-source-match...
url: https://docs-v3-preview.elastic.dev/docs-builder/cli/assembler/content-source/match
products:
  - Elastic Docs Builder
---

# assembler content-source match cli command
```bash
docs-builder assembler content-source match [<repository>] [<branch-or-tag>]
```

Checks whether a repository at a specific branch or tag should be included in the next build. Emits the following `$GITHUB_OUTPUT` variables:
- `content-source-match` — whether the branch is a configured content source.
- `content-source-next` — whether the branch is the next content source.
- `content-source-current` — whether the branch is the current content source.
- `content-source-speculative` — whether the branch is a speculative content source.


## Arguments

<definitions>
  <definition term="<repository> string">
    Repository slug to match (e.g. elastic/elasticsearch).
  </definition>
  <definition term="<branch-or-tag> string">
    Branch name or version tag to test against.
  </definition>
</definitions>


## Options

<definitions>
  <definition term="-l --log-level enum">
    Minimum log level.
    **Values:** trace, debug, information, warning, error, critical, none
    **Default:** `information`
  </definition>
  <definition term="-c --config-source enum">
    Override the configuration source: local, remote
    **Values:** local, remote, embedded
  </definition>
  <definition term="--[no-]skip-private-repositories">
    Skip cloning private repositories
  </definition>
</definitions>


## Speculative builds

If branches follow semantic versioning and a branch is cut that is greater than the current version, it is considered a speculative build.
`docs-builder`'s shared workflow triggers even if the branch is not yet specified as a content source in `assembler.yml`.
This allows a branch's `links.json` to be published to the Links Service ahead of time, before the branch is officially configured as a content source.