Skip to main content
CMSquestions

What Is Portable Text?

IntermediateQuick Answer

TL;DR

Portable Text is an open-source specification for representing rich text content as structured JSON data instead of HTML. Every block of text, inline annotation, and embedded element is stored as a typed object with explicit properties. This makes the content truly portable—the same data can be rendered as HTML for a website, as native UI components in a mobile app, or as plain text for a voice assistant, without parsing or sanitizing markup.

Key Takeaways

  • Portable Text stores rich text as structured JSON, not HTML strings
  • Each element (paragraph, heading, image, link) is a typed object with explicit properties
  • The same Portable Text content can be rendered differently for each delivery channel
  • Custom block types and inline annotations extend the format beyond standard formatting
  • Serialization libraries exist for React, Vue, Svelte, and other frameworks