Skip to content

Block Types and Configuration

User roles

Administrator, Mukurtu manager

Block types

Content blocks

  • Call to Action: A call to action block enables a block with text and a button that redirects users to a specific site. Calls to action can be used to direct users to specific campaigns or to bring attention to particular aspects of the site.

    Screenshot of the call to action block.

  • Featured Content: This block enables users to showcase featured content on their site. For more information on configuring featured content blocks, refer to Configure a Featured Content block.

    Screenshot of the featured content block.

  • Full Image With Description: This block can be configured to feature a full-width background image block with overlaid title and description text, or a full text hero with a title and description. For more information on configuring featured content blocks, refer to Configure a Full Background Block.

    Screenshot of the full image with description banner.

    Screenshot of the full image with description text only banner

  • Horizontal divider: This block adds a grey horizontal divider to your landing page.

    Screenshot of the horizontal divider block.

  • Image with Description: This block features a half-page, right jusitified welcome banner in our classic Red and Bone color palette. For more information on configuring featured content blocks, refer to Configure Image with Description Block.

    Screenshot of the image with description banner.

  • Local Contexts: This block allows users to feature Local Contexts projects and labels from their site.

  • Media assets: This block allows users to feature media assets. Please note, these media assets come from your media library so Cultural Protocols are required.

  • Text: This block adds a formatted text field to the landing page.

  • Vertical Image with Description: This block features a single column block with the image on top, followed by title and text below. For more information on configuring featured content blocks, refer to Configure a Vertical Image With Description Block.

    Screenshot of the welcome to your Mukurtu CMS site (vertical) banner.

Lists (Views) blocks

  • Browse by Category (names only): This block features all of the categories on your site. This features the categories only by name and does not include a category thumbnail. Categories are automatically added to this block when they are created.

  • Screenshot of the Browse by Category (names only) block.

  • Browse by Map: Map Block: This block highlights the locations of content using an embedded Leaflet map. Map points are automatically added to this block when they are created.

    Screenshot of the browse by map block

  • Mukurtu Categories: This block features all of the categories on your site and includes the category name and thumbnail. If a category thumbnail has not been included, the default category thumbnail will be featured. Categories are automatically added to this block when they are created.

    Screenshot of the Categories block

Mukurtu

  • Browse by Community: This block highlights all the communities on your site that users have permission to view. Communities are automatically added to this block when they are created.

    Screenshot of the browse by community block

Configure content blocks

Content blocks include the Call to action, Featured Content, Full Image with Description, Horizontal divider, Image with Description, Local Contexts, Media assets, Text, and Vertical Image with Description blocks. Follow the instructions below to configure your content blocks.

Select the "Edit" icon and then select "Configure" on the blocks you want to configure, or configure new blocks as you add them.

Screenshot of the image with description block with the edit icon for the image with description block highlighted.

Screenshot of the image with description block with the edit icon expanded and the configure button highlighted.

Call to action

A call to action block enables a block with text and a button that redirects users to a specific site. Calls to action can be used to direct users to specific campaigns or to bring attention to particular aspects of the site.

  1. Add a title in the required Title field. You can use the optional Display title toggle to configure whether the title is displayed or not.
  2. You can use the full text HTML Text box to add explanatory text or embedded media.

    Screenshot of the title and text box with a title and sample lorem ipsum text added.

  3. Use the URL and link text fields to include a link.

  4. Select the "Add block" button to add your call to action block.

    Screenshot of the button link fields and the add block button in the modal.

  5. You can continue to add blocks, or select the "Save" button in the top right-hand side of the page to save your layout.

    Screenshot of the edit layout page with the save button in the top right highlighted.

Tip

It is recommended to save your layout as you add blocks in order to avoid losing your work.

You can add a featured content block to your landing page or your basic page. They are both configured from a particular page, so will not impact any featured content displayed on another page. To add a

  1. Add a title to your featured content block using the Title field. Use the Display title toggle to choose whether your title is displayed.
  2. Select the "Select Content" button to add content to your featured content block.

    Screenshot of the configure block modal for featured content with the select content button highlighted.

  3. Select content to add to your featured content block, then select the "Add content" button to add your content.

  4. Select the "Remove" button to remove any content you do not want included.
  5. Select a "Display style" radio button for your block. You can choose to display your block as either a grid or a carousel.
  6. Select the "Add block" button to save your featured content block.

    Screenshot of the configure block modal for featured content with content added and the add block button highlighted.

  7. You can continue to add blocks, or select the "Save" button in the top right-hand side of the page to save your layout.

This is an example of the featured content block displayed as a grid:

Screenshot of the featured content block with a grid layout.

This is an example of the featured content block displayed as a carousel:

Screenshot of the featured content block with a carousel layout

Configure Full Background block

The Full Background block allows users to set a full background image or text only hero. It includes an option to configure the overlaid text color. Follow the instructions to configure the full background block.

  1. Use the Block description field to rename your Welcome block.
  2. Use the Body field to provide more information about your site.

    Screenshot of the Edit content block welcome to your Mukurtu CMS site featuring the block description and body fields.

  3. To configure the full background block with an image, use the "Add media" button. For more information on adding media assets, refer to the Create Media Assets Overview.

  4. Select your image, then select the "Insert selected" button.
  5. Use the Text Color dropdown to select Dark or Light text. Choose your text color based on background contrast. Light uses white text, Dark uses brand primary dark color. Always verify color contrast meets accessibility standards (WCAG AA minimum 4.5:1 ratio) using an accessibility tool before publishing.

    Screenshot of the edit content block welcome to your Mukurtu CMS site featuring the add media and text color dropdown, with the text color dropdown highlighted.

  6. Use the Background dropdown to select None, Brand color, or Soft brand color. This is used when no image is selected. If an image is included, the image is the background and the text color applies instead.

    Screenshot of the configure block background dropdown with the dropdown highlighted and featuring none.

  7. Select the "Save" button to save your welcome block.

