Customization

The VirtualCar360 Player and Player 360 can be configured using URL parameters. Parameters control gallery lookup, language, autoplay, HUD behavior, background color, slide mode, other vehicles and interior image display.

Passing configuration

Most configuration is passed as query string parameters:

https://virtualcar360.pl/player/?key=YOUR_KEY&carId=10209937&bg=black&autoplay=true

In selected Player variants, the key and vehicle identifier can also be passed in the URL path:

https://player360-staging.web.app/dealers/{key}/cars/{carId}

Example:

https://player360-staging.web.app/dealers/2f2b265625d76a6704b08093c652fd79/cars/10209937?ann_dealer_id=72&ann_show_more=true&bg=aaa

Vehicle identification

The Player can load a vehicle presentation using:

carId,
vin,
numberPlates,
numberplates.

carId is the most precise method because it points to a specific Player presentation. If carId is not available, use VIN or registration number to automatically load the latest Player available for the vehicle.

Tip

For offer listings, VIN or registration number is usually the most convenient lookup method because these values are already available in the customer's system.

Configuration parameters

Parameter	Default value	Description
`key`	`''`	Image-set key. It can also be passed as a path parameter.
`carId`	`''`	Internal Player identifier. Points to a specific vehicle presentation.
`vin`	`''`	Alternative lookup by VIN.
`numberPlates`	`''`	Alternative lookup by registration number.
`numberplates`	`''`	Alias for `numberPlates`.
`lang`	browser language, fallback `en`	Interface language. Supported values: `bg`, `hr`, `cs`, `da`, `nl`, `en`, `et`, `fi`, `fr`, `de`, `el`, `hu`, `it`, `lv`, `lt`, `mt`, `pl`, `pt`, `ro`, `sk`, `sl`, `es`, `sv`.
`autoplay`	`true`	Enables autoplay.
`hudhide`	`5`	Controls HUD visibility. `-1` means always visible, `0` means hidden, a positive number means seconds before hiding after no interaction.
`bg`	`#000`	Player background color. Accepts CSS-compatible values such as `bg=fff`, `bg=black`, `bg=%23000000`. Invalid values fall back to `#000`.
`slide_mode`	`auto`	Photo sliding mode. Supported values: `auto`, `basic`, `carousel`, `swipe`. Invalid values fall back to `auto`.
`ann_dealer_id`	`''`	Dealer ID for the Other vehicles section. If missing or not numeric, the button is not displayed.
`ann_show_more`	`false`	Displays a large preview in the center of the screen when hovering over a vehicle thumbnail in Other vehicles.
`interior_fullscreen`	`true`	Displays 2:1 interior images as `cover` relative to the browser window.

Examples

Minimal configuration by `carId`

https://virtualcar360.pl/player/?key=YOUR_KEY&carId=10209937

Lookup by VIN

https://virtualcar360.pl/player/?key=YOUR_KEY&vin=1NKCLR0X1XR568641

Lookup by registration number

https://virtualcar360.pl/player/?key=YOUR_KEY&numberPlates=WW4433E

Polish interface and white background

https://virtualcar360.pl/player/?key=YOUR_KEY&carId=10209937&lang=pl&bg=%23ffffff

Player with other vehicles

https://virtualcar360.pl/player/?key=YOUR_KEY&carId=10209937&ann_dealer_id=72&ann_show_more=true

HUD always visible

https://virtualcar360.pl/player/?key=YOUR_KEY&carId=10209937&hudhide=-1

HUD hidden

https://virtualcar360.pl/player/?key=YOUR_KEY&carId=10209937&hudhide=0

Best practices

Pass only one vehicle identifier: carId, vin or numberPlates.
Use carId when you need to point to a specific Player.
Use VIN or registration number for easy connection with offer data.
Use loading="lazy" when many Players are embedded on a listing page.
Use ann_dealer_id only when the Other vehicles section should be available.
Encode # as %23 when using HEX colors in bg.