Skip to content

Content Blocks Options

The Content Blocks Options feature in the Topol Plugin gives developers and product teams the ability to control how each content block behaves inside the editor. Whether you want to restrict certain blocks from being used, completely hide them, or simply display a tooltip explaining why they are unavailable, this feature offers the flexibility you need to tailor the editing experience to your use case.

You can configure the behavior of individual Content Blocks available in the editor. This includes core Content Blocks, which are text, image, gif, button, divider, spacer, social, video, html, or product.

For each block, you can:

  • Disable it (make it non-draggable but still visible with a tooltip)
  • Hide it completely from the editor sidebar
  • Add custom tooltip text when the block is disabled (explaining why it’s unavailable)

Configuration

To customize the behavior of a specific core Content Block, adjust its properties within the contentBlocks object:

ts
contentBlocks: {
    text: { // name of core content block (text, image, button, ...)
        disabled: true | false, // when true, the block appears grayed out and cannot be dragged into the editor
        disabledText: 'Text In Tooltip', // a tooltip message that appears when hovering over a disabled block
        hidden: true | false, // when true, the block is completely removed from the sidebar and hidden from view
    },
}