diff --git a/docs/en/observability/synthetics-command-reference.asciidoc b/docs/en/observability/synthetics-command-reference.asciidoc
index 2b5baaa410..749d12bcf0 100644
--- a/docs/en/observability/synthetics-command-reference.asciidoc
+++ b/docs/en/observability/synthetics-command-reference.asciidoc
@@ -52,6 +52,13 @@ Does not apply throttling.
 *`-h, --help`*::
 Shows help for the `npx @elastic/synthetics` command.
 
+[NOTE]
+=====
+The `--tags` and `--match` flags for filtering are only supported when you grep or
+run synthetic tests locally. Filtering is _not_ supported in any other subcommands
+like `init`, `push`, and `location`.
+=====
+
 [discrete]
 [[elastic-synthetics-init-command]]
 = `@elastic/synthetics init`