openHAB Skill for Amazon Alexa New Metadata Syntax Beta Test

We are planning to release a complete rework of the openHAB skill for Amazon Alexa which introduces a new device-centric metadata syntax in line with the other voice assistant integrations, and simplifies the configuration of basic functionalities, while staying backward compatible to ease the transition.

The new skill has now been deployed in beta test and we are looking for testers interested in upgrading early and providing some feedback. It doesn’t matter which OH version you are running.

Sign Up

If you are interested in signing up, please fill this form. If your Amazon account is subscribed to the beta testing promotional emails, you will receive an email invitation to the beta test from Amazon, otherwise, a link to the beta skills will be provided.


The first step once you accept the invitation is to trigger a discovery and confirm that all your existing Alexa-related configuration works without any issue and the backward compatibility is working as intended. It is important to note that tags support has been removed for OH3 with this update.

Once that part is successful, feel free to try the new metadata syntax. For OH3 users, keep in mind the current Main UI implementation doesn’t support the new syntax as of yet and that you will have to either use text file configuration or the code tab of the edit metadata graphical interface. Also, as a reminder, some capabilities may only be available in specific languages.


You can find the updated documentation here. If you have questions or comments related to it, feel free to reply below.

Issue Tracking

If you encounter some unexpected errors, please check the GitHub repository issue tracker for previously reported issues. If necessary, open a new one, prefixing its title with “[beta]” and including all the following information:

  • A brief summary of the issue you experienced and what you expected to achieve.

  • Any Alexa utterances you requested and the voice responses you received.

  • The item definition using code fences.

  • The exact time and time zone along with the country you are in to help us locate the relevant logs.