> 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 the Carposé vehicle search on a **Wix** site. For plain HTML and other site builders, use the standard [React integration](/react-integration/01_getting-started.md).
{% endhint %}

## What you can embed

On Wix, the Carposé **vehicle search** is available as a widget. The 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. At a minimum, set your **API key**. The panel also exposes the same feature toggles as the standard search form (wishlist, comparison, history, AI assistant, financing rates, contextual counts, a forwarding URL for results, theme colors, and so on). Leaving a toggle unset falls back to your Carposé account default.

See the [Vehicle Search Form](/vehicle-search-modules/01_vehicle-search-form.md) for what each feature does.

## Manual setup (Custom Element)

If you'd rather not use the App Market, you can add the search 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 element under the tag `<carpose-vehicle-search>`.
3. Open the widget's settings and enter your Carposé **API key** and options.

## Editor vs. published site

In the Wix **Editor**, the widget shows a small placeholder ("Carposé Fahrzeugsuche") instead of the live search — the editor runs custom elements in a sandbox where the search can't fully load. On the **published site** (and in Wix Preview) the real vehicle search 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`.