---
_comment: Do not remove front matter.
---

A _page matcher_ filters pages by logical path, page kind, environment, or site. Specify filtering criteria using any combination of the following keywords.

environment
: (`string`) A [glob pattern](g) matching the build [environment](g). For example: `{staging,production}`.

kind
: (`string`) A [glob pattern](g) matching the [page kind](g). For example: `{taxonomy,term}`.

lang
: {{< deprecated-in 0.153.0 />}}
: Use [`sites`](#sites) instead.

path
: (`string`) A [glob pattern](g) matching the page's [logical path](g). For example: `{/books,/books/**}`.

sites
: {{< new-in 0.153.0 />}}
: (`map`) A [sites matrix](g) matching any combination of [content dimensions](g) including language, version, and role.