Configure Image with description and Vertical image with description blocks

The Image with Description and Vertical Image with Description welcome blocks are configured the same way, and allow image and video uploads. Follow the instructions to configure your block.

  1. Use the Block description field to rename your Welcome block.
  2. Use the Body field to provide more information about your site.

    Screenshot of the Edit content block welcome to your Mukurtu CMS site featuring the block description and body fields.

  3. Use the "Add media" button to add a media asset to your welcome block. You can add an image or a video. For more information on adding media assets, refer to the Create Media Assets Overview.

    Screenshot of the media modal with the Add media button highlighted.

  4. Select your media asset, then select the "Insert selected" button.

    Screenshot of the media modal with the insert selected button highlighted.

  5. Select "Save" to save your welcome block.

Horizontal divider

You may choose to add a horizontal divider block to your page. Select the Horizontal divider link, then select the "Add block" button.

Screenshot of the configure block modal for the horizontal divider block with the add block button highlighted.

The horizontal divider block is a light grey line that extends the width of one column in your section.

Screenshot of the horizontal divider line highlighted.

You can continue to add blocks, or select the "Save" button in the top right-hand side of the page to save your layout.

Local Contexts

To add a Local Contexts labels and notices block, select the Local Contexts link. You can add an entire Local Contexts project or individual labels and notices to your block.

  1. Add a title to your Local Contexts block using the Title field. Use the Display title toggle to choose whether your title is displayed.
  2. In the Local Contexts projects section, use the checkboxes to select projects to add to your block. This will apply all of the labels and notices under the project.
  3. In the Local Contexts labels and notices section, use the dropdown menu to expand a project. Then use the checkboxes to apply individual labels and notices to your block.

    Screenshot of the local contexts configure block modal with a title filled in and the local contexts projects checkbox and labels and notices dropdown highlighted.

    Screenshot of the local contexts configure block modal with teh labels and notices dropdown expanded and the checkbox to the left of the tk outreach and tk attribution labels selected.

  4. Select "Add block" to add your Local Contexts block.

  5. You can continue to add blocks, or select the "Save" button in the top right-hand side of the page to save your layout.

    Screenshot of the about page example basic page with the save button in the top right-hand corner highlighted.

Media assets

To add a media assets block to your basic page, select the Media assets section.

  1. Add a title to your Media assets block using the Title field. Use the Display title toggle to choose whether your title is displayed.
  2. In the Media items section, select "Add media" to add media assets to your block. Multiple media assets display as a carousel.

    Screenshot of the media assets configure block modal with the add media button highlighted.

  3. Select your media assets using the checkboxes, then select the "Insert selected" button.

    Screenshot of the add or select media modal with two media assets checked.

  4. Select the "Add block" button to add your media asset block.

    Screenshot of the add media assets configure block modal with the add block button highlighted.

  5. You can continue to add blocks, or select the "Save" button in the top right-hand side of the page to save your layout.

Text

To add a text block to your basic page, select the Text section.

  1. Add a title to your text block using the Title field. Use the Display title toggle to choose whether your title is displayed.
  2. Use the full text HTML field to add text or embedded media to your block.
  3. Select the "Add block" button to add your text block.
  4. You can continue to add blocks, or select the "Save" button in the top right-hand side of the page to save your layout.

Add a block

Select the "Add block" button to add a new block to your landing page.

Screenshot of the landing page edit layout form with the add block button highlighted.

Edit a block

  1. Navigate to the Edit icon to the right of your block. Select Configure block to edit your block.

    Screenshot of the edit icon and menu to the right of the block with the icon and the menu highlighted.

  2. You can edit your block's title display status, items per block, or override the display title.

    • You may choose to hide the display title by selecting the toggle.
    • Items per block is set to "0" by default. This setting allows your block to display even without applicable content.
    • You may select the toggle to override the display title. If you choose to override the display title, enter a new title in the Title field.
  3. Select "Update" to update your block.

    Screenshot of the configure block menu with the update button highlighted.

  4. Select "Save" to save the updates to your landing page.

Delete a block

  1. Navigate to the Edit icon menu and select the Remove block link.
  2. Select the "Remove" button to remove your block. If you choose not to remove your block, select "Cancel".

    Screenshot of the Remove Mukurtu block menu with the remove button highlighted.

  3. Select "Save" to save the updates to your landing page.

Rearrange blocks

You can rearrange the blocks on your landing page by selecting a block and dragging it into your preferred order. You can also use the "Move" button to move your block to different sections.

  1. Navigate to the Edit icon menu and select the Move link.
  2. To move your block to a new section, select the section from the dropdown menu.

    Screenshot of the rearrange blocks menu with the dropdown section menu highlighted.

  3. Select and drag your block into your preferred order using the Rearrange icons.

    Screenshot of the rearrange blocks menu with the rearrange icon highlighted.

  4. Select the "Move" button to finalize your block arrangement.

    Screenshot of the rearrange blocks menu with the move button highlighted.

  5. Select "Save" to save the updates to your landing page.