iConfigure

English

Nederlands

English

Nederlands

Switch to dark theme

URL parameters ​

URL parameters pre-configure a product when the configurator loads. They work in both:

Base URL ​

text
https://configurator.iconfigure.io/?product=YOUR_PRODUCT_ID
  • product is the product UUID from Manager.

Dealer products ​

Dealer embeds use dealer=<dealer_product_id> (copied from Manager). Example:

text
https://configurator.iconfigure.io/?dealer=YOUR_DEALER_PRODUCT_ID

Language ​

Use lang to force the content language:

text
https://configurator.iconfigure.io/?product=UUID&lang=de
  • Use a lowercase language code published for the company (de, en, fr, …), or lang=auto to detect the visitor's browser language.
  • The value is checked against the company's published languages. A code that is not published is not replaced by the default: the configurator shows the message No language is set for this configurator. instead of the product.
  • With lang=auto, or without lang, the company default language is used when the visitor's language is not published.
  • For companies with more than one published language, the configurator adds the resolved lang to the address bar, so a copied link opens in the same language.
  • In script inject the language can also be passed via injectApp; the ?lang= URL parameter always takes precedence.

Compositions ​

Use pre_config to open a saved composition:

text
https://configurator.iconfigure.io/?product=UUID&pre_config=COMPOSITION_ID

The Full URL button on a composition gives you this URL (with dealer= for dealer products). When pre_config loads, feature parameters in the same URL are ignored.

Feature parameters ​

Each configurable feature has an ID set in Product Editor (e.g. material, width, hoogte_sparing). Pass the feature ID as the key.

Examples:

text
https://configurator.iconfigure.io/?product=UUID&material=oak&width=120

Feature parameters are applied on top of the product's starting configuration. An option ID that does not exist on the feature is ignored.

Single selection ​

featureId=subfeatureId

Multiple selection ​

Use a comma-separated list:

text
featureId=subIdA,subIdB,subIdC

Options that are not in the list are deselected.

Number inputs ​

Use the numeric value as a string:

text
width=120

Reserved parameters (verified) ​

These keys are not treated as feature IDs:

  • product, product_id
  • dealer
  • quotation
  • pre_config
  • mode, logic, theme, perf
  • active_step
  • dev_url, poster, hide_visualizer
  • items
  • lang

active_step

active_step is present in the URL generator, but it is not applied on load in the current code. Do not rely on it for deep-linking.

Finding feature IDs ​

  1. Manager → Configurations → open the product. The product editor opens.
  2. Select a feature in the structure tree — the ID field on the right is the query parameter name.
  3. For a selection, use the ID of the option (subfeature) as the value.

See Product editor for how steps, features and options relate.

Further reading ​