Block Settings Overview

Every block in BF Blocks has a set of core settings that control how it appears in the Gutenberg inserter and what capabilities it exposes to editors.

Core Settings

Block Name

title

The human-readable name shown in the Gutenberg inserter. Spaces allowed. Example: Testimonial Card.

Slug

name

Auto-generated from the block name. Prefix is always bf-blocks/. Example: bf-blocks/testimonial-card. Cannot contain spaces.

Icon

icon

A Dashicon slug or custom SVG. Appears in the block inserter and toolbar.

Category

category

Groups the block in the inserter. Default categories include Text, Media, Design. You can register custom categories.

Keywords

keywords

Up to 3 additional search terms. Helps editors find the block when searching.

Description

description

Short text shown in the block inserter panel. Helps editors understand what the block does.

Supports

The Supports section controls which standard Gutenberg features are available for your block.

Anchor

Adds an HTML anchor input so editors can link to the block from other pages.

Custom CSS Class

Adds a CSS class input in the Advanced panel. The value is passed as $block['className'].

Alignment (wide, full)

Shows alignment controls in the toolbar. Wide = max-width container, Full = full viewport width.

Alignment (left, center, right)

Inline alignment controls.

Generated block.json

BF Blocks generates a block.json file for every block you save. This file is the source of truth for WordPress block registration. You never need to edit it manually — BF Blocks keeps it in sync with your builder settings.