Search
Accordion (accordion)

Questions or headings that each open to show an answer, for FAQs and other detail most readers can skip.

Use it

  • For frequently asked questions, where each reader wants one or two answers out of many.
  • To keep supporting detail on the page without making everyone scroll past it.
  • Side by side when the introduction is short and should stay next to the questions; add an image to the introduction to show it beside them.
  • With groups when there are enough questions to sort into topics, and with the search box once there are more than about ten.

Not for

  • For copy every reader needs. Leave it open on the page with Words or Headed Text.
  • For a few parallel sections of similar weight that readers switch between. Use Tabs.
  • For a single question. Use Headed Text.

A heading for this group of questions

An optional sentence introducing the questions below.

A first question or heading

The answer goes here. Give the short answer first, then any detail the reader needs. A list, a table or a button can follow.

A second question or heading

The answer goes here. Give the short answer first, then any detail the reader needs. A list, a table or a button can follow.

A third question or heading

The answer goes here. Give the short answer first, then any detail the reader needs. A list, a table or a button can follow.

Age Gate (age-gate)

A prompt that covers the screen until the visitor answers a question, typically that they are over a legal age, with Yes remembered by their browser and No leading away or to a message.

Use it

  • On a site whose content is meant for adults, to ask each visitor to confirm their age before they use it.
  • For any other one-off confirmation a visitor must give before using a site, such as being a professional in a regulated field.
  • Once, in a part of the site that is on every page, such as the header template part. Put it as near the top of the page as it will go: the gate opens when the browser reaches it, so the earlier it comes, the less chance there is of the page showing first.

Not for

  • To keep anyone out. This is a courtesy prompt, not access control: the whole page is in the page source behind the gate, search engines and link previews read it, and a visitor with scripting switched off is never asked. Content that must be restricted needs a login or a members area.
  • To check an age. It asks the visitor to say Yes or No and takes their word for it. A date of birth check or proof of age is a different job.
  • For cookie consent. Use the site's consent tool.
  • For a notice that does not need an answer. Use Alert.
  • For an offer or a newsletter prompt. Use Call To Action or Sign-up Prompt.
  • More than once on a page. Only the first gate on a page is used; any other stays closed and is never shown.

This block covers the whole screen until it is answered, so it is shown on its own page. Follow the link in its name above.

Alert (alert)

A short notice in an information, success or warning tone, as a panel within the page or a full-width band.

Use it

  • To flag something the reader should not miss, such as a deadline, a change or a condition.
  • Sparingly, and with the kind of notice stated in the words, because the tone is shown only by colour and a marker.
  • As a band for the one notice that should run across the top of a page; as a panel inside a run of content.

Not for

  • To prompt an action with a button. Use Call To Action.
  • For ordinary copy that needs no emphasis. Use Words or Headed Text.
  • For a message that should appear on every page. That belongs in the site header, not in page content.

A short heading for this notice

One or two sentences that tell the reader what they need to know or do.

Announcement Ticker (announcement-ticker)

A slim strip of short messages, such as offers, dates or new arrivals, that moves across the full width of the page in one line.

Use it

  • For a few short messages that are worth a glance but are not essential, such as an offer, a delivery cut-off or a new range.
  • At the top of a page or between two sections, where a full-width strip reads as a break.
  • With messages of a few words each. Give a message a link when there is a page that says more.
  • It moves on its own, so it has a pause button, and it stops while the pointer is over the messages or a link in it has keyboard focus. Visitors who ask for reduced motion see every message in a still, wrapping row.

Not for

  • For something the reader must not miss, such as a closure or a deadline. Moving text is easy to miss. Use Alert.
  • For a message with a heading, a sentence and a button. Use Call To Action.
  • For a moving row of logos. Use Logos with the scrolling strip layout.
  • More than once on a page. Two moving strips compete with each other and with the content.
A short message about an offer
A second message, such as a new arrival
A third message, such as a delivery date
App Promo (app-promo)

Promotes a mobile app with a screenshot in a phone frame beside a heading, a short text, an optional list of features and buttons to the app stores.

Use it

  • To tell visitors there is an app and send them to the store to install it.
  • On a page about a service that the app makes easier to use, after the service has been explained.
  • In a run with Image With Text blocks, flipping the screenshot side so the sides alternate.

Not for

  • For an image beside text that is not about an app. Use Image With Text.
  • For a closing prompt with ordinary buttons and no screenshot. Use Call To Action.
  • For a landscape screenshot or a video of the app. Use Media.
  • For several features that each need their own picture. Use Card Grid.
Placeholder landscape

A heading that names the app

One or two sentences on what the app lets people do and why it is worth installing.

  • A first feature, in a few words
  • A second feature, in a few words
  • A third feature, in a few words
Article Header (article-header)

The top of an article or case study, showing the title, author, date, categories and tags of the post being viewed, with an optional standfirst and links to share it.

Use it

  • At the top of the template for posts, case studies or any other dated or authored content, so every item opens the same way.
  • Once per page. It prints the post title as the page's level 1 heading.
  • With the split layout when the standfirst is a paragraph or more and should sit beside the title on wide screens, as in a case study introduction.

Not for

  • On ordinary pages with a typed heading and an image. Use Banner.
  • For the trail back to the listing page. Use Breadcrumbs, above this block.
  • To list other posts under the article. Use Featured Posts.

All blocks

A standfirst: one or two sentences that sum up the article and give the reader a reason to carry on.

Audience Content (audience-content)

Content shown to one audience of visitors and hidden from the others, chosen in the browser so every visitor is sent the same page.

Use it

  • To give visitors who arrive from a campaign a message written for them, in place of the general one.
  • In sets: one block for each audience and one set to "Everyone else", placed one after another. Each visitor sees exactly one of them.
  • For a short message, an offer or a call to action. Keep the page the same in every other respect.

