Your Alexa Dashboards Settings

Smart Home Skill Publishing Guide

When you complete the publishing information for a Smart Home Skill there are some special requirements to pass certification. In particular, fields such as the skill description and example phrases must be completed correctly. This topic will give you guidance to complete these sections to help your skill pass certification.

The following image shows the Publishing Details page from the Developer Portal.

Provide Content in the Right Language

A skill offered in multiple languages must provide an excellent experience for users that speak those languages. Test and make sure that your skill works in all of its target languages and that you provide the following Publishing Information in the skill’s target language:

  • Short Skill Description
  • Full Skill Description
  • Example Phrases

In addition, it’s recommended that you provide the following in the skill’s target language:

  • Any supporting pages such as Privacy Policy or FAQ

Support for the device APIs varies by region. Make sure these items do not reference functionality that is not available for that language version of the skill. For example, if you create a Japanese version of your skill, the Japanese descriptions, phrases and support pages should only discuss features that are available in the Japanese skill. For more information, see Develop Smart Home Skills in Multiple Languages. You can find more details about providing Example Phrases in the Align Example Phrases with Consumer Guidance section, and a Full Skill Description in the Provide a Detailed Full Skill Description section.

Provide Test Account Credentials in Test Instructions

A smart home skill requires account linking, and this functionality must be tested prior to certification. Because of this, you must use the Test Instructions to provide test credentials (username and password) for the device cloud that the skill will interact with. In addition, you must make sure the device cloud for the test account contains at least one discoverable device for testing purposes.

Align Example Phrases with Consumer Guidance

To pass certification, you must align your example phrases to the Amazon-provided smart home consumer guidance. In addition, example phrases should grammatically correct and be correctly punctuated. Following are links to the sample commands, by language.

Ensure that your skill works with the Amazon-provided example phrases relevant to your skill. In addition, the example phrases you list for the Skill Description and the Example Phrases sections for your skill should be the same, and come from these pages.

For more information, see the example phrases section of the Provide the a Detailed Full Description section of this document.

Provide a Good Customer Guide

To help a customer get started with your skill, you should provide a good guide to using your products with Alexa. The guide should preferably include an FAQ or troubleshooting section. Make sure the page loads correctly on IOS, Android and desktop browsers, and preferably make it available at a short URL. Some examples of good quality guides are:

Provide a Detailed Full Skill Description

Your full skill description is read and evaluated during the certification process. You must include certain information like instructions to get started and the correct example phrases or your skill may not pass certification.

To help you pass certification, pick the skill description template following that matches the language(s) of the skill you’d like to publish. Customize the details to describe your skill by replacing any italicized placeholder text with the name of your skill or company or the appropriate example phrases.

English (US) Skill Description Template

With the skill name/company name skill and Alexa, you can now interact with your skill name/company name devices by voice. To get started, select the 'Enable Skill' button in the Alexa App to link your skill name/company name account and discover your devices. Find more information about connecting smart home devices at Connect a Smart Home Device to Alexa (http://tinyurl.com/alexa-smart-home).

When using the skill, you need established names for your devices. There are two ways to define these names:

  • Use the names you previously set up. They are shown in the skill name/company name app and can be changed
  • Create an Alexa group, like Bedroom or Downstairs, and add the device to the group. More information is available at Create a Smart Home Device Group (http://tinyurl.com/alexa-smart-home-groups)

Once you know the name or group name for your devices, you can say the following:

Depending on the types of devices your skill supports, choose example phrases from the Use Your Smart Home Device with Alexa page (https://www.amazon.com/gp/help/customer/display.html) and replace [bracketed text] with names appropriate for your skill. Example:

  • "Alexa, turn on Bedroom."
  • "Alexa, set Downstairs temperature to 72 degrees."


If you have any questions, please visit the skill name/company name FAQ at skill name/company name Link to Your US FAQ

English (UK) Skill Description Template

With the skill name/company name skill and Alexa, you can now interact with your skill name/company name devices by voice. To get started, select the 'Enable Skill' button in the Alexa App to link your skill name/company name account and discover your devices. Find more information about connecting smart home devices at Connect a Smart Home Device to Alexa (http://tinyurl.com/alexa-smart-home-uk)

When using the skill, you need established names for your devices. There are two ways to define these names:

  • Use the names you set up already. These are shown in the skill name/company name app and can be changed
  • Create an Alexa group, like Bedroom or Downstairs, and add the device to the group. More information is available at Create a Smart Home Device Group (http://tinyurl.com/alexa-smart-home-groups-uk)

Once you know the name or group name for your devices, you can say the following:

Depending on the types of devices your skill supports, choose example phrases from the Use Your Smart Home Device with Alexa page provided for consumers (https://www.amazon.co.uk/gp/help/customer/display.html), and insert them here, replacing [bracketed text] with names appropriate for your skill. Example:

  • "Alexa, turn on Bedroom."
  • "Alexa, set Downstairs temperature to 22 degrees."


If you have any questions, please visit the skill name/company name FAQ at Link to Your UK FAQ.

German Skill Description Template

Mit dem skill name/company name-Skill und Alexa können Sie Ihre skill name/company name-Geräte mithilfe Ihrer Stimme bedienen. Zum Starten wählen Sie „Skill aktivieren“ in der Alexa App, um Ihr skill name/company name-Konto zu verknüpfen und Ihre Geräte zu suchen. Weitere Informationen zum Verbinden von smart home-geräten finden Sie unter Verbinden Sie Ihr Smart Home-Gerät mit Alexa(http://tinyurl.com/alexa-smart-home-de)

Wenn Sie den Skill verwenden, müssen Sie den Namen der Gerät angeben, die benutzt werden sollen. Diese Namen können auf zwei Arten festgelegt werden:

  • Verwenden Sie die Namen, die Sie bereits festgelegt haben – sie werden in der skill name/company name
  • App angezeigt und können geändert werden Erstellen Sie eine Alexa-Gruppe wie „Schlafzimmer“ oder „Untergeschoss“ und fügen Sie das Gerät zur Gruppe hinzu. Weitere Informationen erhalten Sie unter Eine Smart Home-Gerätegruppe erstellen(http://tinyurl.com/alexa-smart-home-groups-de)

Sobald Sie den Namen oder die Gruppe Ihrer Geräte kennen, können Sie Folgendes sagen:

Depending on the types of devices your skill supports, choose example phrases from the Use Your Smart Home Device with Alexa page provided for consumers (https://www.amazon.de.uk/gp/help/customer/display.html), and insert them here, replacing [bracketed text] with names appropriate for your skill. Example:

  • „Alexa, schalte ‚Schlafzimmer‘-Beleuchtung ein.“
  • „Alexa, stelle die ‚Untergeschoss‘-Temperatur auf 22 Grad.“


Wenn Sie Fragen haben, besuchen Sie die skill name/company name-FAQs unter Provide link to German FAQ.

You must provide links to a privacy policy and terms of use page, and these must be accessible from a variety of mobile and desktop devices. The content must display in the page and not require a PDF or other document downlaod. Verify all clickable links open and display properly on IOS, Android and desktop devices.