Skip to main content
Are you okay? Emergency/Crisis UOIT Home

Bricks (re-usable content)

Brick - A type of CMS asset that allows you to pre-define any piece of content for use in multiple pages on any website. Each brick has a unique identifying name. When this identifier is referenced on other pages, the full brick content is embedded on the page.

For example, in this CMS Training Guide, definitions for terms are used on multiple pages (such as the term "WYSIWYG"), but it would be impractical to repeatedly enter the full definition on every page where it is required. A change to the definition would mean that every page where the term is used would have to be updated. Instead, the "WYSIWYG" definition can be defined once using a brick, which can then be re-used on multiple pages.

About bricks

  • How bricks work

    A bricks page is created, which contains a list of all available bricks. This page does not get published to the live site - it is only used within the CMS system. A unique identifying name is given to the brick in the Name field. The full brick content is entered in the Value (text) field.

    Screenshot: creating the brick

    Then, on pages where the brick content is required, the brick's name can be entered using square bracket notation. When the page is viewed outside of the content editor, the square brackets and brick name is automatically replaced with the full brick content. 

    The page content editor:
    Screenshot: Enter the brick name in square brackets on the page content

    The actual page view:
    Screenshot: Brick example on page

  • Types of content that can be used in bricks

    Brick content can be as simple as a short sentence, or it can contain more complex content such as formatted text or images. It can even contain content that has a custom template applied.

    For simple text content that does not require any additional formatting, enter your content in the Value (text) text field.

    Screenshot: Enter simple brick content in the Value (text) field

    For more complex content, use the Value (HTML) WYSIWYG field. You can place any content here that you would normally enter on a page (paragraphs, formatted text, images, links, etc). 

    Screenshot: Enter complext brick content in the Value (HTML) field

    If you have requested a custom CMS template from the Web Team, use the Custom page and Custom format fields. The Web Team will advise you of what page to select and what text to enter in the Custom format field. 

    Screenshot: For custom brick content, reference the templated page using the Custom page and Custom format fields

How to create and use bricks

  • How to create a brick

    1. The Web Team will create an empty or default bricks page for you. Browse to and edit this page. 
    2. Select the green plus icon underneath the Brick section label to create an additional brick. 
      Screenshot: Add another brick
    3. Enter a unique name for the brick in the Name field. The name of your department and subject can be used to identify your brick. 
      Screenshot: Enter a unique brick name

      For example:
      The Communications and Marketing department has several definitions used for the CMS Training Guide. If a definition is required for the term "WYSIWYG", a unique identifier or name for this brick could be "cm_cms_WYSIWYG". 
      "cm" indicates that this brick belongs to Communications and Marketing, "cms" indicates that this brick has to do with the CMS, "WYSIWYG" is the term being defined. 

    4. Enter the brick content in one of the three areas as defined above, either the Value (text) field, the Value (HTML) field, or reference a custom page using the Custom page and Custom format fields. 
    5. Submit the page.
  • How to reference a brick on a page

    1. Edit the page where you want the brick content to appear.
    2. Wherever you want the brick to appear, enter the name of the brick in square brackets.
      Screenshot: Enter the brick name in square brackets on the page content

      For example:
      If the brick name is "cm_cms_WYSIWYG", enter "Pronounced WIZ-ee-wig; an acronym for 'what you see is what you get'. A type of content editor similar to a word processor that allows you to format and preview page content." 
    3. Submit the page and preview it. The square brackets and brick name will be replaced with the brick content.
      Screenshot: Brick example on page