Not for

  • For anything private or restricted. Every audience's content is in the page that is sent to every visitor; it is hidden, not withheld. Use a members area or a login.
  • For content search engines must index for one audience only. They read the "Everyone else" version.
  • To show or hide content by device or screen size. That is a matter for the stylesheet.

A headline for everyone else

This message is shown only to the audience you choose in the block’s settings.

Call To Action (call-to-action)

A closing prompt with a heading, a sentence or two and one or two buttons, with an optional image beside them.

Use it

  • At the end of a page or a section, to offer the one action the reader should take next.
  • Panel within a run of content; banner when the prompt should close the page with more weight.
  • Inline for a short prompt, where the heading and the button fit on one line on wide screens.
  • With an image when the prompt needs a picture to carry it. Alternate the image position when two prompts follow each other.

Not for

  • As the first block on a page. Use Banner.
  • For a section of copy that happens to end in a button. Use Headed Text.
  • To flag information the reader must not miss. Use Alert.
  • For a full section of copy next to an image. Use Image With Text.
Placeholder landscape

A heading that invites the next step

One or two sentences that say what happens when the reader takes this step.

Card Grid (card-grid)

Two to four cards side by side, each with a heading, text and optional image or icon and link, with an optional button beneath.

Use it

  • To offer a set of parallel choices, such as services, products or sections of the site.
  • When each item needs a sentence or two and usually a link.
  • Link the whole card when the card is the choice; keep the button when the card needs a named action.
  • Icon images when each card has a small icon rather than a photograph and still needs a link.
  • Beside layout when a short introduction should sit next to the cards rather than above them.
  • With a footer button when the cards are a selection and the full list lives elsewhere.

Not for

  • For short points with an icon and no link. Use Icon Grid.
  • For steps that happen in order. Use Steps.
  • For posts or news, which should come from the content itself. Use Featured Posts or Post Listing.
  • For a single item. Use Image With Text.

A heading for this group of cards

An optional sentence introducing the cards below.

Card heading

A sentence or two about this item, written so it makes sense on its own.

Card heading

A sentence or two about this item, written so it makes sense on its own.

Card heading

A sentence or two about this item, written so it makes sense on its own.

Comparison List (comparison-list)

Two headed lists side by side that set one thing against another, such as what is included and what is not.

Use it

  • To show what something includes and what it does not, so the reader sees the limits as clearly as the offer.
  • For any two-way split of short points: do and do not, suitable for and not suitable for, before and after.
  • With ticks and crosses when the second list is the negative one, and with dots when neither list is.
  • When the two lists are uneven. Each list is as long as it needs to be; the points do not have to pair up.

Not for

  • To compare three or more options, or to compare options point by point across the same attributes. Use Table, with row headings.
  • When each point needs a heading and a sentence of its own, or its own icon. Use Icon Grid.
  • When each item is a choice with a link. Use Card Grid.
  • For a single list. Use a list inside Words.
  • For more than two lists. The crosses are given to every list after the first, so a third list would read as a second negative.

A heading for this comparison

An optional sentence saying what the two lists below set against each other.

What is included

  • A first thing that is included, in a few words
  • A second thing that is included
  • A third thing that is included

What is not included

  • A first thing that is not included, in a few words
  • A second thing that is not included
  • A third thing that is not included
Contact Details (contact-details)

A short introduction beside a list of ways to get in touch, such as phone, email and address, each with an optional icon.

Use it

  • On a contact page, or at the foot of a page where getting in touch is the next step.
  • When there are two or more ways to make contact, each with a short label.
  • For opening hours: add a method labelled Opening hours and list the days.
  • On a page about one office, branch or shop, switch on the search engine option so the address and phone number are published as LocalBusiness structured data.

Not for

  • To collect a message from the visitor. Use a form block.
  • For one button that leads to the contact page. Use Banner or Headed Text.
  • For general copy with a heading. Use Headed Text.

A heading that invites people to get in touch

A sentence or two saying who will answer and how quickly to expect a reply.

Phone

The number, address or other details for this method.

Email

The number, address or other details for this method.

Address

The number, address or other details for this method.

Desktop Menu (desktop-menu)

The main menu as a horizontal row of links for wide screens, with sub-menus that open as drop-down lists or as one wide panel with columns.

Use it

  • Once, in the desktop-menu template part, which Site Header renders beside the logo.
  • With a menu of up to about seven top-level items, so that the row fits on one line.
  • With drop-down lists when each item has a few links beneath it.
  • With the panel with columns when the menu is large: each second-level item heads a column and its own links are listed beneath it.
  • Twice in the same template part when the header has a main menu and a smaller one: set the smaller one to quiet.

Not for

  • On small screens. It is hidden below 56rem. Use Mobile Menu, which Site Header opens from its menu button.
  • For groups of links at the foot of the page. Use Site Footer.
  • Inside page content. It can only be inserted in the site editor.
  • With the panel with columns outside Site Header. The panel takes its width from the header.
Downloads (downloads)

An optional introduction followed by a list of files to download or links to open, one per row, each showing its type and size.

Use it

  • To offer documents such as guides, forms or reports for download.
  • When there are two or more files that belong together.
  • When some of the items are kept elsewhere: set a row to Link and it opens the address instead of downloading a file.
  • Beside layout when the introduction is short and the list is long, so the two sit next to each other on wide screens.

Not for

  • For a single file mentioned in passing. Link to it from the copy in Words.
  • For links to other pages of the site. Use Card Grid.
  • For images or video to look at on the page. Use Media.

A heading for this group of files

An optional sentence saying what the files are and who they are for.

