Interactions, Effects & Popups
The interaction system lets you define behaviors that fire in response to user actions or scene events. Each interactable element can have multiple interactions, and each interaction can trigger effects, popups, state transitions, or voice chat.
Overview
Use the toolbar to add interactions and effects to a selected element:
- Interaction — bind a trigger event to behaviors (effects, popups, state changes, voice chat)
- Effect — add a visual effect that plays when a trigger fires
- Popup — create a content, form, gallery, or link popup triggered by user events
Triggers
Each interaction is bound to a trigger — the event that activates it:
| Trigger | Icon | When it fires |
|---|---|---|
| Load | When the element loads into the scene | |
| Click | When the user clicks or taps the element | |
| Hover | When the user's cursor moves over the element | |
| Animation End | When an animation effect finishes playing | |
| Animation Loop | Each time an animation completes one loop | |
| Marker Found | When an XR marker image is detected by the camera | |
| Marker Lost | When the XR marker image leaves the camera frame |
Marker triggers are only available on XR Marker elements.
Effects
Effects animate element properties when a trigger fires. Select an element and click in the toolbar to add an effect.
Popups
Popups present content to the user when triggered. Select an element and click to add a popup.
Popups are fully supported in AR/VR modes and are rendered through OwnXR's user interface for immersive experiences.
Voice Chat
Voice Chat attaches a real-time AI voice assistant to an interactable element. Visitors click the element to start speaking with the AI in natural conversation.
- Select an interactable element and click Voice Chat in the toolbar or access via Interaction panel
- Configure the context — a system prompt defining the assistant's persona and knowledge scope
- Set an opening greeting message when the session starts, can be custom, AI-generated or disabled
- Choose a voice model for the AI's speech output
Credits are consumed per active voice session. See Interactions, Effects & Popups for full setup details.
Voice Chat requires the microphone browser permission. When embedding in an iframe, include microphone in the allow attribute. See Saving & Publishing.
Voice Chat requires a paid subscription and consumes AI credits per session. See AI Generation for credit details.
Scene States
Scene states let you define multiple element configurations that users can switch between — useful for product variants, guided tours, or branching narratives.
- Open the Scene Panel to create, rename, and delete states
- Each state stores its own element list — elements can be added, hidden, or have different settings per state
- Set the start state to control which configuration loads first
- Use an interaction with any trigger to switch states and guide visitors through your experience
Scene states are available on all plans. Combine them with Click interactions to build interactive showcases and guided presentations.