Working with Rich Text and React

In this post we’ll explore using GraphCMS Rich Text with React.

Jamie Barton
Jamie Barton

To follow along with this post you'll need:

  • A React project already running, and connected to GraphCMS,
  • A model with a Rich Text field, and some content published.

If you’re new to React and GraphCMS, this video should show how to get started:

Start by installing the @graphcms/rich-text-react-renderer dependency within your project.

npm install –save-exact @graphcms/rich-text-react-renderer

Then inside of your React app, you'll want to fetch the content from your GraphCMS project, and the Rich Text field. I'll leave the exact implementation up to you, but you'll want to fetch the AST, and the embedded references.

Your query may look something like:

query GetPosts {
pages {
content {
references {
... on Post {
... on Asset {

If you'd prefer to follow along with some sample data, you can find that here.

The @graphcms/rich-text-react-renderer exports the component RichText that we’ll need to import:

import { RichText } from '@graphcms/rich-text-react-renderer';

We'll now take the Rich Text AST (json + references) and convert it to HTML, providing the references, and custom renderers using the RichText component:

export default function App() {
return (
h1: ({ children }) => <h1 className={`wfafsa`}>{children}</h1>,
a: ({ children, href, openInNewTab }) => (
target={openInNewTab ? '_blank' : '_self'}
style={{ color: 'green' }}
bold: ({ children }) => <strong>{children}</strong>,
Asset: {
text: () => (
<p>text plain</p>

You'll see above we can pass custom renderers to RichText.

This means you can override the default HTML element for what's to be shown in the Rich Text. This is extremely useful for things like links in Next.js where you will want to use the next/link component. You'll want to create a custom renderer for your Asset types.

That’s it! You will now see the Rich Text output with any custom renderers applied.

It's Easy To Get Started

GraphCMS plans are flexibly suited to accommodate your growth. Get started for free, or request a demo to discuss larger projects with more complex needs