Schema: potentialAction

A clear, readable and advanced example in json+ld markup for Events. Use it to understand how you can explicitly structure relevant data about upcoming or finished events on your own webpage resources.

Use the Schema.org definition of LocalBusiness to improve the listing of your local store. This in-depth example shows you exactly how to manually mark up your location.

WebPage markup should be the cornerstone of all your markup work. WebPage can and should per definition be used on all webpages without exception. Follow our simple, yet deep WebPage markup example to understand how.

Book JSON-LD example for Jane Xoo's 1948 pediatric textbook, the expanded version of her 1945 paper. Covers ISBN, numberOfPages, bookEdition, bookFormat, workExample for editions, inLanguage, the Offers pattern for book pricing, and publisher as Organization with @id cross-references to the Person and Article examples.

Movie JSON-LD example for a documentary about Jane Xoo's pediatric work. Covers director, actor, duration in ISO 8601, contentRating, releasedEvent for premiere details, aggregateRating, review with nested Rating, and the WatchAction pattern for streaming links that Google uses to build the movie knowledge panel.

WebSite JSON-LD example with SearchAction for the sitelinks search box. Covers the potentialAction pattern with query-input, the difference between WebSite and WebPage, publisher cross-referencing, and how Google uses WebSite markup to display a search box directly in the SERP for branded queries.

MusicRecording JSON-LD example for a film score track from The Children's Doctor documentary. Covers byArtist, recordingOf with MusicComposition and ISWC code, ISRC code, inAlbum cross-reference, duration in ISO 8601, and ListenAction for streaming links.

SearchAction JSON-LD example for a site search box. Shows how to embed SearchAction inside WebSite markup to trigger Google's sitelinks search box. Covers the query-input parameter syntax, target URL patterns, and common implementation errors.

BuyAction JSON-LD example for purchasing a XooTee. BuyAction adds one property (seller) on top of TradeAction's price properties. Used in potentialAction on Product to indicate a purchase option.

OrderAction JSON-LD example for ordering a product for delivery. OrderAction adds one property (deliveryMethod) on top of TradeAction's price properties.

ViewAction JSON-LD example for viewing a blog post. ViewAction adds no properties of its own; used as potentialAction on CreativeWork to provide a direct link to view content.

WatchAction JSON-LD example for watching a documentary. WatchAction adds no properties of its own; used as potentialAction on VideoObject or Movie to provide a direct watch link.

SubscribeAction JSON-LD example for a newsletter signup. SubscribeAction adds no properties of its own; used as potentialAction to express a subscription option on a website or content entity.

Action JSON-LD example for the parent type behind all schema.org activity verbs. Covers the 7 Action properties (agent, object, participant, startTime, endTime, location, result), the Action state values (PotentialActionStatus, ActiveActionStatus, CompletedActionStatus, FailedActionStatus), and how Action subtypes attach to entities as potentialAction or subjectOf.

SeekToAction JSON-LD example for jumping to key moments in a video. SeekToAction is used as potentialAction on VideoObject to tell Google where within the video to jump to for a named moment.

Embassy JSON-LD example for a diplomatic mission (embassies and consulates general). Direct GovernmentBuilding subtype. No unique properties; appointment-booking and jurisdiction are the key inherited patterns.

TaxiService JSON-LD example for a taxi or ride-hire service. Direct Service subtype. Covers areaServed, hoursAvailable, provider (Organization), providerMobility, offers. The canonical type (supersedes the old Taxi type).

EntryPoint JSON-LD example for an Action's invocation target (URL template, HTTP method, platform, content type). Intangible with 7 direct properties.

ActionAccessSpecification JSON-LD example for geographic / subscription / date constraints on an Action. Intangible with 7 direct properties.

PropertyValueSpecification JSON-LD example for constraining an Action input: required / readonly / min / max / step / pattern / default. Used with the -input hint on Action properties to describe expected parameter shape.

Thing JSON-LD example for the root of the entire schema.org vocabulary. Every type descends from Thing. Use it directly only when no subtype fits; its 13 properties (name, url, image, identifier, sameAs, potentialAction, etc.) are the universal entity signals every page should publish.

SearchAction JSON-LD reference — Action subtype with query. Known primarily as WebSite.potentialAction for sitelinks searchbox; the property-level reference page.