Identify the price of the paid content
Stay organized with collections
Save and categorize content based on your preferences.
Lastly, you need to provide the price information of your content.
Price
For Watch Actions, specify the price of the content for the following cases:
category
is rental
or purchase
.
category
is subscription
or externalsubscription
, but the content requires an additional purchase for subscribers.
For Listen Actions, it's optional to specify the price if category
is subscription
.

Figure 1. Media Actions showing the prices of content on Google Search.
For Watch Actions, specify the price of content in the Action access specification object:
"potentialAction":{
"@type":"WatchAction",
"target":{
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/my_favorite_movie?autoplay=true",
"actionPlatform":[ "http://schema.org/DesktopWebPlatform" ]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "purchase",
"availabilityStarts": "2019-01-01T00:00Z",
"availabilityEnds": "2019-12-31T00:00Z",
"eligibleRegion": {
"@type": "Country",
"name": "US"
},
"expectsAcceptanceOf": {
"@type": "Offer",
"price": 7.99,
"priceCurrency": "USD",
"seller": {
"@type": "Organization",
"name": "My example seller"
}
}
}
}
For Listen Actions, specify the price of content directly in the Action markup object:
"potentialAction":{
"@type":"ListenAction",
"target":{
"@type":"EntryPoint",
"urlTemplate":"http://www.example.com/playlist/top_pop_songs?autoplay=true",
"actionPlatform":[ "http://schema.org/DesktopWebPlatform" ]
},
"expectsAcceptanceOf":{
"@type": "Offer",
"eligibleRegion": {
"@type":"Country",
"name":"US"
},
"category": "subscription",
"name": "Example Music",
"price": 9.99,
"priceCurrency": "USD",
"seller": {
"@type": "Organization",
"name": "My example seller",
"sameAs": "http://www.example.com"
}
}
}
Identify the price
Do the following:
- For Watch Actions,
- If
category
is rental
or purchase
, you need to provide the price of the one-time purchase.
- If
category
is subscription
or externalsubscription
, but the content requires an additional purchase for subscribers, you need to provide the price of the additional cost.
- Otherwise, you do not need to provide the price for
subscription
or externalsubscription
.
- For Listen Actions,
- If
category
is subscription
, it's optional to provide the price of the subscription.
See the Action access requirement examples section for detailed examples.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
[null,null,[],[[["\u003cp\u003eFor Watch Actions, price information is required for rentals, purchases, and any additional costs for subscribers of subscription-based content.\u003c/p\u003e\n"],["\u003cp\u003eWatch Action pricing is specified within the \u003ccode\u003eActionAccessSpecification\u003c/code\u003e object using the \u003ccode\u003eexpectsAcceptanceOf\u003c/code\u003e and \u003ccode\u003eOffer\u003c/code\u003e properties.\u003c/p\u003e\n"],["\u003cp\u003eFor Listen Actions, providing the price is optional for subscription-based content.\u003c/p\u003e\n"],["\u003cp\u003eListen Action pricing, when provided, is specified directly within the \u003ccode\u003eListenAction\u003c/code\u003e object using the \u003ccode\u003eexpectsAcceptanceOf\u003c/code\u003e and \u003ccode\u003eOffer\u003c/code\u003e properties.\u003c/p\u003e\n"],["\u003cp\u003eBoth Watch and Listen Actions utilize the \u003ccode\u003eOffer\u003c/code\u003e schema to define price, currency, and seller information.\u003c/p\u003e\n"]]],["Price information must be provided for Watch Actions when the `category` is `rental` or `purchase`, or if it's `subscription` or `externalsubscription` but requires an extra purchase. For Watch Actions, prices are specified within the `ActionAccessSpecification` object. For Listen Actions, pricing is optional if the `category` is `subscription` and is specified within the `Action Markup` object. In any case, the `price`, `priceCurrency` are required, alongside with the `seller` information.\n"],null,["# Identify the price of the paid content\n\nLastly, you need to provide the price information of your content.\n\nPrice\n-----\n\nFor Watch Actions, specify the price of the content for the following cases:\n\n- `category` is `rental` or `purchase`.\n- `category` is `subscription` or `externalsubscription`, but the content requires an additional purchase for subscribers.\n\nFor Listen Actions, it's optional to specify the price if `category` is `subscription`.\n\n**Figure 1.** Media Actions showing the prices of content on Google Search.\n\nFor Watch Actions, specify the price of content in the [Action access specification object](../reference/#action_access_specification): \n\n \"potentialAction\":{\n \"@type\":\"WatchAction\",\n \"target\":{\n \"@type\":\"EntryPoint\",\n \"urlTemplate\":\"http://www.example.com/my_favorite_movie?autoplay=true\",\n \"actionPlatform\":[ \"http://schema.org/DesktopWebPlatform\" ]\n },\n \"actionAccessibilityRequirement\": {\n \"@type\": \"ActionAccessSpecification\",\n \"category\": \"purchase\",\n \"availabilityStarts\": \"2019-01-01T00:00Z\",\n \"availabilityEnds\": \"2019-12-31T00:00Z\",\n \"eligibleRegion\": {\n \"@type\": \"Country\",\n \"name\": \"US\"\n },\n \"expectsAcceptanceOf\": {\n \"@type\": \"Offer\",\n \"price\": 7.99,\n \"priceCurrency\": \"USD\",\n \"seller\": {\n \"@type\": \"Organization\",\n \"name\": \"My example seller\"\n }\n }\n }\n }\n\nFor Listen Actions, specify the price of content directly in the [Action markup object](../reference/#action_markup): \n\n \"potentialAction\":{\n \"@type\":\"ListenAction\",\n \"target\":{\n \"@type\":\"EntryPoint\",\n \"urlTemplate\":\"http://www.example.com/playlist/top_pop_songs?autoplay=true\",\n \"actionPlatform\":[ \"http://schema.org/DesktopWebPlatform\" ]\n },\n \"expectsAcceptanceOf\":{\n \"@type\": \"Offer\",\n \"eligibleRegion\": {\n \"@type\":\"Country\",\n \"name\":\"US\"\n },\n \"category\": \"subscription\",\n \"name\": \"Example Music\",\n \"price\": 9.99,\n \"priceCurrency\": \"USD\",\n \"seller\": {\n \"@type\": \"Organization\",\n \"name\": \"My example seller\",\n \"sameAs\": \"http://www.example.com\"\n }\n }\n }\n\nIdentify the price\n------------------\n\nDo the following:\n\n1. For Watch Actions,\n - If `category` is `rental` or `purchase`, you need to provide the price of the one-time purchase.\n - If `category` is `subscription` or `externalsubscription`, but the content requires an additional purchase for subscribers, you need to provide the price of the additional cost.\n - Otherwise, you do not need to provide the price for `subscription` or `externalsubscription`.\n2. For Listen Actions,\n - If `category` is `subscription`, it's optional to provide the price of the subscription.\n\nSee the [Action access requirement examples](../reference/#action_access_requirement_examples) section for detailed examples."]]