Getting Started

This page is for embedding Carposé components on a Wix site. For plain HTML and other site builders, use the standard React integration.

What you can embed

The Carposé app adds these widgets to the Wix Editor:

Widget	Component
Carposé Fahrzeugsuche	Vehicle Search Form
Carposé Fahrzeugsuche (kompakt)	Compact search that forwards to the search page
Carposé Fahrzeug-Slider	Vehicle slider
Carposé Fahrzeuggruppe	Vehicle Group
Carposé Angebots-Slider	Offer slider
Carposé Angebot	Single offer
Carposé Mitarbeiterliste	Employee list
Carposé Mitarbeiter	Single employee

Other Carposé components remain available through the standard data-carpose-component embed on non-Wix pages.

Install from the Wix App Market (recommended)

The easiest way to add Carposé to a Wix site is to install the app from the Wix App Market:

Install Carposé: https://www.wix.com/app-market/install/ccc0bb90-c381-4a93-92c6-9bab00f36945

1. Open the Carposé app in the Wix App Market and add it to your site.

2. In the Wix Editor, add the Carposé vehicle search widget to the page where you want it.

3. Open the widget's settings panel and enter your Carposé API key, plus any options you want to enable.

Configuration

All options are set through the widget's settings panel — you don't edit HTML directly.

• API key — enter it once: every further Carposé widget on the same site takes it over when its settings panel is opened. The key is remembered in the browser you edit with, so on another computer it has to be entered once more. A widget that already has a key keeps it.

• Vehicle search — the panel exposes the same options as the standard search form: feature toggles (wishlist, comparison, history, AI assistant, financing rates, price and wish alert, …), layout (filter drawer, sticky result bar, card layout), routing and the listing URL form. Leaving a toggle on Auto falls back to your Carposé account default. See the Vehicle Search Form for what each option does.

• Vehicle group, offer, offer slider — pick the group or offer from a list loaded from your Carposé account instead of typing an id. Only published offers are listed.

• Vehicle group — choose Raster (grid with count, sorting and payment type) or Slider (no controls), the card layout, and wishlist, comparison, history and price alert as Auto / Ein / Aus. Auto uses the switches set on the group in the Carposé admin, not the vehicle search settings; see Feature switches.

Manual setup (Custom Element)

If you'd rather not use the App Market, you can add a widget as a Wix Custom Element manually:

1. In the Wix Editor, add a Custom Element widget to your page.

2. Set its Server URL to:

   https://integration.carpose.app/integration-wix.js

   This registers the elements under their tags, e.g. <carpose-vehicle-search> or <carpose-vehicle-group>.

3. Open the widget's settings and enter your Carposé API key and options.

Editor vs. published site

In the Wix Editor, each widget shows a small placeholder (e.g. "Carposé Fahrzeugsuche") instead of the live component — the editor runs custom elements in a sandbox where it can't fully load. On the published site (and in Wix Preview) the real component loads normally. This is expected and needs no configuration.

Notes

• Place only one vehicle search per page.

• For manual Custom Element setup, use the Wix-specific loader URL (integration-wix.js) as the Server URL — not the standard integration.js.