---
title: v9 to v10
slug: wip/v9-to-v10
createdAt: 2025-07-02T13:04:09.974Z
---

# v9 to v10

This guide outlines how to address the breaking changes when migrating from version 9 to version 10 of Cosmos Web.

## Person Item

To better support the presentation of diverse personal information, we are deprecating the nationality and discipline properties in favor of a more flexible metadata structure. This change aligns with the recent update made to the Person Card, ensuring consistency across components in how personal metadata is handled.

### Properties

- ~~`nationality`~~: Deprecated in favor of `metaTextPrimary` for highlighted metadata
- ~~`discipline`~~: Deprecated in favor of `metaTextSecondary` and `additionalInfo`

### Slots

- ~~`flag`~~: Deprecated in favor of `meta-text-primary-prefix` for highlighted prefix content

### CSS Properties

- ~~`--cosmos-person-item-nationality-**`~~: Deprecated in favor of `--cosmos-person-item-meta-text-secondary-** `and `--cosmos-person-item-additional-info-**`
- ~~`--cosmos-person-item-discipline-**`~~: Deprecated in favor of `--cosmos-person-item-meta-text-secondary-** `and `--cosmos-person-item-additional-info-**`

***

## Person Card&#x20;

As part of modernizing the Person Card component, we are replacing the nationality and disciplines with a flexible metadata structure. This change provides better support for displaying diverse personal information and enables flexible content layouts.

### Properties

- ~~`nationality`~~: Deprecated in favor of `metaTextPrimary` for highlighted metadata
- ~~`disciplines`~~: Deprecated in favor of `metaTextSecondary` and `additionalInfo`

### Slots

- ~~`flag`~~: Deprecated in favor of `meta-text-primary-prefix` for highlighted prefix content

### CSS Properties

- ~~`--cosmos-person-card-nationality-**`~~: Deprecated in favor of `--cosmos-person-card-meta-text-secondary-** `and `--cosmos-person-card-additional-info-**`
- ~~`--cosmos-person-card-disciplines-**`~~: Deprecated in favor of `--cosmos-person-card-meta-text-secondary-** `and `--cosmos-person-card-additional-info-**`

***

## Icons

As per the new icons for subtitles and audio settings, 'cosmos-icon-subtitle-filled' has been removed from the library in favor of 'cosmos-icon-subtitle'.

| **Deprecated 🚫**              | **Successor ✅**         |
| ------------------------------ | ----------------------- |
| `cosmos-icon-subtitles-filled` | `cosmos-icon-subtitles` |

**
