Godrej Design Lab

Populating Content

The content for posts and pages goes into these 3 fields:

  • Header region
  • Main region
  • Side region
The content region fields/buckets — Header, Main and Side

Content on a page is broken down into sections.
And sections comprise of blocks (also referred to as components within Strapi).

Let's go over the various content blocks that with which you can use to build a page.

When you click on the "Add a component to Header/Main/Side region" (pill-shaped) button inside of a region field, you are presented with just one option—a section block.


Section block

A section block comprises of a heading and content. Its fields include:

  • Title
  • Show on "Table of Contents"
  • Heading
  • Collapsible
  • Collapsed by default?
  • Content

Title

This field does two things:

  • Sets the name for the section on the Table of Contents section of the page (on the frontend)
  • Makes the section identifiable (on the Strapi edit screen)
Table of Contents
Sections when collapsed can be identified by the title provided

Show on "Table of Contents"

This determines if the section will be listed on the page's table of contents.

Collapsible

This determines if the section can be collapsed.

The Collapsed by default? field determines if the section is already collapsed to begin with, on accessing the page.

Collapsible sections (the +/- symbols are the toggles)

Content

This field is expanded on clicking the "Add a component to Section" (pill-shaped) button.

All the content blocks

There are a dozen blocks to choose from, organized by category:

CategoryFields
Text
  • Heading
  • WYSIWYG
Media
  • Image
  • Gallery
Navigation
  • Button Link
  • Image Link
GDL
  • Heading + Content (list)
  • Image + Content
  • Image + Content (list)
  • Promo
  • Post Listing
  • Fellowship

Heading block

Headings introduce new sections and organize content to help users understand the structure of a page.

Examples of heading blocks
Another example of a heading block

Heading block on Strapi
Field
LevelDetermines how big the heading is
Font FamilyYou can choose between two fonts — sans-serif and monospace
Line 1
Line 2
Headings on the GDL site can be set on two distinct lines.
Line 1 is rendered in the primary color, while Line 2 in the secondary color.
LinkThis will add a button link that is placed to the right of the heading

WYSIWYG block

This has a close resemblance to what you'd see when working with Microsoft Word or Google Docs, albeit a limited sub-set of those.

Examples of WYSIWYG blocks

WYSIWYG block on Strapi

Formatting options on the WYSIWYG block
Field
LayoutDetermines if the content should the span the entire width of the content area (full-width) or just a narrow column (normal)
ContentA wide variety of content can be expressed here — regular text, headings, lists, images and quotes

To format sub-sets of text in monospace, the inline code </> formatting option can be leveraged.

Quotes

To add a quote, simply select the Quote formatting option (pictured above).

Images

The WYSIWYG block supports adding images. However, you do not get to control its aspect ratio. For that, there is a dedicated image block (covered next).


Image block

This one's for inserting an image.

Example of an image block

Image block on Strapi

Field
Image FileTakes you to the media library where you can upload an image or select among previously uploaded ones
Aspect RatioYou can choose either of the following:
  • natural: Image renders in its original aspect ratio
  • 1:1 (square): Image will render as a square; will be cropped if necessary

Media Library

This is a place where you can organize your media files. It is similar to using Finder (on MacOS) and Explorer (on Windows). You can:

  • Upload images
  • Edit image meta-data
  • Create folder structures and organize images in them
  • Delete images

Captions

To add an caption, click the edit icon (a pencil) on the image tile. Then add the caption under the "Caption" field.

Image tile on the post/page edit screen; clicking the pencil allows you to edit the caption
Image tile on the media library; clicking the pencil allows you to edit the caption

Gallery block

This is for displaying panels of images.

An example of a gallery block
Gallery block on Strapi

The block is comprised of rows, each of which are comprised of images. A row can have either 1, 2 or 3 images.

Using the gallery first involves adding rows, then images to the rows. Rows come in 3 versions:

  • 1-image set: for rows with just 1 image
  • 2-image set: for rows with 2 images
  • 3-image set: for rows with 3 images

A gallery can have multiple rows, each with a different number of images. Each row has the following fields:

Field
LayoutDetermines the relative widths of the images in the row (whether the images should be equal in width, or one image should be wider than the other)
ImagesTakes you to the media library where you can upload images or select from previously uploaded ones

Button link block

Adds a button-shaped link.

An example of a button link
Button link block on Strapi
Field
LabelThe text that the button will have
URLThe link that the button will navigate the user to

Image link block

Similar to the button link block. However, here the link wraps over an image instead of a button.

An example of a image link
Image link block on Strapi
Field

Image

Contains the following sub-fields:

  • Image file
  • Aspect Ratio

These are identical to what you find on the image block.

LinkThe link that the button will navigate the user to

Heading + Content block

A 2-column block — the left column holds the heading, while the right column holds the content.

An example of a heading + content block
Heading + Content block on Strapi
Field
HeadingText that describes the content to the right
ContentA wide variety of content can be expressed here — regular text, headings, lists, images and quotes

Image + Content block

A 2-column block, with an image on one column and content on the other.

Comes in two variants — a single instance variant and a list variant

An example of an image + content block
Image + Content block on Strapi
Field

Image

Contains the following sub-fields:

  • Image file
  • Aspect Ratio

These are identical to what you find on the image block.

ContentA wide variety of content can be expressed here — regular text, headings, lists, images and quotes
Layout(only on the list variant)
Determines whether to place the image on the left or the right column. The content will go to the column opposite the image.

Promo block

Used to promote (or cross-promote) a piece of content.
It can be the first thing users see at the top of the page, or it can serve as a (promotional) interruption from the main content.

An example of the promo block
Promo block on Strapi
Field
Heading
ImageThis will go to the background
Content
LinkA button link
(identical to the button link block)

Post Listing block

A list of tiles, where each tile represents a post (but it can represent anything really).

An example of the post listing block
Post listing block on Strapi
Field
LayoutPosts can be laid out in either 2 or 3 columns
Feature First PostIf toggled, the first post will span the entire width of the main content area
ContentA list of posts
├── ImageThe image that represents the post
├── Hover EffectAn animation that plays when the post tile is hovered over. There are 4 effects — dog-ears, cylinder, octagon, hourglass
├── Open in New TabWhether to open the link in a new tab or not
├── LinkURL of the post
└── ContentA wide variety of content can be expressed here — regular text, headings, lists, images and quotes

Fellowship block

A table that lists all the projects that are part of a fellowship program.

An example of a fellowship block
Fellowship block on Strapi
Field
NameThis could also just be the year when the fellowship programme took place.
ProjectsContains a list of projects
Project
├── TitleA label to refer to the project within the Strapi form, especially when the project is collapsed
The first and last projects have no titles and hence it's unclear what's in them.
├── CoverAn image showcasing the project or the fellows or both
├── DescriptionAn account of the project
├── FellowsA list of the fellows involved — their name and role/designation
└── LinkFor linking to another post with more information about the fellowship project
(identical to the button link block)