INTEREST JOURNAL DRUPAL & WEB

Drupal Guide in Detail: 8.2 Creating a Custom Block

About 500 words 3 min read

Japanese ↗
On this page

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

Official source ↗ · Previous: 8.1 Concept: Blocks · Chapter 8 overview · Next: 8.3 Placing a Block in a Region

Goal

Create the market’s hours-and-location content block. Saving content here is separate from placing it in 8.3 .

Prerequisites and preparation

Read 8.1 and official 2.1 on regions ↗ .

Our preparation note: use a test site and an account allowed to create content blocks. Prepare the administrative description separately from visitor-facing text. The location and opening hours below belong to the source’s fictional example.

Adapted procedure

  1. Open Content → Blocks at /admin/content/block.
  2. Choose Add content block.
  3. Enter a description and body using the example below.
  4. Choose Save and check confirmation.
Field Meaning Source example, paraphrased
Block description Administrative identifier Hours and location block
Body Visitor-facing content Open on Sundays, 9 AM–2 PM, April–September; at the Trust Bank parking lot, 1st and Union, downtown Anytown

The administrative description is distinct from the display title configured during placement.

Edit the saved content

The source also describes returning to Content → Blocks, finding the block and choosing Edit. Save content changes there. Continue with placement to put it in a sidebar.

Our checks after saving

  • Does the list show the intended administrative description?
  • Does reopening the editor show the saved time and location?
  • Have you edited the intended block?
  • After placement, can the intended ordinary or anonymous visitors see it?

Our addition: check the selected text format when using line breaks or formatting. Do not broaden editing privileges merely to allow arbitrary HTML.

Troubleshooting notes

Our addition: saved content may still need placement . If editing controls are absent, check installed modules and the operator’s permissions. Permission to view unpublished content is not a substitute for permission to create, edit or place it.

Update note: viewing unpublished blocks

Drupal 11.4.0 ↗ introduces view unpublished block content. Review whether an editor needing unpublished-content visibility can use that permission instead of broad block-administration permissions.

This concerns viewing; it does not grant every creation, editing, placement or publication action. Check the actual roles and publication state. See the Chapter 7 permission detail .

Existing chapter note · Related release week

Sources, credits and changes

Source: Drupal User Guide 8.2 ↗ . Contributors and source links listed in its Attributions: Jacob Redding ↗ · Boris Doesborg ↗ · 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.

Previous: 8.1 Concept: Blocks · Chapter 8 overview · Next: 8.3 Placing a Block in a Region

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

Back to chapter contents ↗