Maintenance Notification: WSB Wiki will be offline April 23rd between 8:00am - 10:00am for planned maintenance

Also known as: logos, hiring company logos, companies

Description

A block that displays multiple logos in a single row or up to 3 stacked rows. 4-6 logos can fit in each row and we can add a swiper to display up to 20 logos total.


Design

With a swiper

Source: BBA Careers

Use When

  • Displaying logos for corporate sponsors/partners or for hiring companies
  • Displaying 4+ small images without taking up much space

Editorial Guidelines

Follow our general Web Copy General Guidelines for headings, introductory copy, and buttons.

Logo limits

  • For the stacked layout (multiple rows), the limit is 12-16 logos or 3 rows
  • For the swiper layout, the limit is 20 logos

Design Assets Needed

Images - logos

  • Make sure to source a high-quality, png version of each logo.
    • We have many company logos in our WP media library already, so check with a web developer before you source all the logos for a project.
  • Crop out any whitespace around the logo. We will space the logos out on the page using code.
  • Dimensions: 512px wide, heights will vary (smaller logos can work if needed)
  • png file

Implementation

ACF Fields

Introduction/Header, Footer, and Column Structure 

Our standard fields for custom blocks.

Images (Repeater)

Add images for the block here. You can select multiple images from the media library at once to speed things up.

Limits:

  • Stacked layout - 3 rows, or 12-16 logos
  • Swiper layout - 20 logos
  • While the block can technically handle more logos, we want to limit them to prevent issues with swiper arrows on mobile and avoid cognitive overload for users. Logos lose their impact as you increase the number and they can create an overly busy look for the page.

Image recommendations:

  • Images are automatically optimized on this component, so oversized images are totally okay!
    • You'll just want to make sure the image is large enough that it won't appear blurry. Logos files are typically 512px wide.
  • Logos should be PNGs with transparent backgrounds.
  • If a logo is appearing much smaller than others next to it, try cropping out whitespace in the logo image file.
  • Ideally, all the images will have the same ratio height and width, especially if they don't have a transparent background.

Built in:

  • Images are vertically and horizontally centered. 
  • Image optimization that calculates approximate image size based on columns and screen size, then passes that info to "sizes" attribute to tell the browser, so oversized images won't cause issues.
  • Swiper version lazy loads images on hidden slides

Configuration

Maximum Image Height

A number, in pixels, that limits the height of all images. Most useful for when you have a square logo and it's way bigger than the other images.

Recommended default: 90

Top/Bottom Padding

Adds a py- value to each image. Recommended default: 4

Left/Right Padding

Adds a px- value to each image. Recommended default: 4

Swiper

When checked, puts the images in a swiper. 

Randomize Order

When checked, shuffles the order of the images on load. Most useful when you're using a swiper and don't want to show favoritism to the first few images. 

Randomize After

This field only appears if Randomize Order is checked. Prevents the first X images from randomizing, in case you want to feature the first few images but want the rest random.

Anchor ID

Sets id of the block.



  • No labels