Add AR & VR to your website
Tatv XR is an embeddable augmented-reality and virtual-reality button for any website. You add one script tag; your visitors view your products and spaces in AR (dropped into their real room) or VR (full immersion) — with no app and no install. This page is the complete integration guide.
Quick start
Paste this once, just before your closing </body> tag, swapping in your API key and model URLs:
<!-- Tatv XR — AR/VR for your site -->
<script src="https://tatvxr.com/embed.js"
data-key="YOUR_API_KEY"
data-model="https://your-cdn/product.glb"
data-ios-src="https://your-cdn/product.usdz"
data-title="Your Product"
data-color="#e8b84b"></script>A floating View in AR / View in VR button appears on the page. Both options are always shown so no visitor is disoriented — they choose. Tatv hosts the rendering; you keep your brand.
Configuration attributes
Every option is a data-* attribute on the script tag.
| Attribute | Required | Description |
|---|---|---|
data-key | Yes | Your Tatv XR API key. Scoped to your domain and powers your usage dashboard. |
data-model | Yes | URL to your 3D model in .glb format. Used for the in-browser/VR view and for AR on Android. |
data-ios-src | Recommended | URL to a .usdz file for native AR on iPhone and iPad (Apple Quick Look). |
data-title | No | Accessible label for the model. Defaults to Product. |
data-color | No | Hex colour for the AR button to match your brand. Defaults to #e8b84b. |
data-position | No | bottom-right (default) or bottom-left. |
Supported 3D formats
- GLB — the primary format. Drives the in-browser viewer, VR/immersive mode, and AR on Android (Scene Viewer).
- USDZ — supply via
data-ios-srcfor native AR on iOS (Quick Look). Without it, iOS visitors still get the immersive VR view.
How AR and VR behave per device
| Device | AR | VR / immersive |
|---|---|---|
| iPhone / iPad | Quick Look (needs USDZ) | In-browser 3D view |
| Android | Scene Viewer (GLB) | In-browser 3D view |
| Desktop browser | — | Orbit / immersive 3D view |
| Meta Quest 3 | WebXR | Full Enter-VR immersion via WebXR |
Triggering AR/VR from your own buttons
The embed exposes a small API so you can open AR or VR from any element on your page:
<button onclick="window.TatvXREmbed.openAR()">View in AR</button>
<button onclick="window.TatvXREmbed.openVR()">View in VR</button>Privacy
The embed sends a best-effort, non-blocking usage ping (event type, your key, and host) so your dashboard can show engagement. No visitor personal data is collected by the widget. Telemetry failures never break your page.
Frequently asked questions
Do visitors need an app?
No. AR uses the phone's built-in viewer (iOS Quick Look, Android Scene Viewer) and VR runs in any browser, with full immersion on Meta Quest via WebXR.
How is this different from using Google's model-viewer directly?
Tatv XR is a managed, domain-scoped service: one hosted script, a usage dashboard, brand styling, and both AR and a true immersive VR mode — so you skip building, hosting, and maintaining a custom WebXR integration.
What does it cost?
Start with a partner trial. Request an API key and we'll get your button live.