Alexa Developer Console
amazon alexa
  • Sign In
  • Documentation
  • Forums
  • Contact Us
  • Alexa Developer Home
  • Alexa Developer Console
  • Alexa Voice Service
  • Alexa Certification Console
  • Alexa Connect Kit
  • Skill Builders
    • Alexa Skills Kit
    • Feature Updates
    • Documentation
    • Grow Your Business
    • Developer Console
  • Device Makers
    • Alexa Built-in Devices Develop Alexa built-in devices with Alexa Voice Service
      • Overview
      • Development Resources
      • Business Resources
      • What's New
      • Console
    • Connected Devices Connect your smart devices to Alexa
      • Overview
      • Development Resources
      • Business Resources
      • What's New
      • Consoles
  • Solution Providers
    • Consulting & Professional Services
    • Skill Agencies
    • Systems Integrators (SIs)
    • Original Design Manufacturers (ODMs)
    • Development Kits
    • Alexa for Hospitality
  • Products
    • Alexa Skills Kit
    • Alexa Voice Service
    • Alexa Smart Home
    • Alexa Gadgets Toolkit
      • Alexa Gadgets
      • Alexa Smart Toys
      • Alexa Smart Clocks
      • Resources
    • Alexa Auto SDK
    • Alexa for Business
    • Alexa for Hospitality
    • Alexa for Residential
    • Alexa Smart Properties
  • Programs
    • Alexa Startups
    • Alexa Fund
      • Pitch Us Tell us about your company
      • Portfolio Alexa Fund Portfolio companies
      • Alexa Next Stage Online program for late-stage startups
      • Alexa Fellowship Program for university students
    • Alexa Prize
    • Alexa Science
    • Alexa Champions
    • Voice Interoperability Initiative
  • Branding
    • Alexa Branding
    • Echo Branding
  • Docs
    • Build Skills Alexa Skills Kit
    • Build Alexa into a Device Alexa Voice Service
    • Connect Devices to Alexa Alexa Smart Home & Alexa Gadgets
      • Smart Home Skills
      • Alexa Connect Kit
      • Echo Button Skills
      • Alexa Gadgets Toolkit
    • Manage Skills ASK CLI and SMAPI
  • Blog
    • Alexa Skills Kit
    • Device Makers
    • Alexa Auto
    • Alexa Science
    Documentation  >  Alexa Skills Kit
Alexa Skills Kit