Name of the file

A few words saying what the file covers and who it is for.

Download

Name of the file

A few words saying what the file covers and who it is for.

Download

Name of the file

A few words saying what the file covers and who it is for.

Download
Equity Release Calculator (equity-release-calculator)

Estimates how much a homeowner could release from their property, and how the amount owed grows over time.

Use it

  • For a lifetime mortgage where the most that can be borrowed depends on the age of the youngest homeowner.
  • To show how a loan with no repayments grows, alongside an assumed rise in the property's value.
  • Once on a page.

Not for

  • For a mortgage that is repaid monthly. Use Mortgage Calculator.
  • For a personal loan. Use Loan Calculator.
  • For a home reversion plan, or a lifetime mortgage with repayments or drawdown. Neither is calculated.
  • For a quote the visitor can rely on. The calculation runs in the browser and nothing is saved or checked against an application.

Equity release calculator

See how much you could release from your home and how the loan could grow over time.

If there are two of you, use the younger age.

Any existing mortgage is repaid from the amount released.

Leave empty to see the most you could release.

Placeholder wording. Replace it under Equity Release Settings with wording your compliance team has approved. This is an illustration, not a quote or advice. A lifetime mortgage is a loan secured on your home. Interest compounds, so the amount you owe grows over time and will reduce the value of your estate and may affect your entitlement to means-tested benefits. Figures assume the stated interest rate and property growth. Speak to an adviser before making a decision.

Filterable FAQs (filterable-faqs)

Questions and answers kept centrally in the admin area, shown grouped by category with a search box, category filters and a no-results message.

Use it

  • When the same questions are shown in more than one place, or are maintained by someone who does not edit pages: each question is an FAQ in the admin menu, not content typed into the page.
  • When there are enough questions that visitors need to search them or narrow them by category.
  • To show one topic's questions on a page about that topic: limit the block with its Categories or Tags settings.
  • When the questions arrive in a spreadsheet: FAQs has an Import screen that takes a CSV file.

Not for

  • For a handful of questions written for one page. Use Accordion, where the questions are typed into the block.
  • For detail every reader needs. Leave it open on the page with Words or Headed Text.
  • For a few parallel sections readers switch between. Use Tabs.

Frequently asked questions

An optional sentence saying what these questions cover and how to search or filter them.

Getting started

Example question 1 about getting started?

A short, direct answer to the question, in one or two sentences.

Example question 2 about getting started?

A short, direct answer to the question, in one or two sentences.

Example question 3 about getting started?

A short, direct answer to the question, in one or two sentences.

Example question 4 about getting started?

A short, direct answer to the question, in one or two sentences.

Example question 5 about getting started?

A short, direct answer to the question, in one or two sentences.

Example question 6 about getting started?

A short, direct answer to the question, in one or two sentences.

Your account

Example question 1 about your account?

A short, direct answer to the question, in one or two sentences.

Example question 2 about your account?

A short, direct answer to the question, in one or two sentences.

Example question 3 about your account?

A short, direct answer to the question, in one or two sentences.

Flip Cards (flip-cards)

Two to four cards side by side that each show a heading, with an optional image or icon, and turn over to show a short text and an optional link.

Use it

  • For a small set of parallel items where the heading alone tells most readers enough and the detail is for those who want it, such as values, features or common questions with one-line answers.
  • When each back is a sentence or two, with one link at most.
  • With an icon or small image on the front when each item has one.

Not for

  • For content every reader needs. The back is one step away, so anything essential belongs in view. Use Card Grid.
  • When each card is a link to another page. Use Card Grid, which can link the whole card.
  • For short points with an icon and nothing more to reveal. Use Icon Grid.
  • For longer answers, or more than about eight items. Use Accordion.

A heading for this group of cards

An optional sentence introducing the cards below.

Placeholder landscape

Card heading

A sentence or two that the heading on the front leads into, short enough to read at a glance.

Placeholder landscape

Card heading

A sentence or two that the heading on the front leads into, short enough to read at a glance.

Placeholder landscape

Card heading

A sentence or two that the heading on the front leads into, short enough to read at a glance.

Form (form)

A short introduction with a form, with an optional image and panel, whichever form plugin or markup supplies the form.

Use it

  • For a contact, enquiry or sign-up form that needs a heading and a sentence saying what happens next.
  • When the form comes from a shortcode, from custom HTML or from a form plugin's own block.
  • With the introduction above the form in a narrow column, for a short form such as a newsletter sign-up.
  • With an image beside or behind the form, when the form is the main thing on the page and needs more presence.

Not for

  • For a form that filters a list of posts. Use Post Listing Filters.
  • For an address, phone number or email link with no form. Use Contact Details.
  • For a button that leads to a form on another page. Use Call To Action.

A heading that says what this form is for

A sentence or two saying who should fill in the form, what happens next and how long a reply usually takes.

Glossary (glossary)

An A to Z of terms and what they mean, with a row of letters that jumps to each letter's terms and a button that shows them all.

Use it

  • For a page that explains the words a subject uses, where readers arrive looking for one term.
  • With enough terms that an alphabet to jump through is quicker than scrolling. A dozen or more.
  • Once per page, as the main content of that page.

Not for

  • For a handful of terms. Use Headed Text, or Key Facts for a short list of labels and values.
  • For questions and answers. Use Accordion.
  • To explain one term in passing. Explain it in the sentence where it is used.

Accessibility

How well a page can be used by everyone, including people who use a keyboard, a screen reader or enlarged text.

Alt text

A short description of an image, read out by screen readers and shown when the image does not load.

Browser

The program a visitor uses to open web pages.

Cache

A stored copy of a page or file, kept so that it can be shown again without being built or downloaded a second time.

Domain name

