Title: @wordpress/global-styles-ui
Published: October 23, 2025
Last modified: October 16, 2026

---

# @wordpress/global-styles-ui

## In this article

 * [Installation](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-global-styles-ui/?output_format=md#installation)
 * [Usage](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-global-styles-ui/?output_format=md#usage)
 * [API](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-global-styles-ui/?output_format=md#api)
    - [GlobalStylesUI](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-global-styles-ui/?output_format=md#globalstylesui)
 * [Contributing](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-global-styles-ui/?output_format=md#contributing)

UI components for managing WordPress Global Styles.

## 󠀁[Installation](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-global-styles-ui/?output_format=md#installation)󠁿

Install the module:

    ```bash
    npm install @wordpress/global-styles-ui --save
    ```

## 󠀁[Usage](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-global-styles-ui/?output_format=md#usage)󠁿

    ```javascript
    import { GlobalStylesUI } from '@wordpress/global-styles-ui';

    function MyComponent() {
        return (
            <GlobalStylesUI
                value={ userStyles }
                baseValue={ themeStyles }
                onChange={ handleChange }
            />
        );
    }
    ```

## 󠀁[API](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-global-styles-ui/?output_format=md#api)󠁿

### 󠀁[GlobalStylesUI](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-global-styles-ui/?output_format=md#globalstylesui)󠁿

Main component for the Global Styles editor interface.

**Props:**

 * `value` (GlobalStylesConfig): User’s custom global styles
 * `baseValue` (GlobalStylesConfig): Theme’s default global styles
 * `onChange` (Function): Callback when styles change
 * `path` (string, optional): Current navigation path
 * `onPathChange` (Function, optional): Callback when path changes
 * `fontLibraryEnabled` (boolean, optional): Enable font library features
 * `serverCSS` (array, optional): Server CSS styles
 * `serverSettings` (object, optional): Server settings

## 󠀁[Contributing](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-global-styles-ui/?output_format=md#contributing)󠁿

See [CONTRIBUTING.md](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-global-styles-ui/../../CONTRIBUTING.md?output_format=md)
for details.

First published

October 23, 2025

Last updated

October 16, 2026

Edit article

[ Improve it on GitHub: @wordpress/global-styles-ui ](https://github.com/WordPress/gutenberg/edit/trunk/packages/global-styles-ui/README.md)

[  Previous: @wordpress/global-styles-engine](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-global-styles-engine/)

[  Next: @wordpress/grid](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-grid/)