Collapse All | Expand All


  • Get Started
  • What is the Alexa Skills Kit?
    • About Voice Interaction Models
    • Index of Skill Types
    • Glossary
  • Skill Types
  • Automotive Skills
    • Connected Vehicle Skills
      • VehicleData
      • AuthorizationController
    • Alexa Skills for Driving
      • Best Practices
      • Automotive Property
      • Navigation Management
  • Business Skills
    • Alexa for Business
      • Build Skills for Conferencing Devices
      • Calendar
      • MeetingClientController
      • Create and Publish Private Skills (Developer Console)
      • Create and Publish Private Skills (ASK CLI)
    • Alexa for Hospitality
      • Get Started
      • Manage Roles
      • Manage Properties, Room Types, and Rooms
      • Manage Skills
      • Set Up and Manage Devices
      • REST API Reference
        • Role API
        • Property, Room Type, and Room API
        • Endpoint API
        • Unit Settings API
        • Skill Management API
        • Communications API
        • Notifications API
        • Paginating Results
    • Alexa for Residential
      • Get Started
      • Manage Roles
      • Manage Homes, Communities, and Skills
      • Set Up and Manage Devices
      • REST API Reference
        • Role API
        • Home and Community API
        • Endpoint API
        • Discovery Session API
        • Home Occupancy API
        • Skill Management API
        • Paginating Results
    • Meetings Skills
      • Steps to Create a Meetings Skill
      • Testing Guide
      • Reservation.Room
      • ErrorResponse
  • Cooking Skills
    • Cooking Interface
    • FoodTemperatureController
    • FoodTemperatureSensor
    • PresetController
    • TemperatureController
    • TemperatureSensor
    • TimeController
    • Property Schemas
  • Custom Voice Model Skills
    • Steps to Build a Custom Skill
    • Get Custom Skill Sample Code
    • Understand How Users Invoke Custom Skills
    • Choose the Invocation Name for a Custom Skill
    • Create a Custom Skill from a Quick Start Template
    • Host a Custom Skill as an AWS Lambda Function
    • Host a Custom Skill as a Web Service
    • Configure a Skill for Multiple Languages
      • Distribute Your Skill to Additional Locales of the Same Language
      • Use Hindi in Your Alexa Skill
      • Alexa Skills English Variants Migration FAQ
      • Alexa Skills French Variants Migration FAQ
      • Alexa Skills Spanish Variants Migration FAQ
    • Create the Interaction Model (Intents, Slots, and Dialogs)
      • Create Intents, Utterances, and Slots
      • Create and Edit Custom Slot Types
      • Define Synonyms and IDs for Slot Type Values (Entity Resolution)
      • Use Dynamic Entities for Customized Interactions
      • Collect Multiple Values in a Slot
      • Best Practices for Sample Utterances and Custom Slot Values
      • Create the Dialog Model
        • Validate Slot Values
        • Use a Dialog Model to Manage Ambiguous Responses
      • Review the Intent History
    • Use Built-in Intents and Slot Types
      • Understand the Structure of the Built-in Intent Library
      • Built-in Intent Library
      • Standard Built-in Intents
      • Slot Type Reference
      • Built-in Intent Entity Types
        • Actor Intents
        • Book Intents
        • BookSeries Intents
        • Calendar Intents
        • Catalog Intents
        • CreativeWork Intents
        • CreativeWork
          Section Intents
        • Episode Intents
        • Event Intents
        • LocalBusiness Intents
        • MusicCreativeWork Intents
        • MusicGroup Intents
        • Musician Intents
        • MusicPlaylist Intents
        • MusicRecording Intents
        • PlaybackMode Intents
        • ReadingList Intents
        • ScreeningEvent Intents
        • Singer Intents
        • Thing Intents
        • TVSeason Intents
        • TVSeries Intents
        • VideoCreative
          Work Intents
        • VideoPlaylist Intents
        • WeatherForecast Intents
      • Migrate Slot Types that Used AMAZON.LITERAL
    • Handle Requests Sent by Alexa
      • Manage the Skill Session and Session Attributes
      • Delegate the Dialog to Alexa
      • Include a Card in Your Skill's Response
      • Best Practices for Skill Card Design
      • Send the User a Progressive Response
      • Understand Name-free Interaction for Custom Skills
      • Implement CanFulfill
        IntentRequest for Name-free Interaction
    • Personalize the User Experience
      • Add Personalization to Your Skill
      • Access the Alexa Shopping and To-Do Lists
      • Add Personalized Greetings or Prompts
      • Configure Permissions for Customer Information
      • Enhance Your Skill with Address Information
      • Get a User-Specific Access Token for Out-of-Session Calls
      • Obtain Customer Settings Information
      • Request Customer Contact Information
      • Request Recognized Speaker Contact Information
      • Test and Troubleshoot Personalization
      • Use Location Services for Alexa Skills
      • Use Personalization With or Without Account Linking
    • Expose Skill Functionality with Tasks
      • Implement Custom Tasks in Your Skill
      • Implement Amazon Predefined Tasks in Your Skill
      • Amazon Predefined Task Reference
    • Let Skills Work Together with Skill Connections
      • Use Skill Connections to Request Tasks
    • Alexa Quick Links
      • Create a Quick Link for Your Custom Skill
      • Create a Quick Link for Your Custom Task
    • Use Display Templates to Show Content on Screens
      • Configure a Skill to Support the Display Interface
      • Best Practices for using Display Templates
      • Test for Display Template Issues in Your Skill
  • Education Skills
    • Steps to Create an Education Skill
    • Course
    • Coursework
    • Course Grade
    • Coursework Grade
    • Student Profile
    • School Communication
    • Component Reference
    • Error Response
    • Paginating Results
  • Entertainment Device Skills
    • ChannelController
    • EqualizerController
    • InputController
    • KeypadController
    • Speaker
    • StepSpeaker
    • WakeOnLANController
  • Flash Briefing Skills
    • Steps to Create a Flash Briefing Skill
    • Tips to Create a Great Flash Briefing Skill
    • Flash Briefing Skill API Feed Reference
    • Flash Briefing Skill Certification Checklist
    • Normalize the Loudness of Audio Content
  • Game Skills
    • Alexa Web API for Games
      • Build Your Alexa Skill for Web App Games
      • Build Your Web App using Web API for Games
      • Alexa.Presentation.HTML Interface Reference
      • Add Voice Control and Speech to the Web App
      • Web API Extensions for Games
        • Entity-Sensing Extension
        • Smart-Motion Extension
      • Release Notes and Known Issues
      • Alexa JavaScript API
  • List Skills
    • Steps to Create a List Skill
    • List Events in Alexa Skills
    • Creating and Managing List Skills FAQ
    • Functional Testing for a List Skill
    • Certification Guidelines for List Skills
    • Submit an Alexa List Skill for Certification
  • Music, Radio, and Podcast Skills
    • Steps to Create a Music, Radio, or Podcast Skill
    • Implement Podcast Skill Features
    • Upload Music or Radio Catalogs
    • Upload Podcast Catalogs
    • Add Premium Audio, Badging, and License Retrieval to a Music Skill
    • Internationalize a Podcast Skill
    • Catalog Reference
      • Music Catalog Reference
      • Radio Catalog Reference
      • Podcast Catalog Reference
    • Understand Voice Modeling
    • Testing Guide
    • Event Subscriptions
    • Troubleshooting
    • Music, Radio, and Podcast Skill API
      • What's New
      • API Reference Overview
      • Audio.PlayQueue
      • Media.Playback
      • Media.PlayQueue
      • Media.Search
      • UserPreference
      • API Components Reference
      • Error Response
  • Networking and Wi-Fi Skills
    • HomeNetworkController
    • ConnectedDevice
    • AccessController
  • Smart Home Skills
    • Steps to Build a Smart Home Skill
    • Send Events to the Alexa Event Gateway
    • State and Change Reporting
    • How to Proactively Manage Endpoints
    • Authenticate a Customer to Alexa
    • Best Practices for the Alexa App
    • Develop Smart Home Skills in Multiple Languages
    • Smart Home Skill Publishing Guide
    • Smart Home Skill Device Templates
    • Provide Scenes
    • Zigbee Support
    • Smart Home Skill v2-to-v3 Migration Guide
    • Multi-capability Skills
      • Upgrade to MCS with the developer console
      • Upgrade to MCS with the ASK CLI
      • Multi-capability skill FAQ
    • Smart Home Skill APIs
      • AutomationManagement
      • BrightnessController
      • ColorController
      • ColorTemperatureController
      • Estimation
      • InventoryLevelSensor
      • InventoryUsageSensor
      • Meter
      • PercentageController
      • PowerController
      • PowerLevelController
      • SceneController
      • TemperatureSensor
      • ThermostatController
      • ThermostatController.HVAC.Components
      • TimeHoldController
      • Generic Controllers
        • ModeController
        • RangeController
        • ToggleController
  • Smart Home Security Skills
    • CameraStreamController
    • ContactSensor
    • DoorbellEventSource
    • EventDetectionSensor
    • LockController
    • MediaMetadata
    • MotionSensor
    • RTCSessionController
    • SecurityPanelController
  • Video Skills
    • Video Skills for Fire TV Apps
    • Video Skills for Echo Show
    • Video Skills for Living Room Devices
    • Supported Locales
    • Video Skill Testing Guide
    • Content Catalog Ingestion
    • Message and Data Formats for Video Skills
    • State Reporting for Video Skills
    • Lineup Specification for Live TV Skills
    • Video Skill API
      • Launcher
      • Playback
        Controller
      • PlaybackState
        Reporter
      • RecordController
      • RemoteVideo
        Player
      • SeekController
      • VideoRecorder
      • ErrorResponse
      • Entity Types
      • Launch Targets
  • Skill Development Process
  • Design Your Skill
    • Alexa Design Guide
  • Build Your Skill
    • Account Linking
      • Account Linking Concepts
      • How Users Experience Account Linking
      • Requirements for Account Linking
      • Account Linking Best Practices
      • Account Linking Quick Reference
      • Implement Account Linking
        • Steps to Implement Account Linking
        • Account Linking for Custom Skills
        • Account Linking for Smart Home and Other Domains
      • Configure Account Linking
        • Configure an Authorization Code Grant
        • Configure an Implicit Grant (Custom Skills Only)
        • Let Users Enable Your Skill Without Account Linking
      • Set up App-to-App Account Linking
        • App-to-App Account Linking (Starting From Your App)
        • App-to-App Account Linking (Starting From the Alexa App)
        • Alexa Skill Activation API
      • Use Access Tokens in Your Skill Code
        • Use Access Tokens in Custom Skills
        • Use Access Tokens in Smart Home, Video, and Meetings Skills
        • Use Access Tokens in Music Skills
    • Sell Products in an Alexa Skill
      • Sell Premium Content with In-Skill Purchasing
        • Create and Manage In-Skill Products
        • Create and Manage In-Skill Products with the ASK CLI
        • Design a Good Customer Experience
        • Add ISP Support to Your Skill Code
        • Choose Pricing, Languages, and Distribution for In-Skill Products
        • Build Premium Experiences for Kid Skills in the US
        • Test In-Skill Purchasing Skills
        • Certify In-Skill Purchasing Skills
        • Use In-Skill Product Service APIs
        • Set Up Tax Forms for Your Account
        • Set Up Payments
        • In-Skill Purchasing FAQ
      • Sell Real-World Goods and Services with Amazon Pay
        • Integrate a Skill with Amazon Pay
        • Certify your Skill with Amazon Pay
        • Amazon Pay APIs for Alexa
        • Payment Declines and Processing Errors
        • Amazon Pay for Alexa Skills FAQ
    • Use APL to Create Visual Content
    • Include Reminders in a Skill
      • Set Up Voice Permissions for Reminders
      • Alexa Reminders Guidelines
      • Alexa Reminders API Reference
    • Include Timers in a Skill
      • Set Up Voice Permissions for Timers
      • Alexa Timers Guidelines
      • Alexa Timers API Reference
    • Use Events in a Skill
      • Add Events to Your Skill
      • Send a Message Request to a Skill
      • Configure an Application or Service to Send Messages to Your Skill
      • Skill Messaging API Reference
    • Alexa for Apps
      • Add Alexa for Apps to Your Custom Skill
      • Skill Manifest Reference
      • Skill Connection Request Reference
      • FAQ
    • Deprecated Features
  • Test and Debug Your Skill
    • Test Your Smart Home Skill
      • Smart Home Debugger
      • Smart Home Debugger for WebRTC Skills
      • Smart Home Test
      • State Reporting Test Tool
    • Test Your Custom Skill
      • Configure Your Web Service to Use a Self-Signed Certificate
      • Set or Get Self-Signed SSL Certificates for Skill Endpoints for Testing
      • Deploy a Web Service for a Custom Skill to AWS Elastic Beanstalk
      • Automatic Speech Recognition (ASR)
        • Create an Annotation Set for Automatic Speech Recognition (ASR)
        • Run an Automatic Speech Recognition (ASR) Evaluation
        • Improve your Automatic Speech Recognition (ASR) Test Results
      • Evaluate and Test Your Interaction Model
        • Find Utterance Conflicts in Your Model
        • Test Your Utterances as You Build Your Model
        • Batch Test Your NLU Model
    • Beta Test a Skill
  • Certify and Publish Your Skill
    • Certification Requirements
      • Policy Requirements
      • Security Requirements
      • Requirements for Skills that Allow Purchases
      • Requirements for HIPAA-Eligible Skills
      • Certification Functional Tests
      • Certification Tests for VUI and UX
      • Troubleshooting Common Certification Failures
    • Works with Alexa
      • WWA Certification Requirements
      • WWA Security Best Practices
      • Apply for WWA Certification
      • WWA Certification Status Tracking
      • WWA IoT Solution Providers
      • Works with Alexa FAQ
    • Certified for Humans
  • Monitor Your Skill and Metrics
    • Analyze Your Skill Metrics
      • View Skill Metrics
      • Interpret and Troubleshoot Skill Metrics Results
      • Download Message Ids for Troubleshooting
      • Skill Metrics FAQ
    • View Your Payments and Earnings
    • Rollback a skill
  • Tools to Create and Manage Skills
    • Alexa Developer Console
      • Create a Skill and Choose the Interaction Model
      • Build Your Skill
      • Test Your Skill
      • Define Skill Store Details and Availability
      • Test and Submit Your Skill for Certification
      • Grant a User Access to Work on Your Skills
    • Alexa-Hosted Skills
      • Create and Manage Alexa-hosted Skills
      • Import an Alexa-hosted Skill from a Git Repository
      • Use Media Files
      • Use DynamoDB for Data Persistence
      • Use Personal AWS Resources
      • Create and Manage Alexa-hosted Skills by Using the ASK CLI
    • ASK Toolkit for VS Code
      • Manage Skills in VS Code
      • APL Documents in VS Code
      • Test Skills in VS Code
    • ASK SDKs
      • ASK SDK for Node.js
        • Setting Up
        • Developing Your First Skill
        • Migration Guide
        • Processing Request
        • Building Response
        • Managing Attributes
        • Calling Alexa Service APIs
        • Configuring Skill Instance
        • Utilities
        • Call Alexa Service APIs Out of Session
        • Host a Custom Skill as a Web Service
        • ASK SDK for Node.js Reference
      • ASK SDK for Java
        • Setting Up
        • Developing Your First Skill
        • Migration Guide
        • Supported Capabilities
        • Request Processing
        • Skill Attributes
        • Alexa Service Clients
        • Response Building
        • Skill Builders
        • Managing In-Skill Purchases
        • Host a Custom Skill as a Web Service
        • ASK SDK for Java Reference
      • ASK SDK for Python
        • Setting Up
        • Developing Your First Skill
        • Sample Skills
        • Supported Capabilities
        • Request Processing
        • Response Building
        • Configuring Skill Instance
        • Skill Attributes
        • Alexa Service Clients
        • Alexa Out-Of-Session Service Clients
        • Host a Custom Skill as a Web Service
        • ASK SDK for Python Reference
      • ASK SDK Deprecation Policy
      • ASK SDK Controls Framework (Beta)
      • ASK SDK Controls Framework API Reference
    • ASK CLI
      • ASK CLI Quick Start
      • ASK CLI Reference
      • Manage Credentials
      • Migrate from CLI v1 to v2
    • Skill Management API
      • Get an Access Token for SMAPI
      • Account Linking Management
      • Audit Logs
      • Catalog Content Upload
      • Clone Skill Locale
      • Intent Request History
      • Interaction Model Management
      • In-Skill Product Management
      • Proactive Events
      • Metrics
      • Create a Slot Type to Use in Multiple Skills
      • Reference-Based Catalog Management
      • Rollback a Skill
      • Skill Certification and Publishing
      • Skill Credentials
      • Skill Enablement
      • Skill Management
      • Skill Package Management
      • Smart Home Evaluation
      • Vendor Management
      • Alexa-hosted skill
      • Manage Update Jobs
      • SMAPI Error Codes
      • Skill Testing
        • Skill Validation
        • Skill Invocation
        • Skill Simulation
        • Skill Beta Testing
        • Utterance Profiler
        • NLU Evaluation Tool
        • Utterance Conflict Detection
      • ASR Evaluation Tool APIs
        • Create an Annotation Set for Automatic Speech Recognition (ASR) API
        • Delete an Annotation Set for Automatic Speech Recognition (ASR) API
        • Delete Automatic Speech Recognition (ASR) Evaluation API
        • Get Annotation Set Automatic Speech Recognition (ASR) Contents API
        • Get Annotation Set Automatic Speech Recognition (ASR) Metadata API
        • Get Automatic Speech Recognition (ASR) Evaluation Results API
        • Get Automatic Speech Recognition (ASR) Evaluation Status API
        • List All Automatic Speech Recognition (ASR) Annotation Sets API
        • List Automatic Speech Recognition (ASR) Evaluations API
        • Post Automatic Speech Recognition (ASR) Evaluation API
        • Update Annotation Set Annotations for Automatic Speech Recognition (ASR) API
        • Update an Annotation Set Property for Automatic Speech Recognition (ASR) API
        • Automatic Speech Recognition (ASR) API Error Reference
      • Skill Development Notifications
        • Skill Development Notifications API Reference
        • Skill Development Event Schemas
      • Migration of SMAPI from v0 to v1
    • AWS Tools
    • Skill Flow Builder
  • Reference
  • Skill Developer Reference
    • Alexa Interface Reference
      • List of Alexa Interfaces
      • Interface Message Guide
      • Authorization Interface
      • Discovery Interface
        • Discovery Objects
        • Discovery Examples
      • EndpointHealth Interface
      • Response Events
      • ErrorResponse Events
        • AuthorizationController
        • Cooking
        • Safety
        • SecurityPanelController
        • ThermostatController
      • Property Schemas
      • Resources and Assets
    • Custom Skill Interface Reference
      • Request and Response JSON Reference
      • Request Types Reference
      • Interfaces
        • AudioPlayer Interface Reference
        • Dialog Interface Reference
        • Display Interface Reference
        • Display Template Reference
        • GadgetController Interface Reference
        • GameEngine Interface Reference
        • PlaybackController Interface Reference
        • VideoApp Interface Reference
    • SSML Reference
      • Best Practices for Using Amazon Polly Voices
      • Alexa Skills Kit Sound Library
      • Speechcons (Interjections)
        • English (AU)
        • English (CA)
        • English (IN)
        • English (US)
        • English (UK)
        • French (CA)
        • French (FR)
        • German (DE)
        • Hindi (IN)
        • Italian (IT)
        • Japanese (JP)
        • Portuguese (BR)
        • Spanish (MX)
        • Spanish (ES)
        • Spanish (US)
    • Alexa Skills Kit Object Schemas
      • Skill Manifest Schemas
      • Skill Manifest Examples
      • Schema Validation
      • Account Linking Schemas
      • Interaction Model Schemas
      • In-Skill Purchasing Schemas
      • Proactive Events Schemas

