Refine `applies_to` syntax by colleenmcginnis · Pull Request #48333 · elastic/beats

colleenmcginnis · 2026-01-08T00:42:15Z

Recently we added support for more specific syntax for versions in applies_to badges including version ranges. Read more in the docs-builder docs. This PR updates existing uses of applies_to that can be clarified with the updated syntax.

github-actions · 2026-01-08T00:42:28Z

🤖 GitHub comments

Just comment with:

run docs-build : Re-trigger the docs validation. (use unformatted text in the comment!)

github-actions · 2026-01-08T00:43:58Z

🔍 Preview links for changed docs

✅ Backports have been created

Details

#48509 [9.1](backport #48333) Refine applies_to syntax has been created for branch 9.1 but encountered conflicts

Cherry-pick of 5e37672 has failed:

On branch mergify/bp/9.1/pr-48333
Your branch is up to date with 'origin/9.1'.

You are currently cherry-picking commit 5e37672f2.
  (fix conflicts and run "git cherry-pick --continue")
  (use "git cherry-pick --skip" to skip this patch)
  (use "git cherry-pick --abort" to cancel the cherry-pick operation)

Changes to be committed:
	modified:   docs/reference/auditbeat/auditbeat-installation-configuration.md
	modified:   docs/reference/auditbeat/auditbeat-installation-script.md
	modified:   docs/reference/auditbeat/auditbeat-starting.md
	modified:   docs/reference/filebeat/filebeat-input-azure-blob-storage.md
	modified:   docs/reference/filebeat/filebeat-input-httpjson.md
	modified:   docs/reference/filebeat/filebeat-installation-configuration.md
	modified:   docs/reference/filebeat/filebeat-installation-script.md
	modified:   docs/reference/filebeat/filebeat-starting.md
	modified:   docs/reference/filebeat/kubernetes-autodiscover.md
	modified:   docs/reference/filebeat/migrate-to-filestream.md
	modified:   docs/reference/heartbeat/heartbeat-installation-configuration.md
	modified:   docs/reference/heartbeat/heartbeat-installation-script.md
	modified:   docs/reference/metricbeat/metricbeat-installation-configuration.md
	modified:   docs/reference/metricbeat/metricbeat-installation-script.md
	modified:   docs/reference/metricbeat/metricbeat-starting.md
	modified:   docs/reference/packetbeat/packetbeat-installation-configuration.md
	modified:   docs/reference/packetbeat/packetbeat-installation-script.md
	modified:   docs/reference/packetbeat/packetbeat-starting.md
	modified:   docs/reference/winlogbeat/configuration-winlogbeat-options.md
	modified:   docs/reference/winlogbeat/winlogbeat-installation-configuration.md
	modified:   docs/reference/winlogbeat/winlogbeat-installation-script.md
	modified:   docs/reference/winlogbeat/winlogbeat-starting.md

Unmerged paths:
  (use "git add <file>..." to mark resolution)
	both modified:   docs/reference/auditbeat/processor-translate-guid.md
	both modified:   docs/reference/filebeat/filebeat-input-cel.md
	both modified:   docs/reference/filebeat/filebeat-input-filestream.md
	both modified:   docs/reference/filebeat/filebeat-input-gcs.md
	both modified:   docs/reference/filebeat/filebeat-input-journald.md
	both modified:   docs/reference/filebeat/processor-translate-guid.md
	both modified:   docs/reference/filebeat/running-on-kubernetes.md
	both modified:   docs/reference/heartbeat/processor-translate-guid.md
	both modified:   docs/reference/metricbeat/metricbeat-metricset-prometheus-remote_write.md
	both modified:   docs/reference/metricbeat/processor-translate-guid.md
	both modified:   docs/reference/packetbeat/processor-translate-guid.md
	both modified:   docs/reference/winlogbeat/processor-translate-guid.md
	both modified:   metricbeat/module/prometheus/remote_write/_meta/docs.md
	both modified:   x-pack/metricbeat/module/prometheus/remote_write/_meta/docs.md

To fix up this pull request, you can check it out locally. See documentation: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/checking-out-pull-requests-locally