The address people type to reach a site.

Headed Text (headed-text)

A section heading with a few paragraphs of supporting copy, and optionally a list or button.

Use it

  • To open a section of a page or make one point in a few short paragraphs.
  • Side by side when the heading is short; stacked for a narrower reading column.
  • Flipped, to alternate with the block above when several follow one another.
  • With a background image, to give one section of a long page more weight than the rest.

Not for

  • For long-form copy with several headings. Use Words.
  • When an image belongs beside the copy, not behind it. Use Image With Text.
  • For the first block on a page. Use Banner.

A heading that names this section

A short paragraph that explains the point of this section in plain words. Keep it to what the reader needs to know before they move on.

A second paragraph can add detail, and a list or a button can follow it.

Icon Grid (icon-grid)

Two to five short points side by side, each with a small image or icon, a heading and a sentence, under or beside an optional introduction.

Use it

  • To list features, benefits or values that each need only a heading and a sentence.
  • When a small icon helps the reader tell the points apart at a glance.
  • With the introduction beside the items when the section has a real opening statement and four or six points to support it.
  • With highlighted items when the points are the main content of the section, not a supporting list.

Not for

  • When each item needs a larger image or is mainly a link. Use Card Grid.
  • For numbers. Use Stats.
  • When the order of the points matters. Use Steps.

A heading for this group of points

An optional sentence introducing the points below.

Placeholder landscape

Point heading

A sentence that explains this point in plain words.

Placeholder landscape

Point heading

A sentence that explains this point in plain words.

Placeholder landscape

Point heading

A sentence that explains this point in plain words.

Image With Text (image-with-text)

An image, a pair of images or a video beside a heading, copy and an optional button, for one idea.

Use it

  • To make one point that an image or a short video helps explain.
  • In a run of two or three, flipping the image side each time.
  • For a few short related points beside one image: add an item for each point.
  • For a long passage of text beside one image, with the image kept in view.

Not for

  • For several parallel items that each need their own image. Use Card Grid.
  • When there is no meaningful image. Use Headed Text.
  • For a video that is the point of the section, shown at full width. Use Media.
Placeholder landscape

A heading for this point

A short paragraph that the image supports. Say what it is, why it matters to the reader and what they can do next.

Key Facts (key-facts)

A short list of labelled facts about what the page describes, each a label with its value, under an optional heading.

Use it

  • For the details a reader scans for before reading on: the date, place and cost of an event, the salary, hours and location of a job, the year and category of an award.
  • With three to eight facts. Keep each label to a word or two.
  • With the label beside the value when values run to a sentence or more, or when the facts should read as a table of two columns.
  • With one fact set to full width when its value is much longer than the rest, such as an address.

Not for

  • For figures that make a claim, shown large. Use Stats.
  • For points made in a heading and a paragraph each. Use Icon Grid or Card Grid.
  • For data with more than two columns. Use Table.
  • For steps that happen in order. Use Steps.

Key facts

Date

The day and time it takes place.

Location

Where it happens, or how to join online.

Cost

What it costs, or that it is free.

Key Figure (key-figure)

One headline figure, such as a charge, a rate or a price, with what it means and a link to the detail.

Use it

  • For the one number a reader is looking for on a page about cost or terms: a charge, an interest rate, a price, a minimum amount.
  • When the figure needs a link to the page that explains it in full, such as a page of charges.
  • With a note when the figure carries a condition, such as a minimum fee or the date it applies from.
  • Panel when the figure should stand apart from the copy around it; plain when it sits in a row with others.
  • For two or three figures side by side, put a Key Figure in each column of a core Columns block. Give them the same style, and a note on all or none, so the row lines up.

Not for

  • For several figures that back up a claim and need no links. Use Stats.
  • For details with values in words, such as a date, a place and a cost. Use Key Facts.
  • For a prompt with a button and no figure. Use Call To Action.
  • For a full schedule of charges or prices. Use Table.
  • For a figure worked out from what the visitor types in. Use one of the calculator blocks.

0.75% Yearly charge

A minimum charge applies.

An optional sentence of context: what the figure covers, or how it is worked out.

See all the charges

Loan Calculator (loan-calculator)

Works out the monthly payment, total repayable, rate and interest for a loan amount and term the visitor enters.

Use it

  • For a fixed-rate personal loan where the rate depends on the amount borrowed.
  • When the figures are an estimate that leads to an enquiry or an application. A button link can carry the amount and term to the next page.

Not for

  • For a mortgage, where the products depend on loan-to-value. Use Mortgage Calculator.
  • For a lifetime mortgage or other equity release. Use Equity Release Calculator.
  • For a table of rates with nothing to calculate. Use Table.
  • For a quote the visitor can rely on. The calculation runs in the browser and nothing is saved or checked against an application.

Loan Calculator

Calculate your monthly loan repayments based on the loan amount, interest rate, and repayment term.

Loan term (years)

Loan amount

Monthly payment

£

Total repayable

£

APR

%

Total interest

£

First time with us?

Already a customer?

Placeholder disclaimer: replace this with wording your compliance team has approved, including any representative example you are required to show. This calculator provides an estimate based on the information you provide. Actual loan terms, interest rates and repayment amounts may vary.

Locations (locations)

A card for each office or branch with its address, telephone number, email address and an optional map, in a grid or a sliding row.

Use it

  • To list the places an organisation works from, each with the details needed to visit or contact it.
  • Grid for up to three or four locations, so all of them are seen at once.
  • Slider for more locations than fit in a row: visitors move through them with the buttons, the "choose location" menu or by swiping.
  • With a map on a location when visitors travel to it. Leave the map off for postal addresses.

