---
title: v3 to v4
slug: wip/HiXP-v3-to-v4
createdAt: 2024-06-19T11:29:07.458Z
---

# v3 to v4

This migration guide outlines the key changes from version 3 to version 4, specifically resolving the deprecation of certain icons.

## Icons

In preparation for a bigger overhaul to our Cosmos Icon library we have decided to deprecate some of our arrow-related icons. This decision is part of our effort to reintroduce them with more fitting names, providing some with more semantic names and others with a broader, generalized meaning.&#x20;

| **Deprecated 🚫**                  | **Successor ✅**                 |
| ---------------------------------- | ------------------------------- |
| `cosmos-icon-arrow-up`             | `cosmos-icon-chevron-up`        |
| `cosmos-icon-arrow-down`           | `cosmos-icon-chevron-down`      |
| `cosmos-icon-arrow-left`           | `cosmos-icon-chevron-left`      |
| `cosmos-icon-arrow-right`          | `cosmos-icon-chevron-right`     |
| `cosmos-icon-arrow-triangle-left`  | `cosmos-icon-caret-left`        |
| `cosmos-icon-arrow-triangle-right` | `cosmos-icon-caret-right`       |
| `cosmos-icon-collapse`             | `cosmos-icon-caret-down`        |
| `cosmos-icon-expand`               | `cosmos-icon-caret-up`          |
| `cosmos-icon-collapse-arrows`      | `cosmos-icon-collapse-vertical` |
| `cosmos-icon-expand-arrows`        | `cosmos-icon-expand-vertical`   |
| `cosmos-icon-expand-more`          | `cosmos-icon-caret-up`          |
| `cosmos-icon-expand-less`          | `cosmos-icon-expand`            |
| `cosmos-icon-size-contract`        | `cosmos-icon-contract`          |
| `cosmos-icon-size-expand`          | `cosmos-icon-enlarge`           |
| `cosmos-icon-arrow-down-up`        | `cosmos-icon-sort`              |
| `cosmos-icon-arrow-return-right`   | `cosmos-icon-redo`              |
| `cosmos-icon-arrow-return-left`    | `cosmos-icon-undo`              |

## Select

Due to a refactoring of the [Select](docId\:WtCeTkPM0xPTNkPuw3JIW) component, there is a risk of content resets in Figma projects.&#x20;

Follow these steps to ensure a smooth migration:

1\. Review & Update Existing Components: Before applying all updates, check any instances of Select and its values, placeholders in input fields, the dropdown and option items.

2\. For affected instances, manually re-apply custom overrides and ensure that properties have been shifted from the select level to the dropdown and option-item levels.