#48510 [9.2](backport #48333) Refine applies_to syntax has been created for branch 9.2 but encountered conflicts

Cherry-pick of 5e37672 has failed:

On branch mergify/bp/9.2/pr-48333
Your branch is up to date with 'origin/9.2'.

You are currently cherry-picking commit 5e37672f2.
  (fix conflicts and run "git cherry-pick --continue")
  (use "git cherry-pick --skip" to skip this patch)
  (use "git cherry-pick --abort" to cancel the cherry-pick operation)

Changes to be committed:
	modified:   docs/reference/auditbeat/auditbeat-installation-configuration.md
	modified:   docs/reference/auditbeat/auditbeat-installation-script.md
	modified:   docs/reference/auditbeat/auditbeat-starting.md
	modified:   docs/reference/auditbeat/processor-translate-guid.md
	modified:   docs/reference/filebeat/filebeat-input-azure-blob-storage.md
	modified:   docs/reference/filebeat/filebeat-input-gcs.md
	modified:   docs/reference/filebeat/filebeat-input-httpjson.md
	modified:   docs/reference/filebeat/filebeat-installation-configuration.md
	modified:   docs/reference/filebeat/filebeat-installation-script.md
	modified:   docs/reference/filebeat/filebeat-starting.md
	modified:   docs/reference/filebeat/kubernetes-autodiscover.md
	modified:   docs/reference/filebeat/migrate-to-filestream.md
	modified:   docs/reference/filebeat/processor-translate-guid.md
	modified:   docs/reference/heartbeat/heartbeat-installation-configuration.md
	modified:   docs/reference/heartbeat/heartbeat-installation-script.md
	modified:   docs/reference/heartbeat/processor-translate-guid.md
	modified:   docs/reference/metricbeat/metricbeat-installation-configuration.md
	modified:   docs/reference/metricbeat/metricbeat-installation-script.md
	modified:   docs/reference/metricbeat/metricbeat-metricset-prometheus-remote_write.md
	modified:   docs/reference/metricbeat/metricbeat-starting.md
	modified:   docs/reference/metricbeat/processor-translate-guid.md
	modified:   docs/reference/packetbeat/packetbeat-installation-configuration.md
	modified:   docs/reference/packetbeat/packetbeat-installation-script.md
	modified:   docs/reference/packetbeat/packetbeat-starting.md
	modified:   docs/reference/packetbeat/processor-translate-guid.md
	modified:   docs/reference/winlogbeat/configuration-winlogbeat-options.md
	modified:   docs/reference/winlogbeat/processor-translate-guid.md
	modified:   docs/reference/winlogbeat/winlogbeat-installation-configuration.md
	modified:   docs/reference/winlogbeat/winlogbeat-installation-script.md
	modified:   docs/reference/winlogbeat/winlogbeat-starting.md
	modified:   metricbeat/module/prometheus/remote_write/_meta/docs.md
	modified:   x-pack/metricbeat/module/prometheus/remote_write/_meta/docs.md

Unmerged paths:
  (use "git add <file>..." to mark resolution)
	both modified:   docs/reference/filebeat/filebeat-input-cel.md
	both modified:   docs/reference/filebeat/filebeat-input-filestream.md
	both modified:   docs/reference/filebeat/filebeat-input-journald.md
	both modified:   docs/reference/filebeat/running-on-kubernetes.md

To fix up this pull request, you can check it out locally. See documentation: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/checking-out-pull-requests-locally

#48511 [9.3](backport #48333) Refine applies_to syntax has been created for branch 9.3