Not for

  • For one set of contact details for the whole organisation. Use Contact Details.
  • For the people at each location. Use Team.
  • For a long list of stockists or dealers that visitors search by place. This block has no search; that needs a list kept as its own content type.

A heading for these locations

An optional sentence saying who to contact at each location, or when they are open.

Logos (logos)

An optional heading and sentence above a set of logos, such as customers, partners or accreditations, shown as a row, a grid or a scrolling strip.

Use it

  • To show who the organisation works with, is accredited by or is a member of.
  • Row for four to eight logos, so they read as one group.
  • Grid for a longer list where every logo should be seen and line up.
  • Scrolling strip for a long list that should take up one line. It moves on its own, pauses on hover, focus or its pause button, and stays still for visitors who ask for reduced motion.
  • Link a logo to the organisation with the image block's own link control.

Not for

  • When each organisation needs a sentence or a link to more. Use Card Grid.
  • For what a customer said. Use Testimonial or Testimonials Slider.
  • For photographs. Use Media.

A heading that says what these organisations have in common

Placeholder landscape
Placeholder landscape
Placeholder landscape
Placeholder landscape
Media (media)

One large image or video, two side by side, a grid of images or a row to scroll through, each with an optional caption and link.

Use it

  • To give an image or a video the full width of the content between sections of copy.
  • Pair for two images that belong together, such as before and after.
  • Grid for four or more images of equal weight, such as a small gallery. Link each image with the image block's own link control.
  • Carousel when there are more images than the page has room for and none matters more than the rest.
  • Full width for a photograph or video that should run from edge to edge as a break in the page.
  • Parallax on a single wide photograph, for a gentle sense of depth as the page scrolls.
  • Video: add a core Video block for a file from the media library, or an Embed block for a hosted video.

Not for

  • When the image sits beside copy. Use Image With Text.
  • For the image behind a page's opening headline. Use Banner.
  • For a row of logos. Use Logos.
  • For files to download. Use Downloads.
Placeholder landscape
Mobile Menu (mobile-menu)

The main menu for small screens, as a panel of large links with sub-menus that open in place or slide across.

Use it

  • Once, in the mobile-menu template part, which Site Header shows as a panel when its menu button is pressed.
  • With sub-menus that open in place when the menu has one level of sub-menus.
  • With sub-menus that slide across when the menu is deeper: each sub-menu takes the place of the list above it and has a Back button.
  • With a list, a paragraph or buttons under the menu for the links the header only shows on wide screens, such as a phone number or a log in link.

Not for

  • On wide screens. It is hidden from 56rem. Use Desktop Menu.
  • On its own. It relies on Site Header to open and close the panel.
  • Inside page content. It can only be inserted in the site editor.
Mortgage Calculator (mortgage-calculator)

Asks what the visitor wants to do, the property price, the deposit and the term, then lists the mortgage products that fit with a monthly payment for each.

Use it

  • For a lender or broker with a set of mortgage products, each available within a loan-to-value range.
  • When products differ by what the customer is doing (buying a first home, moving, remortgaging).
  • When a short series of screens suits the page. The steps are links in the address bar, so the browser's back button moves between them.

Not for

  • For a loan priced by the amount borrowed. Use Loan Calculator.
  • For a lifetime mortgage or other equity release. Use Equity Release Calculator.
  • To show products with nothing to calculate. Use Card Grid or Table.
  • For interest-only mortgages. Only capital repayment is calculated.
  • For a quote the visitor can rely on. The calculation runs in the browser and nothing is saved or checked against an application.
Next Page (next-page)

A link at the foot of a page to the next page of the same type, worked out from the page being viewed.

Use it

  • At the foot of the template for case studies, articles or any other content that readers go through one after another.
  • At the foot of a set of pages that are read in order, such as the chapters of a guide.
  • Once per page, after the content and above the site footer.

Not for

  • To link to a page chosen by hand. Use Call To Action.
  • To offer several pages to read next. Use Featured Posts.
  • For numbered pages of a listing. Post Listing has its own pagination.
Page Index (page-index)

A short list of jump links to the sections of a long page.

Use it

  • Near the top of a long page with four or more sections, so readers can jump to the one they came for.
  • On guidance, policy and reference pages that people return to.
  • With groups when the index runs past about eight links and the sections fall under a few clear titles.

Not for

  • On a short page. Readers can see all of it without help.
  • To link to other pages. Use Card Grid, or a list inside Words.
  • To show where the page sits in the site. Use Breadcrumbs.
Pop-up (pop-up)

Content that appears over the page as a corner panel, a bar along the top or bottom, or a modal in the centre, opened by a trigger the editor chooses, by a launcher button or by a link, for a newsletter sign-up or one short prompt.

Use it

  • For a newsletter sign-up or one short prompt that should reach the visitor wherever they are on the page. Where the block is placed in the page does not change where it appears; the footer or the end of the content is the usual place, so it is on every page.
  • **A bottom corner** for something that should stay to hand without getting in the way: a sign-up, a short offer. The page stays in use. This is the default.
  • **A bar along the bottom** for one line and a button or a single-field form: a notice with an action, a sign-up after 10 seconds. It covers the foot of the window, which visitors mind least.
  • **A bar along the top** for the same when it must be seen first. It is laid over the top of the page and covers the site header while it is open, so keep it to a line or two.
  • **The centre (modal)** only for the one thing that is worth stopping the visitor for, and with a trigger that waits until they have shown interest or are leaving. It dims the page and nothing else can be used until it is closed.
  • Opening **on arrival, after a delay** for a prompt every visitor should see; half a second for a corner panel, 10 seconds or more for a bar or a modal.
  • Opening **only when asked** when a launcher or a button elsewhere on the page is the invitation.
  • Opening **after scrolling part of the page** or **when a chosen section comes into view** to wait until the visitor is reading. Choose the section when the prompt belongs to a point in the content, such as the end of an article or a price list, which a percentage cannot pin down on pages of different lengths.
  • Opening **when the visitor goes to leave** for a last offer, with a pointer only (see the limit below).
  • Opening **after several pages** to leave first-page visitors alone and ask the ones who stay.
  • Opening **after a period of inactivity** to offer help to a visitor who has stopped.
  • More than one on a page where each has its own job, for example a corner sign-up and a modal on leaving. They take turns and are remembered separately.

