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

# Kiosk Deployment

> Deploy your Receptionist Avatar kiosk to a tablet or touchscreen device

## Overview

Deploying the Receptionist Avatar kiosk is straightforward — open a URL on any device with a web browser. No app installation or embed code required.

## Getting the Kiosk URL

1. Navigate to your Receptionist Avatar's **Playground** page
2. The **Deploy Kiosk** section is displayed at the top of the Playground page for quick access — no scrolling required.
3. Copy the kiosk URL:

```
https://your-domain.com/a/[publicKey]
```

The public key is an 8-character identifier unique to your agent (e.g., `/a/6bbfebeb`).

<Tip>
  Click the copy button to copy the URL to your clipboard, or click "Open Kiosk in New Tab" to preview it in your browser.
</Tip>

***

## Setting Up the Device

### Basic Setup

<Steps>
  <Step title="Open the URL">
    Navigate to the kiosk URL in the device's web browser.
  </Step>

  <Step title="Enter full-screen mode">
    Use the browser's full-screen mode (usually F11 on desktop, or the kiosk/guided access mode on tablets).
  </Step>

  <Step title="Test the flow">
    Tap through the visitor flow to verify language selection, contact search, and calling work correctly.
  </Step>

  <Step title="Lock the device">
    Use your device's kiosk mode or guided access to prevent visitors from navigating away.
  </Step>
</Steps>

### iPad / iOS

1. Open Safari and navigate to the kiosk URL
2. Go to **Settings → Accessibility → Guided Access**
3. Enable Guided Access
4. Return to Safari and triple-click the side button to start Guided Access
5. This locks the device to the kiosk screen

### Android Tablets

1. Open Chrome and navigate to the kiosk URL
2. Use your device's **Kiosk Mode** or a kiosk lockdown app (e.g., SureLock, KioWare)
3. Alternatively, use **Screen Pinning** from Settings → Security

### Desktop / Wall Display

1. Open Chrome or any modern browser
2. Navigate to the kiosk URL
3. Press **F11** for full-screen mode
4. Consider using Chrome's `--kiosk` flag for a locked-down experience:

```bash theme={null}
chrome --kiosk https://your-domain.com/a/[publicKey]
```

***

## Orientation

The kiosk automatically adapts to the screen orientation:

| Orientation   | Layout                                       | Best For                             |
| ------------- | -------------------------------------------- | ------------------------------------ |
| **Portrait**  | Vertical layout with stacked elements        | Tablet stands, wall-mounted displays |
| **Landscape** | Horizontal layout with side-by-side elements | Desk screens, reception counters     |

<Note>
  Orientation is determined by the device screen, not a saved setting. The same URL works on any orientation. You can preview both orientations in the Playground.
</Note>

***

## Testing

Before going live, verify:

| Check                  | How to Test                                                             |
| ---------------------- | ----------------------------------------------------------------------- |
| **Attract screen**     | Leave the kiosk idle — it should show your branding and avatar          |
| **Language selection** | Tap to start and verify available languages                             |
| **Contact search**     | Search for a contact by name, phone, or email                           |
| **Calling flow**       | Select a contact and verify the call/notification flow                  |
| **Return to idle**     | After the goodbye screen, the kiosk should return to the attract screen |
| **Theme and colors**   | Verify your brand colors, logo, and theme look correct                  |

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Kiosk shows a blank page" icon="circle-exclamation">
    **Possible causes:**

    * Invalid or expired public key
    * Network connectivity issues
    * Browser blocking JavaScript

    **Solutions:**

    * Verify the URL matches what's shown in the Playground
    * Check the device has internet access
    * Try a different browser
  </Accordion>

  <Accordion title="Contact search returns no results" icon="magnifying-glass">
    **Possible causes:**

    * No contacts have been added
    * Search term doesn't match any contacts

    **Solutions:**

    * Add contacts from the Contacts page in the dashboard
    * Verify contacts have been saved successfully
  </Accordion>

  <Accordion title="Kiosk doesn't return to attract screen" icon="rotate-left">
    **Possible causes:**

    * The visitor flow may be waiting for input
    * Browser may have cached a state

    **Solutions:**

    * Refresh the page to reset to the attract screen
    * The kiosk auto-returns after the goodbye screen with a timeout
  </Accordion>

  <Accordion title="Wrong orientation" icon="mobile">
    **Possible causes:**

    * Device orientation lock is enabled

    **Solutions:**

    * Disable orientation lock on the device
    * Rotate the device to the desired orientation
    * The kiosk adapts automatically
  </Accordion>
</AccordionGroup>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Manage Contacts" icon="address-book" href="/receptionist/contacts">
    Add or update the employee directory for your kiosk.
  </Card>

  <Card title="Customize Styling" icon="palette" href="/receptionist/styling">
    Adjust the kiosk theme, colors, and avatar.
  </Card>

  <Card title="View Analytics" icon="chart-line" href="/receptionist/analytics">
    Monitor kiosk usage and visitor interactions.
  </Card>

  <Card title="Agent Overview" icon="robot" href="/agents/overview">
    Learn about Cosmo channels and core concepts.
  </Card>
</CardGroup>