Paid Skill Schemas

Note: Sign in to the developer console to build or publish your skill.

The paidSkillInformation object is a JSON representation of the paid skill information shown on the TOOLS > MONETIZE YOUR SKILL section of the developer console. This object contains the purchase details for a paid skill. The skill manifest for paid skills has the same general format as for other custom skills. For the overall format of the skill manifest for all Alexa skills, see Skill Manifest Schema.

Sample paid skill schema

To specify paid skills, include the paidSkillInformation object within publishingInformation field and the customProductPrompts object within the locales field.

Copied to clipboard.

{
  "manifestVersion": "1.0",
  "publishingInformation": {
    "paidSkillInformation": {
        "pricing": {
            "amazon.com": [
                {
                    "offerType": "SUBSCRIPTION",
                    "freeTrialInformation": {
                        "freeTrialDuration": "P1D"
                    },
                    "subscriptionInformation": {
                        "subscriptionPaymentFrequency": "MONTHLY"
                    },
                    "price": 4.99,
                    "currency": "USD"
                }
            ],
            "amazon.co.uk": [
                {
                    "offerType": "SUBSCRIPTION",
                    "freeTrialInformation": {
                        "freeTrialDuration": "P1D"
                    },
                    "subscriptionInformation": {
                        "subscriptionPaymentFrequency": "MONTHLY"
                    },
                    "price": 4.99,
                    "currency": "GBP"
                }
            ]
        },
        "taxInformation": {
            "category": "SOFTWARE"
        }
    },
    "locales": {
      "en-US": {
        "customProductPrompts": {
          "purchasePromptDescription": "Quick Trivia has come to Alexa! Challenge yourself to new trivia categories every month.",
          "purchaseConfirmationDescription": "Enjoy your Quick Trivia voice experience!"
        }
      }
    }
  }
}

PublishingInformation definition for paid skills

In paid skills, include the following fields in the publishingInformation object.

Note: At this time paid skills are available in the United States in en_US and es_US locales in USD currency.

Field	Description
`locales`	A map of locale objects that provide specific information for each supported locale. Within the locales object, include the `customProductPrompts` object to define purchase prompts.
`paidSkillInformation`	Defines a skill as a paid skill. The `paidSkillInformation` object contains pricing and tax information.

customProductPrompts definition

The customProductPrompts object contains the prompts for paid skills.

Field Description Type

Field	Description	Type
`purchasePromptDescription`	The description that a customer hears when they purchase a paid skill or cancel a subscription to a paid skill. Follows these guidelines for the purchase description: Include the skill name. Use "`{PREMIUM_CONTENT_TITLE}`" as a token for the display name. Don't use "{" or "}" anywhere else in the prompt. Include what's unique about this skill. Be as brief as possible. Don't include any pricing information, as Amazon automatically appends the price in the purchase flow. Avoid repeating the same phrases customers might have heard in the purchase suggestion. Clearly explain what the skill provides.	string
`purchaseConfirmationDescription`	The description that displays on the post-purchase confirmation card in the Alexa app. Include the placeholder "`{PREMIUM_CONTENT_TITLE}`" for the skill name.	string

purchasePromptDescription

The description that a customer hears when they purchase a paid skill or cancel a subscription to a paid skill.
Follows these guidelines for the purchase description:

Include the skill name. Use "{PREMIUM_CONTENT_TITLE}" as a token for the display name. Don't use "{" or "}" anywhere else in the prompt.
Include what's unique about this skill.
Be as brief as possible.
Don't include any pricing information, as Amazon automatically appends the price in the purchase flow.
Avoid repeating the same phrases customers might have heard in the purchase suggestion.
Clearly explain what the skill provides.

string

purchaseConfirmationDescription

The description that displays on the post-purchase confirmation card in the Alexa app. Include the placeholder "{PREMIUM_CONTENT_TITLE}" for the skill name.

string

PaidSkillInformation definition

The paidSkillInformation object contains pricing and tax information.

Field	Description	Type
`pricing`	Specifies the purchase details	`Pricing` object
`taxInformation`	The tax category	`TaxInformation` object

Pricing object

The Pricing object contains an array of supported marketplaces.

Field	Description	Type
`marketplaces`	The marketplaces in which the skill is available for purchase. The field name is the marketplace name, such as "amazon.com". For valid values, see Paid skill marketplaces.	array of `Price` objects

Price object

Field	Description	Type
`offerType`	Specifies the payment model, such as subscription or one-time payment (entitlement). Valid values: `SUBSCRIPTION`, `ENTITLEMENT`	string
`freeTrialInformation`	(Optional) Include to allow access to paid content for free. Exclude for entitlement offer types.	`FreeTrialDuration` field
`subscriptionInformation`	(Optional) Defines the payment cycle for subscription offer types. Exclude for entitlement offer types.	`subscriptionPaymentFrequency` field
`price`	The list price of the paid skill. For minimum and maximum price ranges, see Price ranges for paid skills.	A number (long)
`currency`	The currency of the list price. Specify as a 3-digit ISO 4217 currency code.	string

freeTrialDuration field

Field	Description	Type
`freeTrialDuration`	The duration of the free trial in days. Specify duration in ISO 8601 format. For example: "P7D". Valid duration: 1&endash;31 days, inclusive.	string

subscriptionPaymentFrequency field

Field	Description	Type
`subscriptionPaymentFrequency`	Identifies the frequency of recurring payments. Valid values: MONTHLY, YEARLY	string

TaxInformation object

Field	Description	Type
`category`	Identifies the paid skill tax category. Valid values: INFORMATION_SERVICES, NEWSPAPERS, PERIODICALS, SOFTWARE, STREAMING_AUDIO, STREAMING_RADIO, VIDEO	string

Sample paid skill