Deep linking

Deep links let you send visitors straight to specific content in AudioGuideKit. Use them on signage, printed brochures, or QR codes.

URL structure

The tourId matches the id field in your metadata.json. The stopId is the numeric ID from each stop in your tour JSON (e.g., 1, 2, 3).

Linking to tours

https://yoursite.com/tour/barcelona

This shows the tour overview with title, description, cover image, and "Start tour" button.

Linking to stops

https://yoursite.com/tour/barcelona/8

When visitors open a stop link:

1. The tour loads (if not already cached)
2. Navigation jumps to the specified stop
3. Audio begins automatically (browser permitting)

Pre-selecting language

Use the ?lang= parameter to set the tour language via URL:

https://yoursite.com/tour/barcelona?lang=de

This is useful for venues with multilingual visitors. Create separate QR codes for each language:

The language parameter:

• Takes priority over browser language detection
• Is saved to the visitor's preferences for the session
• Works on both tour and stop URLs (/tour/museum/3?lang=de)
• Is case-insensitive (?lang=DE works the same as ?lang=de)

Example: Multiple entry points

A museum with QR codes at each section:

Tracking with UTM parameters

Add tracking parameters without breaking the deep link:

https://yoursite.com/tour/barcelona/3?utm_source=signage&utm_medium=qr

AudioGuideKit ignores unknown query parameters, so UTM codes won't affect functionality.

Invalid links

Offline behavior

Deep links work offline after the tour is downloaded. If a visitor is offline and hasn't downloaded the tour, the tour will fail to load.