Player URL parameters
The Seenic player reads query parameters on the iframe URL to set the initial tour location, camera pose, and UI appearance. These are separate from the Player External API postMessage methods—you set them once when loading the iframe.
Example
<iframe
src="https://tour.seenic.io/?locationId=6624&hideStart=true&pointId=3&startYaw=90"
></iframe>
Try combinations interactively on the Sandbox URL parameters tab.
Required
| Parameter | Type | Description |
|---|---|---|
locationId | number | Tour location to load |
Optional parameters
Start positioning
Each location has a navigation mode configured on the server (points or cycles). Which start-position params apply depends on that mode:
| Navigation mode | Params used | Description |
|---|---|---|
points | pointId | Jump to a tour point by id |
cycles | cycleId + viewId | Jump to a cycle view (both required) |
If the URL params do not match the location's navigation mode, the player falls back to the location's default start point.
| Parameter | Type | Description |
|---|---|---|
pointId | number | Start at this tour point (if navigation mode is "points") |
cycleId | number | Start cycle (if navigation mode is "cycles"; use with viewId) |
viewId | number | Start view within the cycle (if navigation mode is "cycles"; use with cycleId) |
startYaw | number | Initial camera yaw (degrees) |
startPitch | number | Initial camera pitch (degrees) |
Custom appearance
| Parameter | Type | Description |
|---|---|---|
hideStart | boolean | Skip the start screen |
hideMinimap | boolean | Hide the minimap |
hideCTA | boolean | Hide the call-to-action button |
hideUnitPreviews | boolean | Hide unit preview cards |
locationName | string | Location name override |
arrows | boolean | Show navigation arrows |
fullscreen | boolean | Start in fullscreen |
uiColor | string | UI accent color (CSS color, e.g. #38bdf8) |
preset | string | UI preset |
isolate | boolean | Isolate mode |
locationlist | numberList | Comma-separated location IDs for the locations bar |
Value types
- boolean — Only the literal string
trueturns a flag on. Omit the parameter or use any other value to leave it off. - number — Parsed with
parseFloat. - numberList — Comma-separated numbers (e.g.
6624,5772forlocationlist).
Empty or blank values are omitted from the URL.