INTEREST JOURNAL DRUPAL & WEB

Drupal Guide in Detail: 8.1 Concept: Blocks

About 500 words 3 min read

Japanese ↗
On this page

Detailed guide. An unofficial adaptation of User Guide 8.1. Source updated April 14, 2025; reviewed November 6, 2026. No running-Drupal procedure test has been performed.

Official source ↗ · Chapter 8 overview · Next: 8.2 Creating a Custom Block

Goal

Distinguish a block from the region provided by its theme. Treat creating content, choosing a location and setting visibility as separate tasks.

Adapted explanation

Blocks are individual parts of a page layout. Examples include navigation, breadcrumbs and the online-user list; the main page content is a block too. Place them in theme regions and manage placement and order under Structure → Block layout (/admin/structure/block).

Modules can provide blocks, or you can create custom content blocks. The source uses a configured Search module’s search-form block as an example; read the provider qualification below.

Each placement can have its own configuration and page-visibility conditions. Multiple placements of the same block can use different settings.

Content, placement and visibility

Our comparison of the source concepts:

Question Where to look
Change opening-hours text Edit the content block; see 8.2
Change its sidebar position Use the relevant theme’s block layout; see 8.3
Show it only on particular pages Review that placement’s visibility settings
Missing after a theme change Check placement for the theme actually serving the page

Available regions depend on the theme. Read the region summary or official 2.1 ↗ .

Our verification example

On a test site, compare the menu, breadcrumbs and main content with entries in Block layout. Record whether a block has merely been saved or also placed. Where visibility is restricted, check both intended and excluded pages as ordinary and anonymous users. Permissions and publication state can affect the result.

Troubleshooting notes

Our addition: check content existence, placement in the active theme and matching visibility conditions in that order. Distinguish editing stored content from removing a placement. Ordinary block placement and Layout Builder are separate workflows.

Update note: Search’s provider

Drupal 11.5.0-beta1 ↗ lists Search as a deprecated core extension; 12.0.0-beta1 ↗ includes it among extensions moved out of core. Check the Drupal branch and the installed Search project’s compatibility before following that example.

This does not mean that Views filtering is removed. It is also separate from this Hugo site’s JavaScript search. These beta notes describe testing targets, not a recommendation to run a beta in production.

Existing chapter note · Related release week

Sources, credits and changes

Source: Drupal User Guide 8.1 ↗ . Contributors and source links listed in its Attributions: Les Lim ↗ · “Managing blocks” ↗ · Drupal Community Documentation ↗ . Refer to the source for writing, editing and adaptation roles, and to the guide-wide credits ↗ .

Copyright remains with the individual contributors; the official copyright page ↗ states © 2015–2025. Changes include reorganized explanations and procedures, our preparation and verification examples, troubleshooting notes, source-interpretation qualifications and release references. Original screenshots and videos are not reproduced. This adapted text is shared under CC BY-SA 2.0 . It is not an official edition or endorsement. This notice does not license unrelated articles or the site design.

Chapter 8 overview · Next: 8.2 Creating a Custom Block

Chapter 7 details · Chapter 9 · All chapters · Search official information

Back to chapter contents ↗