A flexible card-based layout
A Grid section shows multiple blocks of content that each share the same layout, maintaining a consistent style within the section and ensuring that elements align across multiple blocks.
A Grid section is similar to a table in that it contains columns and rows of cells that can each hold content. In a table the height of each cell is defined by its content and the content of other cells in the same row.
The same is true in a Grid section, however the 'columns' are separated into individual 'cards':
A Grid section is like a table split by its columns.
The default Grid section features a heading followed by a row of three cards (or a single column of three cards on tall/portrait screens). Each card contains an image, text, and a button, and those elements are contained within cells whose size and location are matched in each card. The number of cards, their cells, cell content, colours, and other styles can all be changed.
Editing the section
Heading and footer block
The section includes optional blocks for 'header' content above the grid of cards, and 'footer' content below the grid. The default blocks include some placeholder text that reads "Add text here" that won't display in the published story. To display content in either or both of these blocks, click the placeholder text and enter something new. An 'insert' menu that appears as three dots above and below the blocks allows for inserting text, dividers, spacers and buttons above and below other content in the blocks. Options also enable changing the font and alignment text in the box, adjusting its width, etc.
Adding and deleting cards
To add a new card to the section, replicate an existing card. This can be done through a menu at the top of each card with an item labelled 'Duplicate card', or by the green + button to the side of any card:
Methods for adding a new card
Tip: Because adding a new card replicates the content of an existing card, one of the fastest ways to create your Grid content is to make one card just the way you like it, with all the appropriate text styles and content types (buttons, dividers, etc), and to then duplicate that card and change the content as necessary.
To delete a card, use the menu at the top of a card and choose 'Delete card'.
Changing card content
Cards can have multiple cells, each with its own type of content: text, image, video, button, divider, spacer, etc. Each card can also have a background image that fills the full shape of the card, appearing "behind" the content in cells.
To add, change, or delete the background image on a card, use the menu at the top of a card and choose from the options to edit or delete:
Adding, deleting, or replacing a card's background image.
To change existing text in a card, mouse over it to access menus to change its style, font, alignment, etc, or click on the text to type or paste in new text.
To change an existing image or video in a card, mouse over it to access a menu to replace it and/or change its size or style, including giving it animation effects or rounded corners, or to delete it.
The media menu
To add a new type of content into an existing cell, first delete its content (if there is any), then use the three-dot menu at the top of the cell and choose from any of the shown content types to add:
Removing content, and the menu to add new content to a cell.
Adding and deleting rows and cells
On the left side of each cell in a card is a 3-dot menu that enables moving, duplicating, adding, and deleting rows in cards. Performing any of these actions will affect all the cells in the same virtual 'row' across all the cards in the section (eg, the first cell in every card or the third cell in every card). When a new cell is added to a card, a new cell is added to all the cards, and by default the new cell is ready for you to add text, or any other element:
How to add or delete a row of cells. Note that adding the row to one card also adds it to all the cards.
Alternatively, you can add a row by choosing the 3-dot menu below any existing cell and choosing the type of content to add. Doing so will add the same type of content to all the cards in the section. The individual elements can then be styled independently or removed:
Adding a row add the same type of content to all cells in the row, though it can then be styled or replaced.
Moving rows and cards
Click a 3-dot menu to the left of any cell and drag up or down to shift the whole corresponding row up or down in the Grid. Click the 3-dot menu at the top of any card and drag left or right to shift the card's position:
Moving rows up and down, and cards left and right.
Responsive layout and the number of cards per row
The number of cards that fit across a reader's screen depends on their screen size and resolution. While four or five cards might easily fit in a row on a desktop or laptop screen, if they contain text they might be too small to read on a phone if there were still five to a row. By default, the layout is responsive. As more cards are added to the section, if they won't comfortably all fit on one row, they will instead drop to a new row:
Adding more cards. When they hit the maximimum per row, or no longer fit comfortably on a row, they'll form a new row of cards.
The section options panel enables you to change how the responsive layout adjusts the section at different screen sizes. There's two key options:
setting a maximum number of cards per row or
setting an exact number per row at specified screen sizes.
1. Set a maximum per row
Setting a maximum number of cards per row enables you to ensure that, for instance, no more than five cards display in a row, but that if your reader's screen doesn't comfortably fit five cards, it may display less than five per row. Although you have set five as a maximium, the number that a reader of your story sees in a row will still depend on their screen size. As such, it's important to test your story at multiple screen widths to see how the section responds.
Setting maximum per row
2. Set an exact number of cards per row
For a more precise layout, set a defined number of cards per row at different screen sizes. This option allows you to specify, for instance, that on wide desktop screens four cards will display per row, while two display per row on tablet, and only one per row on mobile:
Setting exact numbers per row
The numbers you specify per screen size are up to you. If the cards in the section only contain images or names, then ten per row on desktop might be appropriate and five per row on mobile perfectly readable. An exact number of cards per row is also useful if your content looks neater when divided into rows of an equal number of cards at any screen size, or really only works with a specific number per row at all screen sizes, such as in this example grid where three cards per row is the only option that suits the content:
Non-standard grids
It's possible to make a grid with different numbers of items per row, as per the image below. To do so, create a new Grid section per row. For each of the sections, use the Section Options to adjust the number of items per row and the section's overall top and/or bottom padding such that the sections appear close together.
Three Grid sections made to look like one
Section options
Clicking the cog button in the top-left of the section or next to the section thumbnail in the left of the editor will open the SECTION OPTIONS panel through which the section can be highly customised:
Section options for the Grid section
Options include:
setting the overall content width: 'Full' or 'Wide' to change how close cards will render to the left and right edges of the browser
card layout (including an option for one-card-per-row where the left or right side of the card is reserved for an image)
setting the maximum number of cards displayed per row or exact number per row at various screen sizes.
changing the spacing between/around cards
changing the spacing between the cells inside of each card
changing the card background colour and opacity
adding a coloured overlay to the cards
applying a visible border ot the card and setting its width and colour
rounding the corners of the cards
changing the top and bottom padding of the section as a whole (enabling it to appear closer to the sections above or below)
Section templates
There are a wide range of pre-styled Grid sections to choose from when you add a new section to your story. Look for them among the cetegories in the section chooser.
Some of the Grid templates available when adding a section to a story
If you create a Grid section you think will be useful to re-use in other stories, save it as a personal template (or if you are a team leader, save it as a workspace template to make it available to the rest of your team).
Accessibility
There are no feature-specific accessibility requirements for this section. Please follow our accessibility guidelines to ensure your grids are inclusive for all.
An older Grid section
Shorthand has previously used a different Grid section, wholly replaced by the section described above. If you have a story that used the older Grid section type you can continue to edit it should you need to update an older story. Within the Editor, there is also an option to convert the older Grid section to the new one.


