* refine applies_to in lists * update tabs to applies switch * fix new hints * fix multi lifecycle badge * more clean up * Apply suggestions from code review --------- Co-authored-by: Visha Angelova <91186315+vishaangelova@users.noreply.github.com> (cherry picked from commit 5e37672) # Conflicts: # docs/reference/auditbeat/processor-translate-guid.md # docs/reference/filebeat/filebeat-input-cel.md # docs/reference/filebeat/filebeat-input-filestream.md # docs/reference/filebeat/filebeat-input-gcs.md # docs/reference/filebeat/filebeat-input-journald.md # docs/reference/filebeat/processor-translate-guid.md # docs/reference/filebeat/running-on-kubernetes.md # docs/reference/heartbeat/processor-translate-guid.md # docs/reference/metricbeat/metricbeat-metricset-prometheus-remote_write.md # docs/reference/metricbeat/processor-translate-guid.md # docs/reference/packetbeat/processor-translate-guid.md # docs/reference/winlogbeat/processor-translate-guid.md # metricbeat/module/prometheus/remote_write/_meta/docs.md # x-pack/metricbeat/module/prometheus/remote_write/_meta/docs.md

* refine applies_to in lists * update tabs to applies switch * fix new hints * fix multi lifecycle badge * more clean up * Apply suggestions from code review --------- Co-authored-by: Visha Angelova <91186315+vishaangelova@users.noreply.github.com> (cherry picked from commit 5e37672) # Conflicts: # docs/reference/filebeat/filebeat-input-cel.md # docs/reference/filebeat/filebeat-input-filestream.md # docs/reference/filebeat/filebeat-input-journald.md # docs/reference/filebeat/running-on-kubernetes.md

* refine applies_to in lists * update tabs to applies switch * fix new hints * fix multi lifecycle badge * more clean up * Apply suggestions from code review --------- Co-authored-by: Visha Angelova <91186315+vishaangelova@users.noreply.github.com> (cherry picked from commit 5e37672)

* refine applies_to in lists * update tabs to applies switch * fix new hints * fix multi lifecycle badge * more clean up * Apply suggestions from code review

* refine applies_to in lists * update tabs to applies switch * fix new hints * fix multi lifecycle badge * more clean up * Apply suggestions from code review --------- Co-authored-by: Visha Angelova <91186315+vishaangelova@users.noreply.github.com> (cherry picked from commit 5e37672)

* refine applies_to in lists * update tabs to applies switch * fix new hints * fix multi lifecycle badge * more clean up * Apply suggestions from code review --------- (cherry picked from commit 5e37672) Co-authored-by: Visha Angelova <visha.angelova@elastic.co> Co-authored-by: Visha Angelova <91186315+vishaangelova@users.noreply.github.com>

