Skip to content

Customise all cards#

How to customise the card interface#

By default, the Card Interface will display cards in rows of three with an Engage button for Navigation cards as shown in Figure 1. However, the Card Interface also allows you to modify how the card interface is displayed. It allows you to display the same collection of Blackboard items in very different ways.

This document introduces you to the current possibilities and how to use them.

Figure 1 - The default "rows of 3" card interface

How to customise – Templates and Attributes#

The Card Interface supports two types of customisation that impact the entire interface.

  • Templates; and,
    Influencing how the cards are organised on the page.
  • Card attributes.
    Influencing card appearance, e.g. what buttons appear and the labels for those buttons.

While they are used in similar ways, they modify different parts of the interface.

The following two sub-sections summarise the two types of customisation. The rest of this document illustrates how to use them and provides examples.

Adding parameters to the Card Interface item’s title

Both types of customisation are used by adding the appropriate parameters to the Name of the Card Interface item. For example Figure 2 shows the Card Interface item being edited, and the Name element having two parameters

  1. engage=Start – An attribute to change the label for the engage button to Start.
  2. template=by4 – A layout parameter that will result in the Card Interface being displayed in rows of 4 cards.

Figure 2 - Adding parameters to the title of the Card Interface item


The organisation of cards into rows of individual cards – 3 to a row – in Figure 1 is the default card layout. The following table summarises the currently available layouts.




Show 4 cards per row. The 4 can be replaced with any whole number from 1 through 6.


Use a special card design – designed specifically for assessment items – to display cards one per row


Show only one card per row. The cards are show vertically with the image displaying to the left hand end of the card.

Note: This template is not currently working well.


It’s also possible to specify certain parameters that will be applied to each card and change attributes of the cards.




Don’t display the engage button

engage=’Some word’

Replace the Engage button label with Some word

markReviewed=’Check Completed’

Change the Mark Reviewed button label to Check Completed. Indicating that the student has yet to mark the card completed/reviewed


Change the Reviewed button label to Completed.


Hide any Card images for all cards.


Hide any card numbers on cards with card labels.

How to arrange cards vertically using template=vertical?#

The vertical customisation of the Card Interface aims to display cards vertically. i.e. one card per row. By adding template=vertical to the name of the Card Interface item the card interface shown in Figure 1 is transformed into Figure 3.

Note: This feature is somewhat unreliable and generally not recommended for use.

Figure 3 - Vertical Card Interface


How to change the number of cards per row using template=b1y[123456]?#

Change how many cards per row. By default 3, to display 5 cards per row (rather than 3), add template=by5 to the name of the Card Interface Blackboard item.

Figure 4 shows a by5 card display based on the same Card Interface shown in Figure 1 and Figure 3.

template=by1 will display 1 card per row. But the Card image will be displayed at the top of the card, rather than to the left-hand side of the Card as done with template=vertical (see Figure 3)