---
title: Mode
slug: wip/mode
createdAt: 2023-07-20T14:41:14.934Z
---

# Mode

:::hint{type="info"}
The Mode is a utility that allows you to control the appearance of nested components in one go. It is only available for the code library of Cosmos Web. Use the `appearance` property To switch components from dark to light in Figma.
:::

***

By default, components in Cosmos Web render in an appearance that integrates best into a light-mode environment. The Mode enables you to switch to the appearance of individual components or an entire group.

The core principle of the Mode is to define the mode at any level in your document tree and cascade it to any decedent Cosmos component regardless of its depth.

## API

| **Property** | **Description** | **Values** | **Default** |
| ------------ | --------------- | ---------- | ----------- |
| mode         | The mode        | light dark | light       |