Not for

  • For a sign-up that should sit in the page and wait to be pressed. Use Sign-up Prompt.
  • For a contact or enquiry form, or any form with more than a few fields. Use Form.
  • For a notice with nothing to do in it. Use Alert, or Announcement Ticker for a running line.
  • For something the visitor must answer before they may use the site at all, such as an age check. Use Age Gate: this block's modal can always be dismissed.
  • As a modal on arrival with no delay. It interrupts before the visitor has seen anything; use a corner or a bar, or a later trigger.
  • A long form in a bar. A bar is never taller than half the window; use a corner or the centre.

A heading that says what this is

A sentence saying what subscribers receive, how often, and that they can unsubscribe at any time.

Post Listing Filters (post-listing-filters)

A row of filters for a Post Listing, with a keyword field, taxonomy menus or tick lists and a sort menu.

Use it

  • Above a Post Listing, or in a section inside it, so readers can narrow the posts by keyword and by the terms of one or more taxonomies, and choose the order.
  • On another page, with the results set to the posts page, to send readers there with filters already applied.

Not for

  • To search the whole site. Use Search.
  • With a listing that is not a Post Listing. The filters only narrow a Post Listing, or the page's own query on the posts page and on archives.
  • For filters that update the list without loading the page, show result counts or filter by custom fields. Those need a filtering plugin: extend the Post Listing variant for FacetWP that ships with Mosaic Blocks in the site's theme.
Post Listing (post-listing)

A paginated grid or list of posts drawn from a query, each shown as a teaser.

Use it

  • For a news, blog or resources index, where the posts shown should follow the content and not be chosen by hand.
  • On an archive template, with the query set to inherit from the page being viewed.
  • With Post Listing Filters above it, or in a section of its own inside it, when readers need to narrow the posts.

Not for

  • For a few hand-picked posts. Use Featured Posts.
  • For items that are not posts and are typed in by the editor. Use Card Grid.
Progress Indicator (progress-indicator)

Shows which step of a task spread over several pages the visitor is on, such as "Step 2 of 3", with the other steps listed either side.

Use it

  • At the top of each page of a task that runs over several pages, such as an application in three parts, so the visitor can see how far through they are and how much is left.
  • With two to seven steps, each named in two or three words.
  • With typed steps when the steps live anywhere: on pages in different parts of the site, or on another system.
  • With pages beside this one when every step is a page under one parent. One block in the template for those pages, or the same block on each, then stays correct by itself as pages are added, renamed or reordered.

Not for

  • To explain a process on one page, with a heading and a sentence for each step. Use Steps.
  • To show where the page sits in the site. Use Breadcrumbs.
  • For a single link on to the following page. Use Next Page, which can sit at the foot of the same page.
  • To jump between sections of one long page. Use Page Index.
  • To show how much of a form on one page has been filled in. The block knows which page it is on and nothing about what a visitor has done.
Project Card (project-card)

A card summarising one piece of work, such as a completed project or a case study, with an optional logo or photograph, a title, one line of description and up to five labelled facts.

Use it

  • To show a track record: one card for each completed project, deal or case study, with the facts a reader compares, such as sector, value and date.
  • With a logo when the work is best known by who it was for, and with a photograph when there is a picture of the work itself.
  • With the title linked when there is a fuller write-up to read. The whole card then leads there.
  • On its own at full width for the piece of work to feature: a wide card puts the image beside the text and enlarges the title.
  • Several side by side: put one Project Card in each column of a core Columns block, or in a core Group set to Grid. Card Grid holds only its own cards, so a Project Card cannot go inside it.

Not for

  • For a card with a heading, text and a button and no facts. Use Card Grid.
  • For facts about the page itself with no card around them. Use Key Facts.
  • For posts that should be listed from the content itself. Use Featured Posts or Post Listing with Teaser.
  • For figures that make a claim, shown large. Use Stats.
  • For a row of client logos with nothing said about the work. Use Logos.
Resource Card (resource-card)

A card for one resource (a document, an audio recording, a video or a course) showing its type, title, optional description, image and detail, and the action that suits the type.

Use it

  • To offer one document, recording, video or course as a card, with the action a visitor expects: download, play or follow a link.
  • For a small library of mixed resources. The block is one card, so to show several put a Resource Card in each column of a core Columns block, or in a core Grid. Inside either, the card drops its own section spacing and the cards in a row end level. Card Grid takes only its own cards, so a Resource Card cannot go inside it.
  • Audio or video from the media library: choose the file and it is played on the card with the browser's own player. Nothing is fetched or played until the visitor presses play.
  • A video kept on a video site, or a document kept somewhere else: leave the file empty and give the address, and the card links to it.
  • On its own in a wide space: the image or video sits beside the text once the card is wide enough.

Not for

  • For a plain list of files to download, one per row. Use Downloads.
  • For a large video or image to look at on the page, or a video embedded from a video site. Use Media.
  • For cards that lead to other pages of the site. Use Card Grid.
  • For posts, which should come from the content itself. Use Featured Posts or Post Listing.
Reviews Widget (reviews-widget)

A reviews provider's widget, such as a star rating strip, shown from its embed code with an optional heading and text.

