Styling with URL Parameters
URL parameters let you open the Customizer with predefined visual settings and product options without changing your embed code.
The Customizer reads these parameters on load and applies them to the workspace background, 3D environment, lighting intensity, and variant selection. URL-selected variants are resolved using WooCommerce attribute and term mappings.
Custom colors:
For products with custom-color variants, you can request the custom color and pass picked color values directly in the URL. Encode # as %23 inside query values.
List of available URL parameters
| Parameter | Type | Description | Default value |
|---|---|---|---|
bcg | string | Customizer background mode: grad_f6f7fb_e8fff6, app_img_123, or env. The env mode uses the selected environment preview as the workspace background. | Design/theme default |
env | int | Runtime environment ID. It selects the HDRI environment for the 3D canvas and, with bcg=env, also selects the environment preview background. | Design/default |
light_intensity | 0 - 2 | Environment light intensity for the 3D canvas. Values outside the range are clamped. | Design/default |
bcg_blur | 0 - 100 | Blur applied to image-style Customizer backgrounds, including app_img_* and bcg=env preview backgrounds. | 0 |
bcg_brightness | 0 - 3 | Brightness for image-style Customizer backgrounds. | 1 |
bcg_underlay | string | Gradient underlay behind image-style backgrounds, e.g. grad_ffffff_f5f7fb. | Design/theme default |
attribute_pa_* | string | Preselect a WooCommerce product attribute term. Accepted key forms include attribute_pa_color, pa_color, and color; supported aliases include size, color, material, print type, and pattern. | |
custom_color | 0 / 1 / true | Requests the custom-color variant when the product supports one. The same can be triggered with color=custom. | 0 |
picked_colors | string | Comma-separated custom-color overrides in the format detailKey:%23hex, e.g. front:%23ff6b6b,back:%2300ff88. The # character must be URL-encoded as %23. |