* Refine `applies_to` syntax (#48333) * refine applies_to in lists * update tabs to applies switch * fix new hints * fix multi lifecycle badge * more clean up * Apply suggestions from code review --------- Co-authored-by: Visha Angelova <91186315+vishaangelova@users.noreply.github.com> (cherry picked from commit 5e37672) * Resolve merge conflicts --------- Co-authored-by: Visha Angelova <visha.angelova@elastic.co> Co-authored-by: Visha Angelova <91186315+vishaangelova@users.noreply.github.com>

* Refine `applies_to` syntax (#48333) * refine applies_to in lists * update tabs to applies switch * fix new hints * fix multi lifecycle badge * more clean up * Apply suggestions from code review --------- Co-authored-by: Visha Angelova <91186315+vishaangelova@users.noreply.github.com> (cherry picked from commit 5e37672) * Resolve merge conflicts --------- Co-authored-by: Visha Angelova <visha.angelova@elastic.co> Co-authored-by: Visha Angelova <91186315+vishaangelova@users.noreply.github.com> (cherry picked from commit e921752) # Conflicts: # docs/reference/filebeat/filebeat-input-cel.md

* Refine `applies_to` syntax (#48333) * refine applies_to in lists * update tabs to applies switch * fix new hints * fix multi lifecycle badge * more clean up * Apply suggestions from code review --------- Co-authored-by: Visha Angelova <91186315+vishaangelova@users.noreply.github.com> (cherry picked from commit 5e37672) * Resolve merge conflicts --------- Co-authored-by: Visha Angelova <visha.angelova@elastic.co> Co-authored-by: Visha Angelova <91186315+vishaangelova@users.noreply.github.com>

* Refine `applies_to` syntax (#48333) * refine applies_to in lists * update tabs to applies switch * fix new hints * fix multi lifecycle badge * more clean up * Apply suggestions from code review --------- Co-authored-by: Visha Angelova <91186315+vishaangelova@users.noreply.github.com> (cherry picked from commit 5e37672) * Resolve merge conflicts --------- Co-authored-by: Visha Angelova <visha.angelova@elastic.co> Co-authored-by: Visha Angelova <91186315+vishaangelova@users.noreply.github.com> (cherry picked from commit fcf6c3f) # Conflicts: # docs/reference/filebeat/filebeat-input-cel.md

refine applies_to in lists

9c9f021

colleenmcginnis self-assigned this Jan 8, 2026

colleenmcginnis added docs Team:Docs Label for the Observability docs team backport-active-9 Automated backport with mergify to all the active 9.[0-9]+ branches skip-changelog labels Jan 8, 2026

botelastic Bot added needs_team Indicates that the issue/PR needs a Team:* label and removed needs_team Indicates that the issue/PR needs a Team:* label labels Jan 8, 2026

colleenmcginnis mentioned this pull request Jan 8, 2026

Adjust applies_to tags for the new syntax and semantics elastic/docs-content#4361

Closed

Colleen McGinnis added 5 commits January 14, 2026 15:18

Merge branch 'main' into clean-up-applies_to

438e0f4

update tabs to applies switch

b96e538

fix new hints

50d5d12

fix multi lifecycle badge

031c266

more clean up

3907fb9

colleenmcginnis changed the title ~~[work in progress] Refine applies_to syntax~~ Refine applies_to syntax Jan 15, 2026

colleenmcginnis marked this pull request as ready for review January 15, 2026 14:04

colleenmcginnis requested review from a team as code owners January 15, 2026 14:04

colleenmcginnis commented Jan 15, 2026

View reviewed changes

vishaangelova approved these changes Jan 16, 2026

View reviewed changes

vishaangelova added 2 commits January 22, 2026 10:01

Apply suggestions from code review

b022eeb

Merge branch 'main' into clean-up-applies_to

b586522

vishaangelova enabled auto-merge (squash) January 22, 2026 09:16

vishaangelova disabled auto-merge January 22, 2026 09:22

MichaelKatsoulis approved these changes Jan 22, 2026

View reviewed changes

vishaangelova merged commit 5e37672 into elastic:main Jan 22, 2026
45 checks passed

mergify Bot mentioned this pull request Jan 22, 2026

[9.1](backport #48333) Refine applies_to syntax #48509

Merged

mergify Bot mentioned this pull request Jan 22, 2026

[9.2](backport #48333) Refine applies_to syntax #48510

Merged

mergify Bot mentioned this pull request Jan 22, 2026

[9.3](backport #48333) Refine applies_to syntax #48511

Merged

vishaangelova added a commit that referenced this pull request Jan 23, 2026

Refine applies_to syntax (#48333)

333343b

* refine applies_to in lists * update tabs to applies switch * fix new hints * fix multi lifecycle badge * more clean up * Apply suggestions from code review

mergify Bot mentioned this pull request Jan 23, 2026

[main](forwardport #48510) [9.2](backport #48333) Refine applies_to syntax #48517

Closed

mergify Bot mentioned this pull request Jan 23, 2026

[main](forwardport #48509) [9.1](backport #48333) Refine applies_to syntax #48518

Closed

Uh oh!

Conversation

colleenmcginnis commented Jan 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Jan 8, 2026

🤖 GitHub comments

Uh oh!

github-actions Bot commented Jan 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🔍 Preview links for changed docs

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

vishaangelova left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

mergify Bot commented Jan 20, 2026

Uh oh!

vishaangelova commented Jan 22, 2026

Uh oh!

vishaangelova commented Jan 22, 2026

Uh oh!

Uh oh!

github-actions Bot commented Jan 22, 2026

Uh oh!

mergify Bot commented Jan 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Backports have been created

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

colleenmcginnis commented Jan 8, 2026 •

edited

Loading

github-actions Bot commented Jan 8, 2026 •

edited

Loading

vishaangelova left a comment •

edited

Loading

mergify Bot commented Jan 22, 2026 •

edited

Loading