Adding and configuring the theme block

The Brand Page theme block is the storefront half of Easy Brand Page. Once it's in place, the admin's job is just to keep the underlying data fresh.

Adding the block

1. In Shopify admin, go to Online Store, then Themes.
2. Click Customize on your active theme.
3. In the theme editor, navigate to the page where you want the directory (Pages section, homepage, etc.).
4. Click Add section (or Add block if you're inside an existing section).
5. Find "Brand page" in the picker - it's grouped under "Apps", next to the app's other blocks: "Brand slider", "Brand link", "Brand header", and "Brand footer".
6. Click to add. The block appears in the theme preview.
7. Click Save.

The directory is now live on the storefront once you've run the first vendor scan in the admin.

Block settings, by group

The Brand Page block has dozens of settings, grouped in the theme editor sidebar.

Featured brands

Controls the optional row at the top of the directory that highlights your favourite vendors.

• Show featured brands section - on/off toggle. The rest of the group's settings appear once it's on.
• Layout preset - restyles the featured cards independently of the main grid: Custom, Classic cards, Image cards, Minimal text, Logo wall, or Compact chips.
• Show container - wraps the featured row in a bordered box.
• Section heading - text above the row (default "Featured Brands"). Leave it empty to remove the heading completely.
• Position - where the row appears in the page flow: before heading and search, below heading, or below the main A-Z list.
• Show featured brand images - show an image on each featured card: the brand's uploaded logo first, otherwise the mapped collection's image.
• Image only (hide brand name) - logos only, no text labels.
• Section heading font size - 12 to 60 px.
• Columns desktop / mobile - 2 to 6 columns per breakpoint.

To mark vendors as featured, open Brands in the app and click the star icon next to the vendors you want.

Layout & style

The look of the main directory.

• Layout preset - the FIRST setting group in the block ("Layout preset", above Featured brands): restyle the whole brand grid in one click. "Custom (use settings below)" is the default and changes nothing; picking any other preset overrides the card style and image settings in Layout & style, and those overridden settings hide in the editor until you switch back to Custom. Three presets get their own column choice right below the preset picker: List columns (desktop) for List rows, Name columns (desktop) for Letter index rows, and Directory columns (desktop) for Letter columns.
• Show search bar - on/off.
• Show A-Z filter - on/off.
• Show brand images - show an image on each brand card: the brand's uploaded logo first, otherwise the mapped collection's image, otherwise the brand's first letter.
• Show product counts - shows how many products each brand's collection has, under the brand name. The number is the collection's published product count, so it always matches what shoppers find after clicking. Brands without a matched collection show no count.
• Image only - hide text labels on brand cards when images are shown.
• Card style - Soft (rounded), Outlined (sharp border), Minimal (no border), or No box.
• Spacing - Compact, Comfortable, or Spacious.
• Typography scale - Small, Normal, or Large.
• Brand name color - the brand names on the cards, featured brands included. Leave empty to use your theme's text colour.
• Brand name font size (px) - 10 to 24 px; at the default 13 the typography scale stays in charge.

Heading & search

• Show heading - on/off. The three settings below it only show while it's on.
• Heading text - the title above the directory (default "Brands").
• Font size - 16 to 80 px.
• Heading color - leave empty to use your theme's text colour.
• Search bar position - right of heading, or below heading. Only shows while the search bar is on.
• Placeholder text - what shows inside the search box when empty.

Filters

The category filter pills and the A-Z letter bar.

• Show tag filter pills - on/off toggle (on by default). Pills only appear once at least one visible brand has a tag.
• "All" pill label - the text on the first pill (default "All").
• Only show brands with this tag - type a tag name to pin this block instance to one category: only that tag's brands render and the pills are hidden. Case does not matter. This is how you run a separate brand page per category.
• Button size - A-Z letter buttons, Normal or Large. Only shows while the A-Z filter is on.
• Letter label font size - 10 to 72 px. Sizes the letter above each brand group.
• Letter label color - the same group letters. Leave empty to use your theme's colour.
• Gray out empty letters - A-Z letters with no brands turn gray and can't be clicked, so shoppers never land on an empty result. Off by default.

Tags themselves are created in the app and are part of the Plus plan - see brand tags and filter pills.

Columns & spacing

• Top, bottom, and side padding for the whole block, so you can tighten or loosen the space around the directory without touching your theme's section settings.

• Use different padding on mobile - off scales the desktop padding down automatically on mobile; turn it on to set Top, Bottom, and Side padding on mobile (px) yourself.

• Limit content width + Maximum content width (px) - some themes render app sections edge to edge instead of inside the page container. Turn this on to center the block at a set width (default 1200 px). Off by default, so nothing changes unless you opt in.

• Custom CSS (advanced) - extra CSS added on pages with this block, for fine-tuning beyond the settings. For example, target .ebp__card to restyle the brand cards.

• Columns desktop / mobile - 2 to 6 columns per breakpoint.

How block settings interact with admin settings

The theme block controls how it looks. The admin controls what data it shows. Specifically:

• Card visuals, spacing, columns - theme block.
• Whether a brand appears at all - admin (exclude toggle, out-of-stock filter).
• Whether a brand is marked as featured - admin (star icon).
• Which logo a brand shows - admin (the Edit menu on each brand's row on the Brands page).
• Which tags exist, which brands have them, and tag groups - admin (the Tags page).
• Which collection a brand links to - admin (settings, plus auto-mapping).
• What language the headings use - theme block (you set the text).
• What language the brand names use - your products' Vendor field, in whatever language you stored it.

Multiple language storefronts

Easy Brand Page is locale-agnostic. Heading text, search placeholder, and the "Brands" title live in the theme block and you edit them per locale through Shopify's standard theme translation flow. Brand names come from the vendor field on your products and render in whatever language you saved them as.

Removing or hiding the block

To temporarily hide the directory from a page without uninstalling the app:

1. Open the theme editor.
2. Click the Brand Page block.
3. Toggle Show off, or remove the block entirely.

The metafield with brand data remains in your shop, so reinstalling or re-adding the block restores the directory instantly.

The Brand link block (product pages)

The app's third block, for PRODUCT templates: it shows "More from" plus the brand's name, with its logo (or collection image), linking to that brand's page - replacing Shopify's plain vendor link that goes to an unstyled search page. Add it to your product template from the same Apps picker, or click Add to product pages in the Storefront blocks section on the app's dashboard to have it placed for you. Settings: Text before the brand name (default "More from"), Show the brand logo, and Alignment. It renders nothing when the product has no vendor or the brand is hidden in the app - the theme editor shows a small note in those cases so you can still select the block. Full guide: the Brand link block.

What's next

• The Brand slider block - the app's second block, a scrolling logo strip.
• Featured brands - the favourites row.
• Styling the brand directory - every visual setting in depth.
• How brand links are chosen - the link target per brand.