What's the difference between manual and automated lists?
Add staff one by one and reorder them with the up and down arrow buttons. The order you set is the display order.
Always shows staff who have the tags you specify. Set conditions as "Tag" "is equal to" or "is not equal to" a value, and combine multiple conditions with "Match all conditions" or "Match any condition". The list updates automatically whenever staff or lists are saved or deleted. Only published staff are included in automated lists.
How do I create a list?
- Open the staff list overviewOpen "Staff lists" in the left menu. You can see each list's name, whether it is manual or automated, the conditions for automated lists, and the number of staff.
- Select "Create list"Enter a list name.
- Choose the list typeFor a manual list, add staff with "Search staff by name to add". For an automated list, set conditions with "+ Add condition". For automated lists, the screen shows the number and names of matching staff.
- SaveWhen you save, the change is applied everywhere the list is used.
The list detail page shows an "ID", which you can copy with "Copy".
The list that's there from the start
When you install the app, an "All staff" list that includes everyone is created automatically. You can't change this list's name or type, and you can't delete it. When you delete any other list, a confirmation tells you that theme blocks using that list will no longer show anything. The staff list overview doesn't show which blocks use a list, so check in the theme editor before deleting.
How do I show a staff list in the theme editor?
- Open the theme editorChoose the page where you want to show it. You can also open it with "Open theme editor" on the Storefront page.
- Add the staff list blockChoose "Add section" > "Apps", then add "Staff list (home and other pages)".
- Choose the list to showChoose a list in "List to show" in the settings panel.
- Set the heading and other options, then saveThe settings are listed in the table below.
| Setting | Details |
|---|---|
| "List to show" | If none is chosen, "All staff" is shown. |
| "Heading" | If left blank, no heading is shown. |
| "Show filters (location, height)" | Shows menus to filter by location and height. Shown by default. |
| "Image aspect ratio" | Choose portrait (4:5), portrait (3:4) or square (1:1). The default is portrait (4:5). |
| Show a "See more" button | Hidden by default. You can also set the button label and link. If no link is set, the button goes to the "Staff" page. |
Each card shows the photo, name, height and weight, and location name. Selecting "Details" opens that staff member's detail page. Staff appear in the list's order. Change the number of columns and which fields are shown in the app's Design settings.
How do I adjust the look with the Design settings?
"Design" in the left menu applies to every app block in your theme.
| Item | Details |
|---|---|
| Styling | Text color and background color of the "Details" button. If left blank, your theme's settings are used. |
| Layout | Corner radius for card borders, images, and buttons and badges; font size for the staff list page heading and the "Details" button; and the number of columns. Columns are set separately for the staff list, the snap gallery on staff detail pages, and staff snaps on product pages, for desktop (2 to 5 columns, default 4) and mobile (1 to 3 columns, default 2). |
| "Fields to display" | Turn name, height, weight and location name on or off. |
| "Custom CSS (Pro)" | Available on the Pro plan. Up to 20,000 characters. |
After you set it up
You only need to place blocks in the theme editor once. When you change who is in a list, the change appears on every page that uses that list. You can use the same list on multiple pages, so you don't need to edit your theme when staff join or leave.