> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyperwisor.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Voice Assistants

> Connect your product with Amazon Alexa and Google Home.

The **Voice Assistants** tab (Deploy → Voice Assistant Integration) lets your
users control the product by voice through **Amazon Alexa** and **Google Home**.
You enable an integration, choose how devices are exposed, and map your product's
capabilities to voice traits.

## Enable an integration

Toggle **Amazon Alexa** and/or **Google Home** on for the product. A companion-app
preview shows how your devices will appear in the assistant's app as you configure.

## Device exposure mode

How your trait mappings are presented to the voice assistant:

| Mode                                 | Best for                                                                                                                            |
| ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------- |
| **Separate Devices**                 | Each mapping appears as its own device — multi-relay / multi-switch products (e.g. "Turn on Kitchen Light", "Turn off Bedroom Fan") |
| **Single Device, Multiple Controls** | All mappings grouped under one device — products combining power + brightness + color                                               |

## Device category

Set how your device appears in the assistant (e.g. **Light**, **Switch**,
**Other**) so it's categorized correctly in the user's app.

## Capability / trait mappings

Map the assistant's capabilities (traits) to your product's commands:

<Steps>
  <Step title="Add a mapping">
    Click **Add Mapping** to link a voice capability to one of your product's
    [commands](/studio/api-commands).
  </Step>

  <Step title="Preview">
    The **Companion App Preview** shows how end users will see these devices in
    the Alexa / Google Home app.
  </Step>

  <Step title="Save">
    Save the configuration for that assistant.
  </Step>
</Steps>

<Card title="Next: Metadata" icon="table-cells" href="/studio/metadata">
  Custom product attributes.
</Card>
