Skip to main content

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

ParameterTypeDescription
locationIdnumberTour 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 modeParams usedDescription
pointspointIdJump to a tour point by id
cyclescycleId + viewIdJump 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.

ParameterTypeDescription
pointIdnumberStart at this tour point (if navigation mode is "points")
cycleIdnumberStart cycle (if navigation mode is "cycles"; use with viewId)
viewIdnumberStart view within the cycle (if navigation mode is "cycles"; use with cycleId)
startYawnumberInitial camera yaw (degrees)
startPitchnumberInitial camera pitch (degrees)

Custom appearance

ParameterTypeDescription
hideStartbooleanSkip the start screen
hideMinimapbooleanHide the minimap
hideCTAbooleanHide the call-to-action button
hideUnitPreviewsbooleanHide unit preview cards
locationNamestringLocation name override
arrowsbooleanShow navigation arrows
fullscreenbooleanStart in fullscreen
uiColorstringUI accent color (CSS color, e.g. #38bdf8)
presetstringUI preset
isolatebooleanIsolate mode
locationlistnumberListComma-separated location IDs for the locations bar

Value types

  • boolean — Only the literal string true turns 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,5772 for locationlist).

Empty or blank values are omitted from the URL.