Create and Manage In-Skill Products

To sell premium content in your skill, you define one or more in-skill products and associate them with your skill. An in-skill product defines the type of purchase and details, such as pricing. You can use the developer console to add in-skill products to your skill.

Prerequisites

To create in-skill products, you must create a custom skill in a locale that supports in-skill purchasing:

  • English (UK)

  • English (US)

  • French (FR)

  • German (DE)

  • Italian (IT)

  • Japanese (JP)

  • Spanish (ES)

  • Spanish (US)

View the in-skill products for a skill

To view the in-skill products for a skill:

  1. Edit a custom skill in the developer console.
  2. On the Build page, select a locale that supports in-skill purchasing.
  3. Navigate to Tools > In-Skill Products. This page displays the in-skill products already associated with your skill, and any you have created that aren't yet associated with the skill.

The In-skill products page displays products in two tables:

  • Linked to this skill lists the products associated with the skill. After you publish your skill, linked products are available for customers to purchase. You must fill in all required fields for the product to link it to the skill. In the development stage, you can unlink products from the skill with the Unlink action.
  • Available to link lists all products that aren't yet associated with any skill. This list includes any products you chose to unlink, and any products that don't contain valid data in all the required fields. You can link completed products to the skill with the Link action.

Each product has a Status:

  • Incomplete – The product is missing data in one or more required fields.
  • Complete – All required fields are complete. If the product isn't yet linked to your skill, you can link it to a skill and test purchasing. If the product is already linked to the skill, Complete indicates one of the following:
    • The product isn't certified and published.
    • You have made changes after you published the product. Re-submit your product to publish those changes.
  • In Review – The product is in certification review.
  • Published – The linked product is published as part of a live skill. Customers can purchase the product.
  • Deactivated – The discontinued product is no longer available for purchase. However, customers who previously purchased it are entitled to continue to have access to the product. For details, see Discontinue a product in a live skill.
The developer console in-skill products page showing products linked to a skill in the development stage.
In-skill products page (development stage)

Create and edit in-skill products

The following sections describe how to create and edit in-skill products in the developer console. Alternatively, you can use the ASK CLI to manage your products. For details, see Create and Edit In-Skill Products with the ASK CLI.

To add an in-skill product in the developer console:

  1. Edit a custom skill in the developer console.
  2. Under Skill builder checklist, click In-Skill Products (ISP). This page displays your in-skill products already associated with the skill, and any you have created that aren't yet associated with the skill. You can click In-Skill Products under TOOLS to reach the same page.
  3. Click Create in-skill product.
  4. Provide a Reference name for the product.
  5. Select the type of product: One-Time Purchase, Subscription, or Consumable.
  6. Click Create in-skill product.
  7. Under Supported Languages, click Add new language. Languages that your skill supports are selectable. To add a greyed out language, add the language to your skill. For details, see Develop Skills in Multiple Languages.
  8. Click the desired languages, fill in the required supported language fields, and then click Save.
  9. Under Pricing & Availability, fill out the required fields.
  10. Under Tax category, fill out the required fields.
  11. Under Promote this ISP on Amazon.com, toggle on or off.
  12. (Subscriptions only) Under Billing, fill out the required fields.
  13. Under Testing, fill out the required fields.
  14. Click Save to save the product information.
  15. When prompted to link the product to your skill, choose Link to skill to link the product to your skill, or choose Close to edit the product information. If you want to link the product later, navigate to TOOLS > In-Skill Products to return to the In-skill products page.

If any required fields are incomplete, including any required fields for each language you selected, you can save the product, but you can't yet link the new product to the skill. The developer console displays the product on the In-skill Products page, under Available to Link. Complete the remaining fields to make the product ready to link to a skill.

Edit a product

You can edit in-skill products for skills that are in the development stage. To edit an in-skill product in the developer console:

  1. Edit a custom skill in the developer console.
  2. Go to the Build page and select a locale that supports in-skill purchasing.
  3. Navigate to TOOLS > In-Skill Products. This page displays the in-skill products already associated with your skill, and any you have created that aren't yet associated with the skill.
  4. Click the Edit link to open the product.
  5. Edit the fields as needed.

Delete a product

You can delete a product from a skill in the development stage, as long as the product has never been available in a live version of the skill.

To delete a product from a skill in development:

  1. Edit a custom skill in the developer console.
  2. On the Build page, select a locale that supports in-skill purchasing.
  3. Navigate to TOOLS > In-Skill Products. This page displays the in-skill products already associated with your skill, and any products you have created that are available to link to your skill.
  4. If your skill includes the product, find it in the Linked to this skill list, and then click the Unlink action.
  5. Find the product in the Available to link list, and then select the Delete action.

Discontinue a product in a live skill

After a product is live, discontinuing that product can cause a negative customer experience. To avoid discontinuing a product, design your premium products according to best practices . If you do have a strong reason to discontinue a live product, you can deactivate the product. This change requires you to submit the skill for recertification. Consider this carefully and avoid any changes that break the experience for your existing customers.

Discontinuing a product has the following affects:

  • Customers can no longer purchase the product.
  • For a consumable or one-time purchase, existing customers who previously purchased the product continue to have access to it. Your skill should continue to support these users.
  • For a subscription, existing customers who previously subscribed continue to have access to the product for the remainder of the subscription term. The subscription doesn't automatically renew at the end of the term.
  • The product remains associated with your skill. Therefore, it's still included when you retrieve products with the in-skill product service. A discontinued product returns NOT_PURCHASABLE for the purchasable property.

