> For the complete documentation index, see [llms.txt](https://docs.carpose.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.carpose.de/wix-integration/01_getting-started.md).

# Getting Started

{% hint style="info" %}
This page is for embedding Carposé components on a **Wix** site. For plain HTML and other site builders, use the standard [React integration](https://docs.carpose.de/react-integration/01_getting-started.md).
{% endhint %}

## What you can embed

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

| Widget                          | Component                                                                                       |
| ------------------------------- | ----------------------------------------------------------------------------------------------- |
| Carposé Fahrzeugsuche           | [Vehicle Search Form](https://docs.carpose.de/vehicle-search-modules/01_vehicle-search-form.md) |
| Carposé Fahrzeugsuche (kompakt) | Compact search that forwards to the search page                                                 |
| Carposé Fahrzeug-Slider         | Vehicle slider                                                                                  |
| Carposé Fahrzeuggruppe          | [Vehicle Group](https://docs.carpose.de/vehicle-search-modules/06_vehicle-group.md)             |
| 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:

{% hint style="success" %}
**Install Carposé:** <https://www.wix.com/app-market/install/ccc0bb90-c381-4a93-92c6-9bab00f36945>
{% endhint %}

1. Open the [Carposé app in the Wix App Market](https://www.wix.com/app-market/install/ccc0bb90-c381-4a93-92c6-9bab00f36945) 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](https://docs.carpose.de/vehicle-search-modules/01_vehicle-search-form.md) 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](https://docs.carpose.de/vehicle-search-modules/06_vehicle-group.md#feature-switches).
* **Offer slider** — choose *Slider* (one large offer per slide) or *Kacheln* (cards in the look of the vehicle listings, three side by side); see [Tiles Variant](https://docs.carpose.de/offer-modules/01_offer-slider.md#tiles-variant).

## 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`.
