---
url: /foundations/writing/text-truncation.md
description: Ensure text is helpful, clear, and resilient to change
---

# Writing and text

Ensure text is helpful, clear, and resilient to change

[Best practices](best-practices.md) · **Text truncation** · [Text resizing](text-resizing.md)

## Text truncation

Information should always be available to readers, even if text is truncated or wrapped.

### Background

Increased size of text, increased spacing between text, and translation into longer languages shouldn’t result in losing content. This requires designing for text truncation and creating designs flexible enough to accommodate any viewport size or increase in zoom. Some common methods of designing for larger text include text wrapping, increased height or width of components, and truncation with ellipses and hover or link.

### Requirements

Content, understandability, and functionality must not be lost when users modify their type settings. There may be exceptions to these requirements for non-Latin alphabet languages.

### Text wrapping

* “Wrapped” text extends from one line to another, increasing the height of the text container
* Text should be wrapped when it’s critical, to ensure understandability, or when there’s space in the component

::: tip Do
![Body copy text wrapped inside a dialogue with an option to expand content.](/assets/3ad8125b-lwj5ao0k-18.Dan4J3f6.webp)

Wrap text, and if it still doesn’t fit, provide a way for users to see more
:::

::: danger Don't
![Body copy text wrapped inside a dialogue, cut off at the bottom, without an option to expand.](/assets/1ba123bc-lwj5b36c-19.dUjSrAWd.webp)

Don’t cut off text without providing a way for users to view it
:::

### Height and width of components

* Some components can extend vertically or horizontally for more text

::: tip Do
![Layout of UI- cards of different sizes organized in a stacked grid.](/assets/b5da9cc6-lwj5bfye-20.BcXAIBJp.webp)

Use flexible component containers that change size to fit their content
:::

::: danger Don't
![A stretched UI card with a small headline and a large photograph.](/assets/3f4432ca-lwj5c5w5-21.B_XqfDbw.webp)

Avoid setting text size limits that don’t fit the space in a component. Use all space available.
:::

### Ellipses with hover or link

* Truncated text can be replaced with an ellipsis if the text is available through a tooltip or link
* Links can be used when they’re contained in the text that’s truncated, and when the link displays what's been truncated
* If there's an ellipsis, but no way to show the truncated text, it is not accessible
* Note that this option can add difficulty for some people

::: tip Do
<video controls src="https://firebasestorage.googleapis.com/v0/b/design-spec/o/projects%2Fgoogle-material-3%2Fimages%2Flwj5e7k2-GM3-Foundations-WritingAndText-Accessibility-1-v01.mp4?alt=media" aria-label="A calendar with a cursor hovering  over a day of the week displays a tooltip that reads “Tuesday.”"></video>

Use links to reveal truncated text when space is limited, such as the ability to click a linked card to see an expanded view of its text
:::

::: danger Don't
![On a multiple selection list, the marked checkbox’s label is truncated by an ellipsis.](/assets/c9c1c995-m0qvmgvh-24._3nhjGum.webp)

Don’t truncate content without providing users another way to see it
:::
