How to use Oxygen Builder with Gutenberg

Decide whether Gutenberg will edit individual Oxygen-designed blocks or an entire page. The individual-block approach is safer for clients because you can expose text, images, icons and links while keeping the layout controlled. A full-page block is useful when the whole page follows one fixed design.

Oxygen's documented Gutenberg integration belongs to Oxygen Classic and requires the separate Oxygen Gutenberg plugin. If the relevant Oxygen menus are missing, check the Oxygen version and confirm that the plugin is active before changing templates or content.

Install and activate the Oxygen Gutenberg plugin, then open a post or page and check that Oxygen's Gutenberg-related options are available. Do this on staging first, because changing the editing model on an existing site can alter who can edit layouts.

Do not disable Gutenberg block CSS in Oxygen → Settings → Performance until you have checked the front end. That setting can remove the CSS used by Gutenberg blocks, leaving blocks looking unstyled unless you add replacement CSS.

In Oxygen, create a block in one of three ways: open Oxygen → Block Library and create one, use a Section or Div's menu in the Structure pane and choose Copy to Block, or mark a designed page with Make This Full Page Editable In Gutenberg.

Keep the editable areas deliberate. Use text elements for copy, image elements for images, and link fields for URLs. Avoid assuming every Oxygen element will have an editable preview in Gutenberg.

Open the target post or page in Gutenberg, click the plus button, and choose the block from Oxygen Blocks. Full-page designs saved through the page option appear under Oxygen Full Page Blocks.

Edit text and images directly in the block. Icons, background images and URLs are edited from the block sidebar. Save the page and check the front end, especially responsive spacing, background images and links.

After the blocks are working, hide the Oxygen meta box for the relevant post types in Oxygen → Settings → Post Type Manager. You can also use Settings → Role Manager to remove Oxygen access from non-administrator users. This leaves editors in Gutenberg while keeping the visual builder out of their normal workflow.

Remember that editing the original block in Oxygen changes its design everywhere it is used. Gutenberg content changes normally remain, but they can be lost if the corresponding element is deleted from the Oxygen design. Repeater and Dynamic Data elements may show placeholders in Gutenberg even though they still render on the front end.

For a site that needs this workflow across many layouts, use Oxygen Gutenberg Integration instead of setting up each bridge manually. It is intended to connect Oxygen layouts and reusable blocks with Gutenberg, including custom blocks and dynamic content workflows.

Install and activate it, create one representative block, and verify that its editable fields, front-end styles and dynamic content work before rolling the pattern out across the site. Keep Gutenberg and Oxygen editing separate on the same page to avoid conflicting layout controls.