> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: selectTextTheme()

## Article: selectTextTheme()

## Article Link: https://dev.wix.com/docs/sdk/host-modules/editor/react-elements/pickers/select-text-theme.md

## Article Content:

<!-- Source: packages/public-editor-platform-sdk/src/element/index.ts in wix-private/editor-platform -->
# selectTextTheme()

Opens the editor's text theme picker for the selected component, letting a Wix user choose a site theme combination of font and color. A theme token is a named reference to one of these site-wide values, such as `'Heading 1'` for a font or a named theme color, rather than a literal CSS value. For background on connecting a component to a site's theme, see [Connect an Editor React Component's Colors and Fonts to a Site Theme](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/site-extensions/editor-react-components/connect-an-editor-react-component-s-colors-and-fonts-to-a-site-theme.md).

## Syntax

```ts
function selectTextTheme(params: SelectTextThemeParams): Promise<SelectedTextTheme>
```

## Parameters

| Name | Type | Description |
| :---- | :---- | :---- |
| `target` | HTMLElement | Element in your panel that the picker popup opens relative to. |
| `initialValue.font` | string | Initial font value to show when the picker opens, as CSS font shorthand or a theme token. |
| `initialValue.color` | string | Initial color value to show when the picker opens, as a CSS color string or a theme token. |

## Returns

`Promise<SelectedTextTheme>`

| Property | Type | Description |
| :---- | :---- | :---- |
| `font` | string | Selected font, as CSS font shorthand or a theme token. |
| `color` | string | Selected color, as a CSS color string or a theme token. |
| `textDecorationLine` | string | Selected text decoration, such as `'none'` or `'underline'`. |
| `letterSpacing` | string | Selected letter spacing, as a CSS length or `'normal'`. |

## Example

```js
import { reactElements } from '@wix/editor';

const theme = await reactElements.selectTextTheme({
  target: buttonRef.current,
  initialValue: { font: 'Heading 1', color: '#333333' },
});
```

## See also

- [Connect an Editor React Component's Colors and Fonts to a Site Theme](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/site-extensions/editor-react-components/connect-an-editor-react-component-s-colors-and-fonts-to-a-site-theme.md)
- [setStyles()](https://dev.wix.com/docs/sdk/host-modules/editor/react-elements/styles/set-styles.md)
- [About the React Elements API](https://dev.wix.com/docs/sdk/host-modules/editor/react-elements/introduction.md)