Changelog
5.1.0 (March 17, 2026)
Section titled “5.1.0 (March 17, 2026)”New Features
Section titled “New Features”- AI Content Generation for single text fields
- Preview: AI Full-Page Content Generation
- Minor fixes to features introduced in 5.0.0
5.0.0 (December 19, 2025)
Section titled “5.0.0 (December 19, 2025)”New Feature: A/B Testing and Multischeduling
Section titled “New Feature: A/B Testing and Multischeduling”- Multischeduling: create variants and set scheduled publish and unpublish dates for each variant.
- A/B Testing: set a weight for each variant. When multiple variants are active at the same time, React Bricks serves them according to their weights.
- Added
createAbTestingMiddlewarefor Next.js Pages and Astro, andcreateWithAbTestingMiddlewarefor Next.js App when chaining with the i18n middleware is needed. - Added A/B Testing implementation examples using middleware and analytics on the
ab-testingbranch of the starter projects.
New Feature: i18n Middleware
Section titled “New Feature: i18n Middleware”- Added
createI18nMiddlewareto make i18n routing easier to manage in Next.js App and Astro projects.
New Feature: Email Marketing
Section titled “New Feature: Email Marketing”- Connect your Email Sending Provider from the dashboard. Supported providers include MailChimp, Brevo, Mailerlite, GetResponse, SendGrid, Resend, and ConvertKit.
- Create a
pageTypewithisEmailMarketing: trueto identify email marketing pages. - Email marketing page types can define a
renderWrapperfunction and arenderEmailHtmlfunction, which can use therenderfunction fromreact-email. - Pages with
isEmailMarketing: trueinclude options to select an ESP, list, sender, and campaign name, and to send a test, send the campaign, or schedule it. - Added optional email marketing bricks based on
react-emailto the starter projects, which can be installed by the CLI.
New Feature: Form Management
Section titled “New Feature: Form Management”- Create forms from the dashboard, with options to save submitted data, send an email with the data, subscribe users to an Email Sending Provider list, and call a Zapier webhook.
sendFormSubmissionfunction to send form data to a form, usable in “form” bricks.- Google Recaptcha v3 protection.
New Feature: API Prefix
Section titled “New Feature: API Prefix”- Set an API prefix for React Bricks API URLs, such as
xx.api-reactbricks.com, for EU/US data residency and enterprise custom use cases.
New Security and Governance Features
Section titled “New Security and Governance Features”- Enterprise customers can now choose EU or US data residency.
- ISO/IEC 27001:2022 certification obtained.
Improvements
Section titled “Improvements”- Warning when leaving the editor if content is not saved.
4.7.8 (September 30, 2025)
Section titled “4.7.8 (September 30, 2025)”Better support for marketplace’s themes
Section titled “Better support for marketplace’s themes”- Themes can now define
bannerTextandbannerImage. - Bricks and stories can be disabled with optional
disabledIcon(purchaseormaintenance),disabledLink, anddisabledTooltipsettings. - Select
optionsfromsideEditPropscan be disabled with an optionaldisabledTooltip.
4.7.7 (September 3, 2025)
Section titled “4.7.7 (September 3, 2025)”New features
Section titled “New features”- Multifactor authentication: Configure from the dashboard and use across Admin, Dashboard, and CLI.
- SEO noindex and generator: Set “noindex” and hide the “generator” meta tag at page level (Admin > SEO) or site-wide (Dashboard > App Settings).
Deprecation notice for Gatsby and Remix
Section titled “Deprecation notice for Gatsby and Remix”With the v4.7.7 release, we are officially deprecating support for Gatsby and Remix frameworks. The related starter projects will be removed from our CLI.
We’re focusing our development efforts on Next.js and Astro to deliver the best possible experience and robust features for content-focused websites. This decision allows us to dedicate more resources to improving our core framework support.
If you’re currently using React Bricks with Gatsby or Remix, we recommend planning a migration to either Next.js or Astro: your existing bricks will remain almost identical in the new frameworks. If you need assistance with migrating from Gatsby or Remix to Next.js or Astro, please don’t hesitate to contact our support team via the website chat: we’re committed to helping you make a smooth transition.
4.7.6 (August 5, 2025)
Section titled “4.7.6 (August 5, 2025)”- Fixed issue where page slugs containing multiple slashes (/) caused errors.
4.7.5 (July 3, 2025)
Section titled “4.7.5 (July 3, 2025)”Improvements
Section titled “Improvements”- The
renderWrapperfunction can now also be defined on the <Preview> component.
4.7.4 (May 23, 2025)
Section titled “4.7.4 (May 23, 2025)”New Feature: renderWrapper
Section titled “New Feature: renderWrapper”- A
renderWrapperfunction can now be defined on apageTypeto wrap content in different environments: Admin, frontend, and preview. See Page Types.
4.7.3 (May 21, 2025)
Section titled “4.7.3 (May 21, 2025)”Improvements
Section titled “Improvements”- Media Library: Automatically focus on search field when Media Library opens or when “Replace image > From library” is selected
- Library prepared for AI integration
- Fixed bugs related to style handling for CSS-in-JS libraries
- Color knob: improved the border style, using a shadow for better display of gradients
- Fixed Unsplash API calls when an API key is provided
4.7.2 (March 26, 2025)
Section titled “4.7.2 (March 26, 2025)”- Fixed file and image uploads in Astro projects
4.7.1 (March 17, 2025)
Section titled “4.7.1 (March 17, 2025)”- Unsplash now returns higher-resolution images for the original version
4.7.0 (March 15, 2025)
Section titled “4.7.0 (March 15, 2025)”New Features
Section titled “New Features”- Support for Astro 🎉🎉🎉
- Support for React 19 and Next.js 15
4.6.1 (February 12, 2025)
Section titled “4.6.1 (February 12, 2025)”New Features
Section titled “New Features”- RTL Support: better support for languages that use a right-to-left script, such as Arabic. RTL languages can be configured with the
rtlLanguagesconfiguration prop. TheReactBricksContextalso exposes anisRtlLanguageutility function.
4.6.0 (January 3, 2025)
Section titled “4.6.0 (January 3, 2025)”New Features
Section titled “New Features”- Headless View: Enable
headlessViewat page type level to edit structured entities with custom fields in a form-based view instead of the visual editor.
4.5.6 (November 27, 2024)
Section titled “4.5.6 (November 27, 2024)”New Features
Section titled “New Features”- Icon component to render icons selected with an IconSelector control
- warningIfLowBattery flag to alert users to save their work or charge their device when battery levels fall below 15% without a power source connected
- Validation on sidebar controls now triggers a warning when saving, including for deeply nested repeaters.
- Better typings for icons
4.5.5 (October 31, 2024)
Section titled “4.5.5 (October 31, 2024)”- Save warnings are now shown for validation errors in deeply nested bricks.
4.5.4 (October 31, 2024)
Section titled “4.5.4 (October 31, 2024)”- Read-only images now use the original image source in Admin instead of the source set, avoiding references to images that have not been processed yet.
4.5.3 (October 21, 2024)
Section titled “4.5.3 (October 21, 2024)”Improvements
Section titled “Improvements”- Better outline for selected items inside a repeater
- When using RSC, bricks wrapping client components were not selectable when inside a repeater
- Fixed item labels for repeaters with multiple item types
4.5.2 (October 8, 2024)
Section titled “4.5.2 (October 8, 2024)”Improvements
Section titled “Improvements”- The
iconSelectorOptionsnow accepts an array of possible icon sets - Added new icon sets Feather and FontAwesome, bringing the total to 4 sets (Hero Solid, Hero Outline, Feather and FontAwesome)
- Removed “Experimental” label from the
IconSelectorcontrol
4.5.1 (September 24, 2024)
Section titled “4.5.1 (September 24, 2024)”New features
Section titled “New features”- Introduced the
getDefaultMetafunction for page types, allowing new pages to start with default metadata, Open Graph data, and Schema.org information, including data from external API calls such as a headless commerce system.
- Resolved issues with repeater items in Page Template Slots
4.5.0 (September 20, 2024)
Section titled “4.5.0 (September 20, 2024)”New Feature: Page Templates (experimental)
Section titled “New Feature: Page Templates (experimental)”- Configure a
templateon apageType, composed ofslots. - Each slot has a name, label, minimum and maximum number of blocks, allowed bricks, editable status, and optional default content.
- Useful for pages such as e-commerce product detail pages, where some fixed sections can use data from external APIs while other sections remain flexible for content editors.
- New
<Slot>component to render a single pageslot, interleaving React Bricks-managed content with custom code.
Other new features
Section titled “Other new features”- Login via SSO for the Admin interface
- New
<List of="..." where={}>component to render elements of a specificpageType, with support for filtering by tag, language, and custom fields, and for sorting results.
Improvements
Section titled “Improvements”- Localization: icons showing working copy, pending approval, draft, and scheduled statuses are now displayed on each language tab.
- Playground: updated UI for pageTypes
- Improved nested items UI
- Improved styles performance to avoid FOUC in Admin upon page change
- RichText: fixed the link modal in Safari
4.4.5 - 4.4.6 (August 5, 2024)
Section titled “4.4.5 - 4.4.6 (August 5, 2024)”- Image:
fetchPrioritycamel case for React 19 (used by Next.js) - Missing-brick warnings now use unique brick names
4.4.4 (August 3, 2024)
Section titled “4.4.4 (August 3, 2024)”Improvements
Section titled “Improvements”- The
RepeaterItemstype now accepts a generic type, so props returned bygetDefaultPropsare fully typed for nested items too.
4.4.3 (August 3, 2024)
Section titled “4.4.3 (August 3, 2024)”- Fixed key warning for Nested items sidebar in some conditions
- Fixed camel-case
fetchPriorityattribute on DOM image
4.4.2 (July 30, 2024)
Section titled “4.4.2 (July 30, 2024)”Improvements
Section titled “Improvements”- Experimental sidebar repeater items: when a block is selected, the sidebar is split into two tabs, “Block Props” and “Nested Items”. Nested items show the current and maximum item counts. The add button remains visible after the maximum has been reached, but is disabled with an explanatory tooltip.
4.4.1 (July 26, 2024)
Section titled “4.4.1 (July 26, 2024)”New features
Section titled “New features”- Nested bricks: added an experimental sidebar control for easier management, including reorder and delete actions. Enable it by setting
experimentalSidebarRepeaterItemstotruein the React Bricks config. - Experimental Icon Selector in
SideEditPropType, with autocomplete search for icons.
Improvements
Section titled “Improvements”- DAM (Media library): link to media URL and open media in new window
- Improved brick screenshots from the Playground, fixing generated image issues in some CSS flex layouts
- Added Superscript and Subscript to RichText features
- Autocomplete: added
renderOptionto render complex JSX for each option, not just a label - Autocomplete:
getOptionsnow receivespropsas a second argument, so the fetch function can depend on other prop values - Dashboard: new filters for change history: users and pages are now autocomplete fields
- Advanced SEO: Fixed a problem with schema.org nested fields
4.3.1 (March 20, 2024)
Section titled “4.3.1 (March 20, 2024)”Improvements
Section titled “Improvements”- RichText links are now implemented as a RichText plugin.
- RichText links now support a
target. Iftargetis “_blank”,relis automatically set tonoopenerfor security.
4.3.0 (March 18, 2024)
Section titled “4.3.0 (March 18, 2024)”New feature: Custom RichText Plugins
Section titled “New feature: Custom RichText Plugins”- Create custom rich-text plugins with a custom button, render function, and configuration. See Create a RichText plugin
- The plugin can have a popover window to allow the user to choose parameters for the plugin. See Block with Modal plugin constructor
New feature: Autocomplete control type
Section titled “New feature: Autocomplete control type”- New
autocompletetype for sidebar controls, with debounced asynchronous fetching based on search text. - See SideEditProps Docs
New feature: Quality setting on Images
Section titled “New feature: Quality setting on Images”- Set
qualityon the Image component, imagesideEditProps, or imagecustomFieldsto control image compression. - See Image properties
4.2.0 (January 30, 2024)
Section titled “4.2.0 (January 30, 2024)”Support for React Server Components 🎉🥳🍾
Section titled “Support for React Server Components 🎉🥳🍾”- Complete support for React Server Components with minimal change to bricks’ structure
- RSC-compatible bricks are cross-platform: they work also on Next.js with Pages router, Remix or Gatsby
- New starter projects for Next.js 14 with App Router and RSC
- See Server Components Docs to see how to create RSC-compatible bricks
New feature: Fetch external data at brick level
Section titled “New feature: Fetch external data at brick level”- Fetch external data at brick level. See External content Docs
- This feature works cross-platform, not just for RSC
December 16, 2023 4.1.3
Section titled “December 16, 2023 4.1.3”Minor fixes
4.1.0 - 4.1.2 (December 11, 2023)
Section titled “4.1.0 - 4.1.2 (December 11, 2023)”New feature: Approval Workflow
Section titled “New feature: Approval Workflow”- Decouple saving a page from publishing it through a Working Copy mechanism
- Activate the Approval Workflow so only users with the proper permission can approve changes
- See Approval Workflow Docs to see how it works
New feature: Change history for a page
Section titled “New feature: Change history for a page”- The change history for a page is accessible from the “Page” tab of the right sidebar.
New permissions for users
Section titled “New permissions for users”From the dashboard, choose which users can:
- Edit SEO attributes (meta, slug, Open Graph, Twitter, Schema.org)
- Edit page attributes, such as visibility, page type, and author.
Improvements
Section titled “Improvements”- Better SEO management: changes are applied immediately without saving in each tab, and the slug has moved to the SEO view.
- Header: added an icon with a tooltip for a quick view of last modified date and author, visibility status, lock status, and editing status.
- Left sidebar: the environment name is shown when it is different from “main”.
- The
slugPrefixof a page type is correctly applied upon page creation
4.0.7 (November 13, 2023)
Section titled “4.0.7 (November 13, 2023)”- Fixed a missing dependency.
4.0.6 (November 12, 2023)
Section titled “4.0.6 (November 12, 2023)”- Fixed click-outside behavior in Media Library popovers.
- Unsplash: better mapping of alt and title fields.
- Normalization of file name in Media Library and SEO name in the image edit modal.
4.0.4 - 4.05 (November 3, 2023)
Section titled “4.0.4 - 4.05 (November 3, 2023)”Improvements
Section titled “Improvements”- New function
getSchemaOrgDatato support JSON-LD injection in Remix starters.
4.0.2 - 4.0.3 (October 25, 2023)
Section titled “4.0.2 - 4.0.3 (October 25, 2023)”- Fixes related to external data and embeds.
4.0.1 (October 24, 2023)
Section titled “4.0.1 (October 24, 2023)”New feature
Section titled “New feature”- Added metadata, Open Graph, and Twitter Card SEO fields for all plans.
4.0.0 (October 24, 2023)
Section titled “4.0.0 (October 24, 2023)”New features
Section titled “New features”- Media Library: a complete DAM (Digital Assets Management) system
- Multiple Environments (content branches): create environments from the Dashboard and choose the active environment with the
environmentconfiguration property. - Advanced SEO: new interface to manage meta tags, Open Graph, Twitter Cards, and Schema.org entities; use
renderMeta()andrenderJsonLd()to render them. - Slug Prefix: set a slug prefix on page types with
slugPrefix. - Read-only Image: use the React Bricks Image component for read-only images with the
readonlyattribute, for example images coming from custom fields of related entities. - Show/hide sidebar controls of a brick by user or page, for example by custom role or page type. The
showfunction ofsideEditPropsnow receives the page and logged-in user as arguments.
Improvements
Section titled “Improvements”- Relationship field: now saves only the related entity ID by default. You can also choose to embed the full related entity content, updated at build time or runtime.
- Improved Image component: upload a file or choose an image from a URL, Unsplash, or the Media Library.
- Improved File component: choose files from the Media Library and see upload progress.
- Allowed extensions: allowed extensions are now always a subset of the generally allowed MIME types and extensions.
- Accents in slugs: set
allowAccentsInSlugsto allow accented letters in page slugs.
3.12.2 - 3.12.3 (August 4, 2023)
Section titled “3.12.2 - 3.12.3 (August 4, 2023)”New feature
Section titled “New feature”- Added a link to the live website in the Admin header. The hostname is configured in the dashboard.
3.12.1 (July 31, 2023)
Section titled “3.12.1 (July 31, 2023)”- File component: the frontend render function now receives the SEO-friendly URL in the
urlargument.
3.12.0 (July 28, 2023)
Section titled “3.12.0 (July 28, 2023)”New features
Section titled “New features”- The
RichTextcomponent has acustomFieldPlainTextprop (true by default). If set to false, values are not transformed to plain text when saving to a custom field.
Improvements
Section titled “Improvements”- Tags autocomplete on pages now filters by page language, for example showing only tags from Italian pages on an Italian page.
3.11.4 (July 26, 2023)
Section titled “3.11.4 (July 26, 2023)”- Fixed File SEO name management, preparing it for the upcoming Digital Asset Management (DAM) feature and enterprise custom CDNs.
3.11.3 (July 18, 2023)
Section titled “3.11.3 (July 18, 2023)”- Fixed the confirm-delete-file dialog style when the file name is long.
3.11.0 - 3.11.2 (July 17, 2023)
Section titled “3.11.0 - 3.11.2 (July 17, 2023)”New features
Section titled “New features”- The
Imagecomponent can now be set asreadonlywith asource, allowing it to render images that should not be visually editable, such as images from the pages used in a posts list.
Improvements
Section titled “Improvements”- Improved File component with new interface and upload progress bar
- Upload progress bar on image component
- Tags can be fetched by language; in the tags interface of the Page tab, only tags in the current language are shown
- Left sidebar: show pages with an unknown
pageTypeso they can still be accessed or removed.
- Fixed the Image component modal when no source was available.
3.10.0 (June 30, 2023)
Section titled “3.10.0 (June 30, 2023)”New features
Section titled “New features”- In the Image modal, images can now be marked as “high priority (above the fold)”. High-priority images use
loading="eager"when the browser supports native lazy loading, or skip React Bricks lazy loading otherwise. In both cases,fetchPriorityis set tohigh.
Improvements
Section titled “Improvements”- Updated and replaced dependencies so no dependency declares a React <18 peer requirement.
- On
TextandRichText, therenderBlockandplaceholderprops are no longer required. By default, a simple paragraph is rendered and the placeholder is “Type a text…”. - The
TextValuetype is exported to allow correct typing of text and rich-text props.
- More robust fetching of the latest version from the npm registry
- Prevented very long page names from hiding the save button.
3.9.1 - 3.9.2 (April 27, 2023)
Section titled “3.9.1 - 3.9.2 (April 27, 2023)”Improvements
Section titled “Improvements”- Added
getExternalDataArgsto thefetchPagefunction to pass arguments togetExternalData. This is useful for data that depends on path params rather than the page itself, such as product variants in an e-commerce site.
- Fixed problems with Collaboration introduced in 3.9.0
- Fixed image modal save of
altandseoNameintroduced in 3.9.0 - Better
Linktyping - The link of the news popup in the Admin has target
_blank
3.9.0 (April 21, 2023)
Section titled “3.9.0 (April 21, 2023)”New feature (for Enterprise plans): Flexible Permissions
Section titled “New feature (for Enterprise plans): Flexible Permissions”Enterprise plans can set fine-grained permissions at user, page, language, and brick level by providing canAddPage, canAddTranslation, canSeePageType, canSeePage, canEditPage, canDeletePage, canDeleteTranslation, and canUseBrick in the permission object of the React Bricks configuration.
See the Permissions documentation.
Custom roles can be created from the Dashboard and assigned to users for use in the permission functions.
New feature: Stories as bricks in “Add new”
Section titled “New feature: Stories as bricks in “Add new””Stories created in brick code can now appear as bricks in the “Add new” menu by using the showAsBrick flag.
See the Stories documentation.
New feature: Structured bricks in config
Section titled “New feature: Structured bricks in config”Bricks can be specified as a structured array (themes > categories > bricks), preserving category order without specifying theme and category on every brick. The config structure overrides the theme and category set on individual bricks.
See Configuration, Theme, Category
New feature: getDefaultProps for Repeated items
Section titled “New feature: getDefaultProps for Repeated items”Each repeaterItem can now define a getDefaultProps function to override its default props in a repeater.
See Repeated Items documentation
New feature: Image custom placeholder
Section titled “New feature: Image custom placeholder”Set a custom placeholder for each <Image> component.
See the Image documentation.
Improvements
Section titled “Improvements”- The select control
getOptionfunction now receives all the props as an argument. - In the Playground, the selected brick is persisted across page refresh
- On the
Linkcomponent, set thesimpleAnchorattribute to bypass the local link renderer (SPA router), even for local paths. - Better typing for the
Linkcomponent - Typings for the returned value of
getDefaultProps - Improved performance on large pages (core rewrite! ⚙️)
- Slashes are allowed in the page slug to enable better organization of paths in the website.
- Icons are outside the bricks by default
- In the Playground, the bricks with
hideFromAddMenu= true are hidden
- Removed brick min-height if icons are outside
- Fixed repeated items props in Playground
- Removed white border around bricks in preview
- Props for Stories in code are now as expected, like the
getDefaultPropsones - Sidebar radio controls: fixed problem with multiple radio buttons groups sharing the same values
- Sidebar: fixed problem with collapsing of groups of props, when changing focused brick
- Fixed text refresh for repeated items
3.8.10 (February 10, 2023)
Section titled “3.8.10 (February 10, 2023)”New feature: News in Admin for important communications
Section titled “New feature: News in Admin for important communications”Important announcements can now be shown in Admin.
Improvements
Section titled “Improvements”Improved featureFlags management.
3.8.9 (January 16, 2023)
Section titled “3.8.9 (January 16, 2023)”New feature: “can edit content” on locked block
Section titled “New feature: “can edit content” on locked block”Enterprise plans can now prevent content editing, both inline and via sidebar controls, for locked blocks. The same restriction can be applied to default content blocks with the canEditContent flag on the block default content.
- Removed two invalid DOM attributes from the Image component in Admin Preview.
3.8.8 (January 6, 2023)
Section titled “3.8.8 (January 6, 2023)”- Fixed bug in
imageClassNameintroduced in v3.8.7.
3.8.7 (January 3, 2023)
Section titled “3.8.7 (January 3, 2023)”Improvements
Section titled “Improvements”- New placeholder image, proportional to the Image
aspectRatio(if set), respecting themaxSize(if set).
3.8.5 - 3.8.6 (December 30, 2022)
Section titled “3.8.5 - 3.8.6 (December 30, 2022)”- Fixed props displayed in the Playground for multi-item Repeaters
- Fixed default props for multi-item Repeaters
- Fixed
keywarnings for Repeaters - Fixed hydration errors
3.8.4 (December 16, 2022)
Section titled “3.8.4 (December 16, 2022)”Improvements
Section titled “Improvements”- Improved performance of the “Add new” sidebar
- Restored pink border on parent block when a child block is focused
- Fixed duplicate block behavior
- Fixed hydration warning in PageViewer
3.8.3 (December 6, 2022)
Section titled “3.8.3 (December 6, 2022)”New feature: Theme
Section titled “New feature: Theme”Bricks can now define a theme, and editors can select themes in the “Add new” interface.
Improvements
Section titled “Improvements”- Improved the “Add new” UI with 2 columns
- Deprecated the
enablePreviewIconconfiguration key (if there is an icon, it is shown) - Updated packages
- Fixed RichText focus problem in development
3.8.2 (December 2, 2022)
Section titled “3.8.2 (December 2, 2022)”Improvements
Section titled “Improvements”- Improved performance of Text and RichText components
- Fixed sidebar controls props not changing properly
- Fixed quick flash of “Made in React Bricks” banner on paid plans
3.8.1 (November 14, 2022)
Section titled “3.8.1 (November 14, 2022)”Fixed a blocking bug caused by a missing dependency in the production bundle.
3.8.0 (November 10, 2022)
Section titled “3.8.0 (November 10, 2022)”New Feature (for Enterprise plans): Lock at block level
Section titled “New Feature (for Enterprise plans): Lock at block level”You can now lock individual blocks in a page instead of locking the entire page.
See Locked structure
New Feature: More flexible default for pageTypes
Section titled “New Feature: More flexible default for pageTypes”For a page type, you can now specify default content in multiple ways.
The array of blocks can contain, for each block:
- A string (the name of the brick, default content for the brick will be used)
- A brick name with a story name (the content from the story will be used) and lock status for the block (locked, canAddBefore, canAddAfter)
- A
IContentBlock(block content with every prop and lock status)
See Page Types
New feature: Stories in bricks’ schema
Section titled “New feature: Stories in bricks’ schema”You can now add stories for a brick in code by adding a stories array to the brick’s schema. This is useful for documenting stories that are part of your design system style guide. Editors will see both schema stories and stories they created. User-created stories can be deleted, while schema stories cannot, because they are part of the design system definition.
See Brick’s schema
Improvements
Section titled “Improvements”- The React Bricks version is now available on
ReactBricksContext, which you can access through theuseReactBricksContexthook. See useReactBricksContext. - The footer now shows the current React Bricks version. If it is not the latest version, a small warning icon shows the latest version in a tooltip.
3.7.0 (October 7, 2022)
Section titled “3.7.0 (October 7, 2022)”New feature: Entity Embed
Section titled “New feature: Entity Embed”You can now embed pages or entities inside another page, keeping them as a single source of truth. When the embedded page changes, the change is reflected in every page that embeds it. See Page / Entity embed
Improvements
Section titled “Improvements”- On a sidebar prop you can now set a
helpTextthat is rendered below the control. - You can now disable “click to edit” by setting
clickToEditSideto “NONE”, or by using aPageViewerwithshowClickToEditset tofalse.
3.6.1 (October 5, 2022)
Section titled “3.6.1 (October 5, 2022)”- Fixed a Repeater bug where repeated bricks using hooks caused a Rules of Hooks error.
- Fixed a collaboration bug with Remix
3.6.0 (September 30, 2022)
Section titled “3.6.0 (September 30, 2022)”New feature: Unsplash
Section titled “New feature: Unsplash”You can now search for images on Unsplash. See Unsplash integration.
You can configure your own Unsplash API key using the unsplashApiKey configuration parameter. Otherwise, each app is limited to 20 searches per hour.
Of course, you can disable the feature via the enableUnsplash configuration flag.
3.5.1 (September 22, 2022)
Section titled “3.5.1 (September 22, 2022)”Improvements
Section titled “Improvements”- You can now set the
shouldRefreshStylesflag on asideEditPropwhen changes to that prop can inject new CSS styles through a CSS-in-JS library. This ensures the new styles are loaded correctly.
3.5.0 (September 19, 2022)
Section titled “3.5.0 (September 19, 2022)”New feature: Nested Repeaters
Section titled “New feature: Nested Repeaters”The <Repeater> component now supports any level of nesting.
See Nested blocks
New feature: Repeater with multiple item types
Section titled “New feature: Repeater with multiple item types”A <Repeater> can have multiple types of repeated blocks. See Repeater Items
New feature: Preview bricks with image/icon
Section titled “New feature: Preview bricks with image/icon”You can set an image and an icon for each brick, so users can select bricks visually from the “Add new” menu. See Bricks schema
Improvements
Section titled “Improvements”- Much better CSS-in-JS support, also for libraries using the CSSOM to inject styles (remember to set the
cssInJsflag on the configuration) - Repeated items no longer need to spread
...reston the main element.
Possibility for a breaking change
Section titled “Possibility for a breaking change”We strongly suggest removing ...rest spreads from repeated items. Leaving them in place can cause browser warnings for unknown attributes on DOM elements, because rest now contains all block props, not only sidebar props.
If you destructure props with the same name as a prop that now comes from a visual editing component, such as an image, the prop in ...rest could override the other props.
3.4.3 (August 18, 2022)
Section titled “3.4.3 (August 18, 2022)”- Image: fixed fallback for WebP images
- Page featured image: added
featuredImagefor backwards compatibility
3.4.2 (August 8, 2022)
Section titled “3.4.2 (August 8, 2022)”Improvements
Section titled “Improvements”- Image: removed wrapping <div> in Admin
- Content editor: minor UI Improvements
- Update packages
- Sidebar: fixed tab jump on page metadata change
- Collaboration: avoid self page lock with HMR
- Text and RichText: fixed cursor jump when Text components are bound to a
metaFieldor acustomField
3.4.1 (August 4, 2022)
Section titled “3.4.1 (August 4, 2022)”- Fixed dependencies in the published package
3.4.0 (August 4, 2022)
Section titled “3.4.0 (August 4, 2022)”New feature: Collaboration! 🎉🎉🎉
Section titled “New feature: Collaboration! 🎉🎉🎉”Big milestone: React Bricks now supports real-time presence for users connected to an app, page-level locking, and the ability to force-unlock a page.
3.3.2 (July 27, 2022)
Section titled “3.3.2 (July 27, 2022)”New feature: Icons outside of blocks
Section titled “New feature: Icons outside of blocks”If you set the new blockIconsPosition property in the React Bricks configuration to types.BlockIconsPosition.OutsideBlock, the small icons for “add new block”, “delete block”, “duplicate block”, “move up”, and “move down” are rendered outside the block. This is useful for short blocks.
3.3.1 (July 20, 2022)
Section titled “3.3.1 (July 20, 2022)”RichText: thesoftLineBreakattribute was implemented but missing from the TypeScript interface. It is now available and works as expected.imageOptionsfor a sideEditProp or a custom field:maxWidthis optionalrelationshipOptionsfor a sideEditProp or a custom field:labelis optionalfilterByin fetchPages or usePages: better typings
3.3.0 (July 19, 2022)
Section titled “3.3.0 (July 19, 2022)”New feature: new Image component
Section titled “New feature: new Image component”- Generation of a WebP image, with fallback to JPEG (or PNG if transparent, or GIF if animated). You may disable the WebP generation via the
useWebPflag (trueby default). - Support for
sizesfor size art direction. - Support for native lazy loading. When browser support is detected, React Bricks uses native lazy loading instead of its own implementation. You can disable this with the
useNativeLazyLoadingflag (trueby default). You may also provide theloadingprop to override the defaultlazyvalue and set it toeager, although this is generally not recommended for performance. containerClassName,containerStyleandnoWrapperare deprecated. By default, no wrapper is rendered. The wrapper is still rendered only when using the oldcontainerClassNameorcontainerStyleprops.- You can provide the more flexible
renderWrapperfunction instead of the props above. TherenderWrapperfunction receives width and height as arguments, so you can calculate the image aspect ratio. - Works correctly even with JavaScript disabled.
New feature: Login UI and Menu customization
Section titled “New feature: Login UI and Menu customization”- For the Login UI, customize or remove the right image, add your logo with width and height, and change the welcome text and CSS style.
- For the Admin top menu, provide your own menu using the
getAdminMenufunction. It receives theisAdminargument and should return an array of objects withlabelandpath. External paths render as anchor tags, while local paths use router navigation.
New feature: Pages as Entities
Section titled “New feature: Pages as Entities”This feature makes it easier to use React Bricks as a headless CMS while still editing entity data visually.
- Visual editing of page Meta and Custom fields: the
Text,RichTextandImagecomponents can now be bound to page meta fields, such as title, description, language, and image, or to custom fields. UsemetaFieldNameorcustomFieldNameinstead of the usualpropName. Sidebar fields and visually edited fields are bound both ways. isEntityproperty onpageType: if you create a page type withisEntityset totrue, a new tab menu appears on the left to switch between Pages and Entities. Entities are pages for React Bricks, but they may not correspond to real pages in your frontend, keeping editors focused. For example, Entities can include Categories or Menu Items.- Custom fields of type
relationshipwithrelationshipOptions, used to specify the referencedpageType, label, and optionalmultipleflag for many-to-many relationships. - fetchPages has now a
filteroption to fetch pages based on custom fields’ value.
Improvements
Section titled “Improvements”Organization of pages in categories
Section titled “Organization of pages in categories”- On each
pageType, you can define an array of categories. - Editors can then use those categories to organize pages of that
pageTypefrom the Page tab.
3.2.29 (June 30, 2022)
Section titled “3.2.29 (June 30, 2022)”Bug fixes
Section titled “Bug fixes”- File modal: use
target="_blank"to download files. - Fixed plan limits for AppSumo users.
3.2.28 (June 29, 2022)
Section titled “3.2.28 (June 29, 2022)”Bug fixes
Section titled “Bug fixes”- Fixed default page size limit in fetchPages.
3.2.27 (June 28, 2022)
Section titled “3.2.27 (June 28, 2022)”Bug fixes
Section titled “Bug fixes”- Fixed bug in the bricks label with no repeaterItems.
3.2.26 (June 10, 2022)
Section titled “3.2.26 (June 10, 2022)”Improvements
Section titled “Improvements”- Show label of selected brick in the right sidebar.
3.2.25 (May 17, 2022)
Section titled “3.2.25 (May 17, 2022)”Bug fixes
Section titled “Bug fixes”- Fixed the
IImageSourceinterface: width and height are no longer mandatory.
3.2.24 (April 21, 2022)
Section titled “3.2.24 (April 21, 2022)”Improvements
Section titled “Improvements”- Playground: better formatted code and style fixes
3.2.21 - 3.2.23 (April 20, 2022)
Section titled “3.2.21 - 3.2.23 (April 20, 2022)”New features
Section titled “New features”- Added categories to the Playground sidebar.
Bug fixes
Section titled “Bug fixes”- Fixed hydration in
PageViewerfor React 18 compatibility. - Fixed a bug in RichText
renderItalic. - Minor bug fixes.
3.2.19 - 3.2.20 (April 5, 2022)
Section titled “3.2.19 - 3.2.20 (April 5, 2022)”New features
Section titled “New features”- Added scheduled publishing warnings.
- Added Editorial calendar in Admin.
Bug fixes
Section titled “Bug fixes”- Fixed a bug where scheduled publishing was not updated on page change.
- Minor bug fixes.
3.2.17 - 3.2.18 (March 14, 2022)
Section titled “3.2.17 - 3.2.18 (March 14, 2022)”New features
Section titled “New features”- Added soft line break to
RichText.
Improvements
Section titled “Improvements”enablePreviewtrue by default in ReactBricksConfig.
3.2.14 (March 8, 2022)
Section titled “3.2.14 (March 8, 2022)”New features
Section titled “New features”- Added “Keep me logged in” to the login interface.
Bug fixes
Section titled “Bug fixes”- Minor bug fixes.
3.2.12 - 3.2.13 (February 28, 2022)
Section titled “3.2.12 - 3.2.13 (February 28, 2022)”New features
Section titled “New features”- Added Preview link in Admin.
Bug fixes
Section titled “Bug fixes”- Minor bug fixes.
3.2.11 (February 18, 2022)
Section titled “3.2.11 (February 18, 2022)”New features
Section titled “New features”- Added the
noWrapperprop to the Image component to avoid the wrappingdiv.
Improvements
Section titled “Improvements”- Graphics update:
RichTexttoolbar always inside the brick space. - Added
aspectRatioto the Image control in Side Edit Props.
Bug fixes
Section titled “Bug fixes”- Boolean Side Edit Props now default to
falseinstead ofnull.
3.2.10 (February 7, 2022)
Section titled “3.2.10 (February 7, 2022)”Improvements
Section titled “Improvements”getDefaultPropsis no longer mandatory in theschema.- Graphics update:
RichTexttoolbar always inside the rich text space.
Bug fixes
Section titled “Bug fixes”- Minor bug fixes.
3.2.8 - 3.2.9 (January 22, 2022)
Section titled “3.2.8 - 3.2.9 (January 22, 2022)”Improvements
Section titled “Improvements”- Number of pages per type beside the type name in the sidebar.
- When adding a new block, the search input is now focused automatically.
Bug fixes
Section titled “Bug fixes”- Minor bug fixes.
3.2.6 - 3.2.7 (December 31, 2021)
Section titled “3.2.6 - 3.2.7 (December 31, 2021)”Bug fixes
Section titled “Bug fixes”- Added
useVisualEditto the frontend bundle. - Added
blockPluginConstructor,markPluginConstructor, and plugins to the frontend bundle. - Minor bug fixes
3.2.5 (December 20, 2021)
Section titled “3.2.5 (December 20, 2021)”New features
Section titled “New features”- Added
simpleFetchTagsanduseTags.
3.2.4 (December 13, 2021)
Section titled “3.2.4 (December 13, 2021)”New features
Section titled “New features”- Added the
indexprop toitemsinRepeaterto support conditional rendering based on item index. - Added
newItemMenuOpenin a brick’sschema.
Bug fixes
Section titled “Bug fixes”- Minor bug fixes.
3.2.1 - 3.2.3 (December 10, 2021)
Section titled “3.2.1 - 3.2.3 (December 10, 2021)”New features
Section titled “New features”- Added useAdminContext to the exported bundle.
Improvements
Section titled “Improvements”- Added a popup in Admin when the user’s email address is not verified.
Bug fixes
Section titled “Bug fixes”- Minor bug fixes.
3.2.0 (December 7, 2021)
Section titled “3.2.0 (December 7, 2021)”New features
Section titled “New features”- New App settings page with direct links to the dashboard.
Improvements
Section titled “Improvements”- New page hint if there are less than 3 pages.
3.1.2 - 3.1.9 (December 3, 2021)
Section titled “3.1.2 - 3.1.9 (December 3, 2021)”New features
Section titled “New features”- Added default export for
react-bricks/frontend.
Bug fixes
Section titled “Bug fixes”- Minor bug fixes.
3.1.1 (December 2, 2021)
Section titled “3.1.1 (December 2, 2021)”New features
Section titled “New features”- New
Filecomponent that allows editors to upload files that may be downloaded by users on the frontend.
Improvements
Section titled “Improvements”- Smaller JS footprint on frontend: now the library exports two bundles: “frontend” and “admin”.
3.0.1 (November 1, 2021)
Section titled “3.0.1 (November 1, 2021)”New features
Section titled “New features”3.0.0 (November 1, 2021)
Section titled “3.0.0 (November 1, 2021)”New Features
Section titled “New Features”- Compatibility with Gatsby: now React Bricks is fully compatible with Gatsby (you can find 2 starters for Gatsby)
- Stories: you can now save brick configurations (sets of props), so that you (or your editors) can reuse them
- Images crop and fixed aspect ratio: upon upload it is possible to crop an image. You can set a fixed aspect ratio on the
Imagecomponent, so that the crop will be limited to that aspect ratio. - Bricks organization: you can now assign a
categoryto each brick and an array oftags. Bricks are organized by category and searchable by name or tag. You can also add a link to external documentation for each Brick, which is shown in the Playground. - Backup and restore: You can now backup the App content and restore it from the React Bricks Dashboard.
- History: go back in time for each Page and restore the status before any action.
- Scheduled publishing (Pro only): with a Pro plan, you can schedule the publishing of a page at a date in the future. React Bricks will change the page status from Draft to Published on that date. Based on the “Trigger rebuild upon scheduled publishing” checkbox in the build hooks settings, React Bricks will trigger a rebuild when the page is published, so that the content will be visible at the scheduled date and time with no action needed on your side.
- Staging Build Hook (Pro only): now you can set a build hook for the Staging environment and give permissions accordingly to your editor users, so that a user may be able to trigger a build in staging but not in production.
- Events webhook (Enterprise only): if you are on an Enterprise Plan, you can set a webhook that receives all the Pages and Translations events (creation, update, delete).
- mapExternalDataToProps on schema, used by Block and BlockViewer.
- getExternalData on page types, used by usePage, usePagePublic, and simpleFetchPage.
- Added the
multilineprop on RichText and Text, and fixed duplicate save mutations with the “mod + s” hotkey.
Improvements
Section titled “Improvements”- The
RichTextcomponent now supports Heading H1..H6 and Quote by default. - Added the
RichTextExtcomponent, an extensible RichText with a plugin system. The original RichText component, kept for compatibility, uses RichTextExt internally. shouldRefreshTextis no longer needed onsideEditPropsthat affect the style of Text or RichText components.- New JSON format that, on average, reduces the transferred payload by 50%.
- Removed the wrapper
<div></div>around the renderBlock.
Bug fixes
Section titled “Bug fixes”- If you set a minimum in
repeaterItems, adding a new block now displays the minimum number of that item.
Breaking changes
Section titled “Breaking changes”- On the Page returned by fetchPage or usePage, the
translationsarray isn’t an array of language strings anymore, but an array of objects withlanguageandslug.
Migration
Section titled “Migration”If you need to migrate from v2 to v3, please contact React Bricks support for guidance.