FREEFirst project with us? Your landing page design is on the house.See the offer

Glossary · Astro and headless

What is Portable Text?

By Abdul QuadirUpdated Nov 2026
Portable Textnoun · Astro and headless

Portable Text is a format for rich text stored as structured JSON instead of HTML. Sanity uses it so the same content can render anywhere, from a web page to an app.

Portable Text is a format for rich text stored as structured JSON instead of HTML. Sanity uses it so the same content can render anywhere, from a web page to an app.

Portable Text, explained

A normal rich text editor saves HTML. Portable Text saves blocks: a paragraph, a heading, a list item, each with marks for bold or links, plus any custom block you define.

Because it is data, the front end decides how each block looks. A quote block can render as a styled pull quote on the website and plain text in an email.

Custom blocks are where it shines. Editors can drop a call to action, a code sample, a table or a video embed into an article, all with fields you control.

Rendering libraries exist for Astro, React and other frameworks, so turning Portable Text into clean HTML is straightforward.

In our work

How Kookies uses it

We use Portable Text in Sanity for blog posts and long pages, with custom blocks for CTAs, quotes, tables and embeds, rendered by Astro into clean, fast HTML.

FAQs

Portable Text
questions.

Abdul Quadir
Still have a question?Ask us directly. We reply within a day.
Book a callPick a timehello@kookies.io

It was created by Sanity and is an open specification, so other tools can use it too.

Yes. Libraries for Astro, React and other frameworks render it to HTML.

Structured data is easier to reuse across channels and safer to style consistently.

Your turn

Let's kook
what you krave.

Hi Kookies, I need a built on . I'd love to launch . Reach me at
or book a callSent. We reply within one working day.