Skip to main content

React Bricks v4

In October 2023 we released v4, with many new features, improvements and almost no breaking changes.

New Features

New features

  • Media Library: a complete DAM (Digital Assets Management) system
  • Multiple Environments (content branches): create environments from the Dashboard, choose the environment with the environment configuration property
  • Advanced SEO: new interface to manage Meta tags, OpenGraph, Twitter Cards and the complete implementation of entities; renderMeta() and renderJsonLd() to render them.
  • Approval Workflow (4.1): decouple saving a page from publishing it, through a Working Copy mechanism and turn on the Approval Workflow, so that only users with the proper permission can approve changes (see Approval Workflow Docs).
  • Support for React Server Components (4.2): support for RSC through a new RSC-compatible library and a new Next.js starter based on the App Router.
  • Slug Prefix: ability to set a slug prefix on pageTypes (slugPrefix)
  • Read-only Image: you can now use the Image component of React Bricks also for read-only images using the readonly attribute (for example coming from custom fields of related entities)
  • Show/hide sidebar controls of a brick by user (for example by custom role) or page (for example by page type). Now the show function of sideEditProps gets also the page and the logged user as arguments, so that you have total flexibility.
  • Change history for a page: The change history for a page is accessible from the "Page" tab of the right sidebar.


  • Relationship field: now it saves only an ID of the related entity, but you can choose to also embed the whole content of the related entity (updated at build/run time)
  • Improved Image component: now you can upload a file, get it from URL, from Unsplash or from the Media Library
  • Improved File component: now you can also get a file from the Media Library, and there is a nice upload progreess bar
  • Allowed extensions: now the allowed extensions are always a subset of a set of generally allowed MIME types > extensions
  • Accents in slugs: by setting the allowAccentsInSlugs you can allow accented letters in the page slugs
  • New permissions for users: Edit SEO attributes (meta, slug, Open Graph, Twitter,, Edit page attributes, like visibility, pageType, author, etc.

Breaking changes

  • Relationship field: now it returns only the ID of the related entity, but you can choose to also embed the whole content of the related entity (embedValues under relationshipOptions).
  • For the RSC compatible library, the structure of the visual components (Text, RichText, Image, Repeater) changes slightly, and for bricks with "use client", a wrapper component is needed.


If you need to migrate from v3 to v4, please read the v3 > v4 Migration Guide.