> 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/events/08_deprecated-events.md).

# Deprecated Events

This page exists purely to help integrators find the replacement for an old event name. **This page documents removal, not deprecation in the usual sense**: as of this release, none of the event names below are emitted by Carposé anymore. There is no fallback, no dual-dispatch period, and no console warning. They are listed here only so a dealer grepping their GTM/GA4 configuration for an old trigger name can find what to change it to.

This page is expected to be removed from the documentation in v3.0, matching the deprecation convention used for the `CAR_*` `ComponentType` aliases (see `ComponentTypes.ts`).

## Two Breaking Changes

If you have a live GTM, GA4, or custom listener wired to any event or field named below, **it will silently stop recording the moment this version deploys** — there is no error, no console warning, nothing to alert you. Both of the following ship together in this release:

1. **Every old event name is gone.** Not renamed-with-an-alias, not deprecated-with-a-warning — simply no longer dispatched. See the mapping table below for the replacement.
2. **`detail.type` changed from `"car"` to `"vehicle"`.** Any logic that branches on `event.detail.type === 'car'` needs to branch on `'vehicle'` instead.

`detail.data` itself keeps its previous shape for equivalent events, so code that reads fields like `event.detail.data.name` continues to work unchanged — it is the event *name* and the envelope's `type` field that changed, not the payload shape.

**Action required:** update every listener and every GTM/GA4 trigger to the new event names before deploying this version, or tracking for that interaction goes dark with no warning.

## Old Name → New Name Mapping

| Old name                                                                             | New name                               | Notes                                                                                                                                                                                   |
| ------------------------------------------------------------------------------------ | -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `carpose-car-select`                                                                 | `carpose-vehicle-select`               |                                                                                                                                                                                         |
| `carpose-car-contact-phone`                                                          | `carpose-vehicle-contact-phone`        |                                                                                                                                                                                         |
| `carpose-car-contact-email`                                                          | `carpose-vehicle-contact-mail`         | Also note the `-email` → `-mail` action rename.                                                                                                                                         |
| `carpose-car-contact-whatsapp`                                                       | `carpose-vehicle-contact-whatsapp`     |                                                                                                                                                                                         |
| `carpose-car-contact-modal-open`                                                     | `carpose-vehicle-contact-form-open`    | The contact UI is a form flow now, not a single modal.                                                                                                                                  |
| `carpose-car-contact`                                                                | `carpose-vehicle-contact-form-success` | The success point of the contact form flow — see [Vehicle Search](/events/02_vehicle-search.md#vehicle-contact-form-success-event).                                                     |
| `carpose-offer-select`                                                               | `carpose-offer-select` (unchanged)     | The name is unchanged, but the envelope is now v2 — see [Introduction](/events/01_introduction.md#the-v2-envelope).                                                                     |
| `carpose-offer-contact`                                                              | `carpose-offer-contact-form-success`   | See [Offer](/events/06_offer.md#offer-contact-form-success-event).                                                                                                                      |
| `carpose-de-exterior-viewer-loaded`                                                  | `carpose-vehicle-viewer-load`          | Also moves under the `vehicle` entity — see [Vehicle Search](/events/02_vehicle-search.md#vehicle-viewer-load-event).                                                                   |
| `carpose-de-exterior-no-viewer-available`                                            | `carpose-vehicle-viewer-unavailable`   |                                                                                                                                                                                         |
| `carpose-de-<type>-no-view-available` (e.g. `carpose-de-interior-no-view-available`) | `carpose-vehicle-viewer-unavailable`   | Both of the old per-viewer-type "unavailable" events collapse into one event; use `data.viewer` to tell viewer types apart — see [Vehicle Search](/events/02_vehicle-search.md#viewer). |

## Internal Command Rename

| Old name                      | New name                               | Notes                                                                                                                                                                                                                              |
| ----------------------------- | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `carpose-preset-vehicle-type` | `carpose-internal-preset-vehicle-type` | Moved into the reserved `carpose-internal-*` namespace. This was never a public tracking event and is now explicitly marked as such — **do not track it**. See [Introduction](/events/01_introduction.md#internal-command-events). |

## Events With No Old Equivalent

Everything else in the [Vehicle Search](/events/02_vehicle-search.md), [Offer](/events/06_offer.md) and [Store, Employee & UI](/events/07_store-and-employee.md) catalogues (contact form submit/error states, test-drive events, search events, wishlist, comparison, budget, offer configurator, store/employee contact, and the UI floating-button event) is new in this release and has no old name to migrate from.