A custom grid holds items you add yourself, one by one: a gallery of chosen images, a list of videos, a set of logos with links. Its items live in the grid, not in posts, so they do not change when your posts do. A grid that fills itself from your posts is described in Posts, pages and custom post types.
Start a custom grid
On the grid editor’s Content page, choose Custom items under Source. Add Items appears below it, and the preview shows the items with a toolbar each.
| Add | What you get |
|---|---|
| Image(s) | One item per image you choose in the media library. |
| You Tube, Vimeo, Self Hosted Media, Sound Cloud | An item that plays a video or a track (Video in grids). |
| Simple Content | An item of text, without media. |
| Blank Item | An empty item that keeps a place free in the layout. |
Add images from the media library
- Click Image(s) under Add Items. The dialog Add Images to Grid opens.
- Under Add Filter(s), choose the filters the new items belong to, or add one with New Filter.
- Click Add Bulk Images. In WordPress’s media dialog, upload new images or pick them on the Media Library tab; Ctrl-click (Cmd-click on a Mac) picks several.
- Click Choose Images. Each image becomes an item, with the texts the image has in the media library.
Add Single Image opens the item’s dialog for one image instead.
Edit an item
The toolbar of an item in the preview moves it, edits it, duplicates it or deletes it. Editing opens the item’s dialog: a rail on the left with Media, Media Settings, Item Settings, Skin, Item Data and Custom Meta, and the settings on the right.
| Tab | What it holds |
|---|---|
| Media | The item’s image (Main Image, Choose Image), or its video or track and its Video Ratio. |
| Media Settings | How the image fits its place: Image Fit, Image Repeat, Horizontal Align, Vertical Align. |
| Item Settings | Link To, and the item’s Filter(s): the categories it belongs to, which become the grid’s filter buttons (Add New Filter). |
| Skin | An Alternate Item Skin for this item only (Items) and rules that change its look. |
| Item Data | The texts and fields the skin shows: title, excerpt, content and more. |
| Custom Meta | The item’s values of your custom fields. |
Item Data lists the fields that have a value and the fields the item’s skin shows. Find a field finds any other field by its name; Add field brings an empty one in.
Close the dialog with Update & Refresh Grid, which shows the change in the preview at once, or Update without Refresh, which is quicker with many items. Then save the grid.
Good to know
- The filter buttons of a custom grid come from the items’ Filter(s). Place a filter control on the Navigation page to show them (Filters, sorting and search).
- Blank items can be left out on small screens: Hide blank items below in Layout › Spacing and background (Layouts).
- A custom grid shows all its items in the editor’s preview.