---
title: Text
description: >-
  Text is used to visually style and provide semantic value for a small piece of
  text content.
api_version: 2025-07
api_name: checkout-ui-extensions
source_url:
  html: >-
    https://shopify.dev/docs/api/checkout-ui-extensions/2025-07/components/titles-and-text/text
  md: >-
    https://shopify.dev/docs/api/checkout-ui-extensions/2025-07/components/titles-and-text/text.md
---

# Text

Text is used to visually style and provide semantic value for a small piece of text content.

## TextProps

* accessibilityRole

  TextAccessibilityRole

  Set the semantic of the component’s content

* accessibilityVisibility

  AccessibilityVisibility

  Changes the visibility of the element to assistive technologies.

  `hidden` hides the component from assistive technology (for example, a screen reader) but remains visually visible.

* appearance

  Extract< Appearance, | 'accent' | 'subdued' | 'info' | 'success' | 'warning' | 'critical' | 'decorative' >

  Changes the visual appearance

* emphasis

  Emphasis

  Use to emphasize a word or a group of words.

* id

  string

  Unique identifier. Typically used as a target for another component’s controls to associate an accessible label with an action.

* size

  TextSize

  Size of the text

* visibility

  Visibility

  Changes the visibility of the element.

  `hidden` visually hides the component while keeping it accessible to assistive technology, such as screen readers. Hidden elements don't take any visual space contrary to CSS visibility: hidden;

### TextAccessibilityRole

```ts
'address' | 'deletion' | 'marking' | {type: 'abbreviation'; for?: string} | {type: 'directional-override'; direction: 'ltr' | 'rtl'} | {type: 'datetime'; machineReadable?: string} | 'stress' | 'offset' | 'strong'
```

### AccessibilityVisibility

```ts
'hidden'
```

### Appearance

```ts
'base' | 'accent' | 'decorative' | 'interactive' | 'subdued' | 'info' | 'success' | 'warning' | 'critical' | 'monochrome'
```

### Emphasis

Use to emphasize a word or a group of words.

```ts
'italic' | 'bold'
```

### TextSize

```ts
Extract<Size, 'extraSmall' | 'small' | 'base' | 'large' | 'extraLarge'> | 'medium'
```

### Size

```ts
'extraSmall' | 'small' | 'base' | 'large' | 'extraLarge' | 'fill'
```

### Visibility

```ts
'hidden'
```

### Examples

* #### Basic Text

  ##### React

  ```tsx
  import {
    reactExtension,
    Text,
    BlockStack,
  } from '@shopify/ui-extensions-react/checkout';

  export default reactExtension(
    'purchase.checkout.block.render',
    () => <Extension />,
  );

  function Extension() {
    return (
      <BlockStack inlineAlignment="center">
        <Text size="extraSmall">Total</Text>
        <Text size="small">Total</Text>
        <Text size="base">Total</Text>
        <Text size="medium">Total</Text>
        <Text size="large">Total</Text>
        <Text size="extraLarge">Total</Text>
      </BlockStack>
    );
  }
  ```

  ##### JS

  ```js
  import {extension, Text, BlockStack} from '@shopify/ui-extensions/checkout';

  export default extension('purchase.checkout.block.render', (root) => {
    const text = root.createComponent(BlockStack, undefined, [
      root.createComponent(Text, {size: 'extraSmall'}, 'Total'),
      root.createComponent(Text, {size: 'small'}, 'Total'),
      root.createComponent(Text, {size: 'base'}, 'Total'),
      root.createComponent(Text, {size: 'medium'}, 'Total'),
      root.createComponent(Text, {size: 'large'}, 'Total'),
      root.createComponent(Text, {size: 'extraLarge'}, 'Total'),
    ]);

    root.appendChild(text);
  });
  ```

## Preview

![](https://shopify.dev/images/templated-apis-screenshots/checkout-ui-extensions/2025-07/text-default.png)

## Appearance

| Value | Description |
| - | - |
| `"accent"` | Conveys emphasis and draws attention to the element. |
| `"subdued"` | Conveys a subdued or disabled state for the element. |
| `"info"` | Conveys that the element is informative or has information. |
| `"success"` | Convey a successful interaction. |
| `"warning"` | Convey something needs attention or an action needs to be taken. |
| `"critical"` | Conveys a problem has arisen. |

## Best Practices

* Use larger text to emphasize content that’s not a heading, such as a price total.

* Create contrast between more and less important text with properties such as `size` and `subdued`.

## Related

[![](https://shopify.dev/images/icons/32/pickaxe-1.png)![](https://shopify.dev/images/icons/32/pickaxe-1-dark.png)](https://shopify.dev/docs/api/checkout-ui-extensions/2025-07/components/titles-and-text/heading)

[ComponentHeading](https://shopify.dev/docs/api/checkout-ui-extensions/2025-07/components/titles-and-text/heading)

[![](https://shopify.dev/images/icons/32/pickaxe-1.png)![](https://shopify.dev/images/icons/32/pickaxe-1-dark.png)](https://shopify.dev/docs/api/checkout-ui-extensions/2025-07/components/titles-and-text/headinggroup)

[ComponentHeadingGroup](https://shopify.dev/docs/api/checkout-ui-extensions/2025-07/components/titles-and-text/headinggroup)

[![](https://shopify.dev/images/icons/32/pickaxe-1.png)![](https://shopify.dev/images/icons/32/pickaxe-1-dark.png)](https://shopify.dev/docs/api/checkout-ui-extensions/2025-07/components/titles-and-text/textblock)

[ComponentTextBlock](https://shopify.dev/docs/api/checkout-ui-extensions/2025-07/components/titles-and-text/textblock)