Basker Docs

Building pages with blocks

Add and arrange content on a page using the blocks your theme provides

Pages in Basker are built from blocks — self-contained sections of content that you stack vertically to make up the page. A block might be a hero banner, a row of text and image, a list of upcoming events, a video embed, or anything else your theme exposes.

The blocks available to you come from your theme. Different themes ship with different blocks, so the picker on a site running one theme won't be the same as another. For developer-level information about how a theme defines its blocks, see basker.dev.

Adding a block

Open a page in the editor. The content area shows the blocks already on the page in the order they appear on the live site.

To add a new block, click the + at the position you want the new block to appear, pick a block type, and fill in its content. Save when you're done.

Reordering and removing blocks

Each block has a drag handle — drag a block up or down to change its position on the page.

Each block also has a remove option. Removing a block deletes its content from this page. If the block referenced a reusable section, only the reference is removed; the reusable section itself stays intact.

Editing a block

Click a block to edit its content. Each block's content is independent — editing one block doesn't affect the others.

If a block contains nested elements — for example, a row of feature cards each with their own title and description — you can edit each nested element in place.

Analytics settings

Each block has optional Analytics Key and Analytics Label settings, grouped under an Analytics section in the block's settings. Fill these in when you want a block to report under a stable, human-readable name in Google Analytics. Both are optional, and leaving them blank changes nothing about how the block looks or behaves. See Google Analytics for how the key and label are used in reporting.

Block types your theme provides

The blocks available to you are defined by your theme. Common patterns include:

  • Layout blocks — hero sections, headers, columns, dividers, calls to action.
  • Text and rich content blocks — paragraphs, headings, quote blocks, formatted lists.
  • Media blocks — image galleries, single images, video embeds.
  • Listing blocks — automatically-generated lists of events, posts, or other content, often powered by smart collections.
  • Form blocks — embedded forms or sign-up widgets.

Your theme may also expose blocks that are specific to your brand, industry, or content model.

Where to go next

On this page