Use it

  • To show a live rating or recent reviews collected by a third-party reviews service. It suits any reviews provider that supplies an embed snippet.
  • As a narrow strip between sections: remove the heading and text and keep only the widget.
  • Beside layout when the widget is tall, such as a list of reviews, and a heading and sentence should sit next to it.

Not for

  • For a quote you have been given and can type in. Use Testimonial or Testimonials Slider.
  • For figures you maintain yourself, such as a satisfaction score. Use Stats.
  • For embeds that are not reviews, such as video or maps. Use Media or Locations.

A heading for these reviews

An optional sentence saying who the reviews are from and where they were collected.

Search Results (search-results)

The results of a site search, with the search box repeated above them and links to further pages of results.

Use it

  • In the search results template, as the main content of that page. It shows whatever the site's search found for the address being viewed.
  • Once on that template. Its default heading is the page's level 1 heading.

Not for

  • For a search box on its own, on any other page. Use Search.
  • For a list of posts that is not a search, with or without filters. Use Post Listing.
  • For a few hand-picked or related posts. Use Featured Posts.

Search results

Enter a word or phrase in the search box to see matching pages here.

Sign-up Prompt (sign-up-prompt)

A slim bar with one line of text and a button that opens in place to show a short introduction and a sign-up form, without interrupting the reader.

Use it

  • To offer a newsletter or mailing list sign-up without giving the form space on the page until a visitor asks for it.
  • After an article, between sections of a long page or above a site footer, where a full form would be too heavy.
  • In place of a pop-up or an overlay that appears by itself. The bar waits to be pressed and never covers the page.
  • Starting open, on a page where signing up is the point and most visitors are expected to want the form.

Not for

  • For a contact or enquiry form, or any form with more than a few fields. Use Form.
  • For a form that should always be in view with a heading and an image. Use Form.
  • For a button that leads to a sign-up page elsewhere. Use Call To Action.
  • For a notice with nothing to fill in. Use Alert.
Social Feed (social-feed)

Points visitors to the organisation's social media, with a heading and short introduction, links to its social profiles and a grid of recent posts.

Use it

  • Near the foot of a home or about page, to show that the organisation is active on social media and where to follow it.
  • Chosen posts when a handful of posts should be shown and kept under the editor's control. Nothing is loaded from another service, so the page stays fast and needs no consent for a third party.
  • Embed code when the posts must update on their own. It suits any feed provider that supplies an embed snippet.
  • With no posts at all, as a heading above the profile links.
  • Three in a row for a few large pictures, four for eight posts in two rows, six for one row of small pictures.

Not for

  • At the very top of a page. The pictures load only as the visitor nears them, which is wrong for the first thing on screen. Use Banner or Media.
  • For social links in the footer of every page. Use Site Footer, which holds them the same way.
  • For a gallery of the organisation's own photographs that link nowhere. Use Media.
  • For logos of partners or customers. Use Logos.
  • For a reviews provider's rating or reviews. Use Reviews Widget.
Stats (stats)

Headline figures, each with a short label, in a row or in a column beside an introduction.

Use it

  • To back up a claim with a few numbers the reader can take in at a glance.
  • With three or four figures. Keep each label to a few words.
  • With the introduction beside the figures when a heading and a button should sit next to the numbers that support them.
  • With one featured figure when a single number is the headline and the rest support it.

Not for

  • For points made in words. Use Icon Grid.
  • For a full table of data. Use Table.
  • For a single figure inside a paragraph. Use Words.

A heading for this set of figures

An optional sentence that says what the figures below show.

98%

A short label that says what this figure measures.

1,500

A short label that says what this figure measures.

24

A short label that says what this figure measures.

Steps (steps)

A numbered sequence of steps, each with a heading and a sentence or two, down the page or side by side.

Use it

  • To explain a process the reader follows in order, such as how to apply or what happens after an enquiry.
  • With three to six steps. The numbers are added automatically and follow the order of the steps.
  • In columns for three or four short steps that read across the page; as a list when the steps carry more text.

Not for

  • When the order does not matter. Use Icon Grid.
  • For events tied to dates. Use Timeline.
  • For a plain numbered list inside longer copy. Use Words.

A heading for this sequence of steps

An optional sentence that says what the steps below lead to.

Step heading

A sentence or two that says what happens at this step.

Step heading

A sentence or two that says what happens at this step.

Step heading

A sentence or two that says what happens at this step.

Table (table)

Figures or facts in rows and columns, with an optional heading and introduction.

Use it

  • To compare several items across the same few attributes, such as prices, sizes or dates.
  • When readers will look up one row or read down one column.
  • With row headings when each row is about one item named in its first cell, as in a comparison of plans or products.

Not for

  • To lay out a page in columns. Use Card Grid or Image With Text.
  • For a list with one attribute per item. Use a list inside Words.
  • For questions and answers. Use Accordion.

A heading for this table

An optional sentence saying what the table shows and how to read it.

Column heading

Column heading

Column heading

First item

A value

A short note

Second item

A value

A short note

Third item

A value

A short note

Tabs (tabs)

A row of labelled tabs that each show one synced pattern, so readers switch between parallel sections.

Use it

  • For two to five parallel sections of similar weight, where a reader wants one at a time.
  • When each section is already built, or worth building, as a synced pattern.

Not for

  • For questions and answers, or detail most readers skip. Use Accordion.
  • For content every reader should see. Stack the sections on the page instead.
  • For more tabs than fit a phone screen comfortably. Use Page Index with headed sections.

The content of the first tab. It comes from a synced pattern chosen on the tab.

Team (team)

A grid or scrolling row of people, each with an optional photo, a name, a role, contact links and a biography.

