# schema:Action

Declares actions an agent could take from this page.

**[Capabilities](/docs/capabilities)** · checked on every URL · 5 checks that can fail it

An `Action` with a usable target tells an agent what it can do here, not just what the page is about. Almost all of the installed base is boilerplate `SearchAction` from CMS defaults, so a hand-written Action is worth validating.

## Adoption

**Web baseline** (L4) — ubiquitous as legacy search markup, barely used as an interface an agent can act on

Standard equipment on the web. Its absence is the exception rather than its presence. Direction of travel: ► flat, as of 2026-07-28.

`potentialAction` sits on 10M+ domains, but that is mostly SearchAction boilerplate and no agent vendor has committed to consuming Action markup as an execution interface.

## What we check

Absence is never a finding: every check below runs only once `schemaActionPresent` is true, so a site that has not
adopted this is not assessed on it and appears in no report.

| Check | Kind | Raises | On whose authority |
|---|---|---|---|
| `schemaActionMissingTarget` | high severity | usability | Schema.org profile |
| `schemaActionTargetMissingEntryPoint` | high severity | usability | Schema.org profile |
| `schemaActionMissingQueryInput` | medium severity | usability | Lumar readiness profile |
| `schemaActionUnknownType` | medium severity | usability | Schema.org profile |
| `schemaActionUrlTemplateMissingPlaceholder` | low severity | usability | Lumar readiness profile |

## Examples

These are the fixtures the test suite runs through the real collector, not snippets written for a document.

- Correct: `test/e2e/test-pages/capabilities/correct.html`
- Present but wrong: `test/e2e/test-pages/capabilities/issues.html`

## Specifications

| Document | Revision | Kind |
|---|---|---|
| [Schema.org Action](https://schema.org/Action) | v30.0 | specification |
| [Schema.org potentialAction](https://schema.org/potentialAction) | v30.0 | specification |
| [Google Search: sitelinks searchbox (SERP feature retired Nov 2024; markup still valid)](https://developers.google.com/search/docs/appearance/structured-data/sitelinks-searchbox) | living document | vendor profile |

Last re-read against the published documents: 2026-08-12.