> 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/components/05_vehicle-similarity-slider.md).

# Vehicle Similarity Slider

{% hint style="info" %}
The Vehicle Similarity Slider shows vehicles similar to a given vehicle — a "you may also like" carousel.
{% endhint %}

## Introduction

The `vehicle-similarity-slider` component fetches vehicles similar to a reference vehicle (based on its specifications) and renders them in a responsive carousel with bullet pagination.

## Basic Usage

```html
<div
  data-carpose-component="vehicle-similarity-slider"
  data-api-key="your-api-key"
  data-id="your-vehicle-id"
></div>
```

## Attributes

| Attribute                | Required | Description                                                  |
| ------------------------ | -------- | ------------------------------------------------------------ |
| `data-carpose-component` | Yes      | Must be `vehicle-similarity-slider`                          |
| `data-api-key`           | Yes      | API key for authentication with the Carposé backend services |
| `data-id`                | Yes      | ID of the reference vehicle to find similar vehicles for     |

## Behavior

* Fetches similar vehicles from the API based on the reference vehicle's specifications
* Renders a carousel with bullet pagination — 3 slides per view on desktop, 1 on mobile
* Each card links to the corresponding vehicle detail page

## Notes

* Requires a valid `data-id`; nothing is shown if there are no similar vehicles
* Pairs well with a vehicle detail page


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.carpose.de/components/05_vehicle-similarity-slider.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.