Use it

  • To introduce the people behind a service, a department or an organisation.
  • When each person needs a name, a role and a sentence or two, with a phone number, email address or LinkedIn profile where readers should contact them directly.
  • With biographies in a pop-up, when each person has more to say than fits under a photo.
  • As a slider, for a long list of people in a short space.

Not for

  • For what one person said about the organisation. Use Testimonial.
  • For addresses, phone numbers and opening hours of the organisation. Use Contact Details.
  • For items that are not people. Use Card Grid.
  • For people who are held as posts of their own. Use Post Listing or Featured Posts with a Teaser set to a square or portrait image.

A heading for this group of people

An optional sentence introducing the people below.

Placeholder landscape

Name of person

Role or job title

A sentence or two about what this person does and what to contact them about.

Placeholder landscape

Name of person

Role or job title

A sentence or two about what this person does and what to contact them about.

Placeholder landscape

Name of person

Role or job title

A sentence or two about what this person does and what to contact them about.

Teaser (teaser)

A card previewing one post, with its image, title, excerpt and a read-more link, and optionally its date and terms.

Use it

  • Inside the post template of a Post Listing or a query loop, so each post in the loop is shown as a card.
  • Inside a pattern that is rendered once for each post.
  • For people or products as well as articles: choose a square or portrait image shape, or fit the whole image for logos and product shots.

Not for

  • On its own on a page. Outside a loop it previews the page it sits on. Use Featured Posts to show hand-picked posts.
  • For a card whose content is typed in by the editor. Use Card Grid.
Testimonial (testimonial)

One quote from a customer or partner, with their name, role, an optional portrait and an optional star rating.

Use it

  • To back up a claim with one person's words, next to the content it supports.
  • When the quote is short: a sentence or two.
  • Centred layout when the quote is a section of the page in its own right, between other blocks.
  • With a star rating when the words come from a review that gave a score.

Not for

  • For several quotes in one place. Use Testimonials Slider.
  • To show who you work with rather than what they said. Use Logos.

A sentence or two in the person’s own words, saying what changed for them and why it mattered.

Placeholder landscape Name of person Role, Organisation
Testimonials Grid (testimonials-grid)

Several quotes shown together in a grid under an optional heading and introduction, each with a name, a role and an optional portrait, logo or star rating.

Use it

  • When there are three or more quotes and every one should be seen without the visitor doing anything.
  • When the range of people matters as much as any one quote, such as customers from different sectors.
  • Two per row when the quotes run to several sentences; three per row when they are a sentence or two.
  • With portraits, logos or star ratings when the quotes come from named reviewers or organisations.

Not for

  • For one quote. Use Testimonial.
  • When there is room for only one quote at a time. Use Testimonials Slider.
  • To show who you work with rather than what they said. Use Logos.
  • For reviews pulled in from a reviews service. Use Reviews Widget.

A heading for these quotes

An optional sentence saying who the quotes below are from.

A sentence or two in the person’s own words, saying what changed for them and why it mattered.

Placeholder landscape Name of person Role, Organisation

A sentence or two in the person’s own words, saying what changed for them and why it mattered.

Placeholder landscape Name of person Role, Organisation

A sentence or two in the person’s own words, saying what changed for them and why it mattered.

Placeholder landscape Name of person Role, Organisation
Testimonials Slider (testimonials-slider)

Several quotes shown one at a time under an optional heading, moved through by scrolling, swiping or previous and next buttons.

Use it

  • When there are three or more quotes and room for only one.
  • When no single quote matters more than the others, since most visitors see only the first.
  • With portraits or star ratings when the quotes come from named reviewers.

Not for

  • For one quote. Use Testimonial.
  • When every quote should be read. Put several Testimonial blocks on the page instead.
  • For images or general content. This block holds quotes only.

A heading for these quotes

A sentence or two in the person’s own words, saying what changed for them and why it mattered.

Placeholder landscape Name of person Role, Organisation

A sentence or two in the person’s own words, saying what changed for them and why it mattered.

Placeholder landscape Name of person Role, Organisation

A sentence or two in the person’s own words, saying what changed for them and why it mattered.

Placeholder landscape Name of person Role, Organisation
Timeline (timeline)

Dated entries in order, each with a heading, a sentence or two and an optional image: down a line, on alternating sides of it, or one at a time.

Use it

  • To show a history or a schedule where the dates matter as much as the events.
  • With entries in date order, each kept to a heading and a sentence or two.
  • Alternating sides for a short history that should fill the width of the page.
  • Stepped for a long history, so the page shows one entry at a time and the reader moves between dates.

Not for

  • For a process with no dates. Use Steps.
  • For upcoming events that have their own pages. Use Post Listing.
  • For a single date inside a paragraph. Use Words.

A heading for this timeline

An optional sentence that says what period the timeline covers.

2022

Entry heading

A sentence or two about what happened at this point.

2024

Entry heading

A sentence or two about what happened at this point.

2026

Entry heading

A sentence or two about what happened at this point.

Words (words)

A run of explanatory copy with headings, paragraphs and lists.

Use it

  • For articles, policies, guidance and any copy longer than a few paragraphs.
  • When the content is mostly text and needs a comfortable reading width.
  • With an image or a small table where the copy refers to one. They sit in the reading column with the text.
  • Centred on a page that is only copy, such as an article or a policy.

Not for

  • For one short point with a heading. Use Headed Text.
  • For a table that is the point of the section, or one wider than a few columns. Use Table.
  • For an image that should sit beside the copy. Use Image With Text.

A heading for this part of the page

Body copy goes here. Write in short paragraphs, one idea in each, and break up longer passages with headings so the page is easy to scan.

Lists help when there are several parallel points. Keep sentences plain and front-load the words the reader is looking for.