List Skills Overview

This section describes how to build a list skill for Alexa.

In this section

  • Steps to Create a List Skill
  • List Events in Alexa Skills
  • Create and Manage List Skills FAQ
  • Functional Testing for a List Skill
  • Certification Guidelines for List Skills
  • Submit an Alexa List Skill for Certification

  • In this section
Back To Top

Alexa Skills Kit

  • Alexa Skills Kit
  • Get Started
  • Get Deeper
  • Grow Your Business
  • What's New

ASK Resources

  • Tutorials & Code Samples
  • Documentation
  • Knowledge Base
  • Skill-Building Agencies

Device Makers

  • Overview

Alexa Built-in Devices

  • Overview
  • Development Resources
  • Business Resources
  • What's New

Alexa Connected Devices

  • Overview
  • Development Resources
  • Business Resources
  • What's New

Solution Providers

  • Overview

Agreements

  • Amazon Developer Services Agreement
  • Program Materials License Agreement
  • Mobile Ad Network Publisher Agreement
  • Mobile Ad Network Program Participation Requirements
  • Terms of Use
  • AVS Program Requirements
  • Works with Alexa Program Guidelines
  • Trademark Guidelines
  • Works with Alexa Trademark Usage Guidelines

Blogs

  • Alexa Skills Kit Blog
  • Device Makers Blog
  • Alexa Auto
  • AWS Blog

Support

  • Amazon Developer Support
  • Contact Us
  • Forums
Follow Us:
Amazon Alexa
Amazon business
Amazon Web Services
Amazon Dash Replenishment
English (US)
  • English (ANZ)
  • English (UK)
  • English (India)
  • Japanese (日本語)
  • French (Français)
  • Italian (Italiano)
  • German (Deutsch)
  • Spanish (España)
  • Spanish (México)
  • Portuguese (Brasil)
© 2010 - 2021, Amazon.com, Inc. or its affiliates. All Rights Reserved.
Terms Docs Forums Blog Alexa Developer Home
Terms Docs Forums Blog Alexa Developer Home