Frequently Asked Questions¶

Common questions and answers about WebXR Gallery.

General Questions¶

What is WebXR Gallery?¶

WebXR Gallery is a platform for creating immersive 360° virtual reality experiences. You can build virtual tours, product showcases, training environments, and more using panoramic images or videos.

What browsers are supported?¶

What VR headsets work?¶

All major WebXR-compatible headsets:

• Meta Quest (Quest 2, Quest 3, Quest Pro)
• Pico (Neo 3, Pico 4)
• Apple Vision Pro
• HTC Vive (via SteamVR browser)
• Valve Index (via SteamVR browser)
• Windows Mixed Reality

Is it free to use?¶

Yes! We offer a free tier with:

• 2 sequences
• 3 stages per sequence
• Image skyboxes only
• Basic features

Upgrade to Basic, Pro, or Enterprise for more features.

Content Questions¶

What image format should I use?¶

Requirements:

• Format: JPEG or PNG (JPEG recommended for smaller files)
• Projection: Equirectangular (2:1 aspect ratio)
• Minimum size: 4096x2048 pixels
• Recommended: 8192x4096 for high quality
• Maximum: 16384x8192 (8K)

What video formats are supported?¶

Supported formats:

• MP4 (H.264, H.265)
• WebM (VP9)

After upload:

• Videos are automatically transcoded via Mux
• HLS streaming is generated for adaptive quality
• MP4 fallback for older browsers

How do I create 360° images?¶

Options:

1. 360° Camera: Ricoh Theta, Insta360, GoPro Max
2. Smartphone apps: Google Street View, 360 Panorama
3. DSLR + stitching: PTGui, Hugin
4. 3D rendering: Blender, Unity

What's the maximum file size?¶

Hotspot Questions¶

What hotspot types are available?¶

How do I position hotspots?¶

Option 1: Click-to-place

1. Click "Add Hotspot in Preview"
2. Click anywhere in the 360° view
3. Hotspot is placed at that position

Option 2: Manual coordinates

Enter X, Y, Z coordinates directly. The coordinate system:

• X: Left (-) / Right (+)
• Y: Down (-) / Up (+)
• Z: Behind (-) / Front (+)

Can hotspots play video?¶

Not currently. Info hotspots support:

• Text (title, description)
• Images

Audio hotspots support:

• Audio files (MP3, WAV, OGG)

Video in hotspots is planned for a future release.

How do I make hotspots visible in VR?¶

Hotspots automatically adapt to VR:

• Render as 3D spheres in space
• Highlight on controller raycast hover
• Activate with trigger button
• Info panels display in 3D GUI plane

Navigation Questions¶

What portal styles are available?¶

Navigation hotspots can use different visual effects:

Can I mix portal styles?¶

Yes! Each navigation hotspot can have its own portal style. You can mix different styles in the same stage for different visual effects.

How do I set up the mini map?¶

1. Enable Mini Map in sequence settings
2. For each stage, set X/Y coordinates on the map
3. Optionally upload a custom map background image
4. User position updates automatically during navigation

Technical Questions¶

Why isn't VR mode working?¶

Common causes:

1. Not using HTTPS: WebXR requires secure context
2. Browser not supported: Check browser compatibility
3. Permissions denied: Allow XR in browser settings
4. No headset connected: Ensure headset is detected

Solution:

// Check WebXR support
if ('xr' in navigator) {
  navigator.xr.isSessionSupported('immersive-vr')
    .then(supported => console.log('VR supported:', supported));
}

Why are my images blurry?¶

Possible causes:

1. Source resolution too low: Use at least 4K (4096x2048)
2. Compression artifacts: Use high-quality JPEG (90%+)
3. Wrong projection: Must be equirectangular
4. Browser caching: Clear cache and reload

Why is audio not playing?¶

Browser autoplay policies:

Browsers block audio autoplay. Audio will play after user interaction:

1. User clicks/taps anywhere on page
2. User enters VR mode
3. User clicks a hotspot

We handle this automatically with Babylon.js audio unlock.

How do I fix CORS errors?¶

See CORS Troubleshooting Guide for detailed solutions.

Quick fix:

Ensure your media URLs have proper CORS headers:

Access-Control-Allow-Origin: *

Account & Billing¶

How do I upgrade my plan?¶

1. Go to Dashboard → Settings → Subscription
2. Click "Upgrade"
3. Select your plan
4. Complete payment via Stripe

Can I cancel my subscription?¶

Yes, cancel anytime:

1. Go to Dashboard → Settings → Subscription
2. Click "Manage Subscription"
3. Click "Cancel Subscription"

You'll retain access until the billing period ends.

What happens to my content if I downgrade?¶

• Existing content remains
• You can't create new content beyond the lower tier limits
• No content is deleted automatically

Do you offer refunds?¶

Yes, within 14 days of initial purchase or upgrade. Contact support.

Privacy & Security¶

Where is my data stored?¶

• Files: Google Cloud Storage (Firebase)
• Database: Firebase Firestore
• Videos: Mux (for transcoding/streaming)
• Payments: Stripe (PCI compliant)

Is my content private?¶

You control visibility:

• Public: Anyone with link can view
• Unlisted: Link only, not searchable
• Private: Password protected

Do you track visitors?¶

Optional analytics track:

• View counts
• Session duration
• Device types
• Geographic regions

No personal data is collected unless you enable lead capture.

Integration Questions¶

Can I embed experiences on my website?¶

Yes! Use an iframe:

<iframe
  src="https://webxrgallery.com/viewer/YOUR_ID"
  width="100%"
  height="600"
  allow="xr-spatial-tracking; fullscreen; autoplay"
></iframe>

Is there an API?¶

Yes, the viewer exposes a JavaScript API:

const viewer = document.querySelector('webxr-viewer');
viewer.goToStage('gallery');
viewer.enterVR();

Full API documentation coming soon.

Can I use custom domains?¶

Yes, on Pro and Enterprise plans:

1. Add your domain in sequence settings
2. Configure DNS CNAME record
3. SSL is automatically provisioned

Still Have Questions?¶

• Documentation: Browse the sidebar
• GitHub Issues: Report bugs
• Discussions: Ask the community
• Email: support@webxrgallery.com