After you publish your skill, the status of the skill changes to Live and a new development version is automatically created in the developer console. This version has the same information as the original live version. Use this version to discontinue an in-skill product.

To discontinue an in-skill product in the developer console:

  1. Edit a custom skill in the developer console. Select the development version of your live skill.
  2. On the Build page, select a locale that supports in-skill purchasing.
  3. Navigate to TOOLS > In-Skill Products. This page displays the in-skill products already associated with your skill, and any products you have created that are available to link to your skill.
  4. Find the product under Linked to this skill, and then select the Deactivate action.
  5. Resubmit your skill for certification. For details see, Certify In-Skill Purchasing Skills.

Remove a product from a marketplace

If you do have a strong reason to remove a marketplace for a live product, you can do so. However, you can't remove the default locale.

To remove a marketplace from an in-skill product in the developer console:

  1. Edit a custom skill in the developer console. Select the development version of your live skill.
  2. On the Build page, select a locale that supports in-skill purchasing.
  3. Navigate to TOOLS > In-Skill Products. This page displays the in-skill products already associated with your skill, and any you have created that aren't yet associated with the skill.
  4. Find the product in the Linked to this skill list, and then select the Edit action.
  5. For Supported Languages, click Remove for every language listed, and then click Save.
  6. Resubmit your skill for certification. For details see, Certify In-Skill Purchasing Skills.

Re-activate a discontinued product

You can reactivate a discontinued product to make it available for new purchases again.

To reactivate an in-skill product in the developer console:

  1. Edit a custom skill in the developer console. Select the development version of your live skill.
  2. On the Build page, select a locale that supports in-skill purchasing.
  3. Navigate to TOOLS > In-Skill Products. This page displays the in-skill products already associated with your skill, and any products you have created that are available to link to your skill.
  4. Find the product in Available to link, and then click the Reactivate action.
  5. Resubmit your skill for certification. For details see, Certify In-Skill Purchasing Skills.

In-skill product fields

The following fields identify the product:

Product ID
(Read only) Displays a unique product identifier. You can reference this ID in your code when initiating product offers and purchases.
Reference name
The canonical name of the in-skill product. Use this name when referring to the product in code.

Supported languages

In the Supported Languages section, click Add new language, select the language, and then fill out the following fields. If a language is greyed out and you want to add it, add it to your skill first.

Display name
The name for the product. Used in purchase confirmation prompts, Alexa app purchasing cards, and email receipts. The name is specific to the selected locale for the product.
One-sentence description
A short description that describes the product and what the customer can do with it. You can access this description in the summary property when you retrieve an in-skill product with the In-Skill Product Service.
Detailed description
A full description that explains the functionality of the product and any prerequisites to use the product.
Small product icon / large product icon
An icon representing the product. Provide both large and small versions. Because the image is rounded when displayed, use 75px padding on all sides. You can reuse the icon associated with your skill, or provide a unique image to represent the product.
  • Small Icon: 108 X 108 PNG with transparency. Recommended 75px padding on all sides.
  • Large Icon: 512 X 512 PNG with transparency. Recommended 75px padding on all sides. You can also use the Alexa Skill Icon Builder to create your skill icon to these specifications. Within Icon Builder, click Download to save a zip file containing png files in both the small and large sizes. Then upload these .png files to the in-skill product.
Purchase prompt description
The description of the product a customer hears when they make a purchase or cancel a subscription.
  • Include the product 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 product
  • 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 previous step
Purchase confirmation description
A description of the product that displays on the skill card in the Alexa app. Include the placeholder {PREMIUM_CONTENT_TITLE} for the product display name.

Pricing & availability

In addition to the following field descriptions, you can find additional information about pricing and availability in Choose Pricing, Languages, and Distribution for In-Skill Products.

Availability
Describes the regions where you offer the product for sale. For details about the available options, see Countries and regions that support in-skill products.
Price
List price for the product. For minimum and maximum price values, see Price ranges for in-skill products.
Tax category
The tax category for the product. Select the category that matches the nature of your product:
  • Information Services – Content of an informational nature, such as stocks, weather, news, or financial data.
  • Newspapers – Newspaper content, regardless of the format (video, audio, scrolling graphics, and so on).
  • Periodicals – Periodical content (magazine or non-newspaper), regardless of the format (video, audio, scrolling graphics, and so on).
  • Software – Interactive game content.
  • Software-as-a-Service (SaaS) – A product for which the skill generates responses to specific input by the user (for example, repeating the user's voice back to them in a modified manner), but there's no win-or-lose outcome like in a game.
  • Streaming Audio – Audio content that's not music or streaming radio.
  • Streaming Music – Audio music content that's not streaming radio.
  • Streaming Radio – Audio content in the form of streaming radio, including pre-recorded and live content.
  • Video – Streaming video content, including pre-recorded and live content.

Promotion

This button is on by default to make your product available for in-skill purchases and for purchase on Amazon.com. If you want your product to be available for in-skill purchases only, toggle this button off.

Billing

Billing information is for subscriptions only.

Billing frequency
(Subscriptions only). Indicates how often your bill the customer for the subscription. Can be Monthly or Yearly.
Trial period
(Subscriptions only). Indicates whether this product offers a trial period.
Days in trial period
(Subscriptions only). Indicates the duration of the trial period, in days.

Testing

The Testing section collects details about how the certification team should test your product.

Testing instructions
Instructions that explain how to test this product in the skill. Include information, such as test account credentials and details about how to discover the product when interacting with the skill."