[[block-create-custom.txt]]
=== Creating A Custom Block


==== Goal
To create a custom block to display a simple "Hello World" message that could be extended to display other information such as store hours, custom images, or embedded HTML from sources such as twitter, google adwords, etc. 


==== Prerequisite knowledge

<<block-concept>>


==== Site prerequisites


The creation of a custom block is a core function of Drupal and only requires appropriate permissions. 
You will need either to be part of the Administrator Role or to be granted the "Administer Blocks" permission.


==== Steps
For this tutorial we will create a simple "Hello World" block that can be displayed in 
  any of the regions

. Navigate to the Block Layout Administration page to create a custom block
  Click Structure in the Administration menu then click Block Layout
  On the Block Layout page click the "+Add custom block" button located above the regions

. A custom block requires only the "Block description" field, but filling in both the 
description and a body is most common. Type in the following then click save:
  
  Block Description: "Hello World Block"
  Body: "Hello World!"

[start=3]
. Place your block on a page. A newly created block will not appear on your website until you place it within a region. Do this by following these steps:
.. On the block layout page locate the filter text box on the right side of the page.
.. Type "Hello World" in the Filter box. This will help you quickly find your block
  (Alternatively you can locate your block under the "Custom" category)
.. Click the block's title to open the "Configure block" page
.. Select the region of the page you would like the block to appear. + 
  For information on Regions please read Block Regions section <<block-regions>>

.. Click Save to save the configuration + 
  (Tip: If the block doesn't immediately appear in the appropriate region it may be cached. You can either wait for the cache to be refreshed or manually refresh the cache in the Performance configuration located at Configuration -> Performance --> Clear all caches in the Administration section)

==== Follow-on tasks


Editing your custom block 

All custom blocks appears in the "Custom block library", which is accessible by navigating to the Block layout page and clicking on the "Custom block library" link at the top of the section. Once on the page find your custom block and click the edit link to the right of the Block description. Similar to editing content you may choose to save a revision of your block. 


==== Additional resources


https://www.drupal.org/documentation/modules/block