Filter Collections Using Reference/Multi reference Fields | SP Page Builder (Pro) - Documentation | JoomShaper

SP Page Builder (Pro)

Updated Last: 23 April 2026

Filter Collections Using Reference/Multi reference Fields

You can now show related items on the dynamic details pages with filters using reference and multi-reference fields straight from the Collection addon. For instance, if you are looking to display that “you might also like” section or “related items” section you can effortlessly achieve that with the Reference & Multi-Reference filtering.

This feature lets you filter and display collection items based on how they are connected to other collections through the Collection addon.

Important: This filter only works on the Dynamic Details page of collection items. The results are dependent on the specific item being viewed, so the output will change based on which item's page the visitor is on.

Simple Concept First

Imagine you have two collections:

  • Recipes — each recipe has a field called "Author" that links to a specific person
  • Authors — a separate collection of people who write recipes

This link between them is called a Reference Field.

When you're on a specific Author's page, you might want to show only the recipes written by that author. This filter makes that possible.

How to Set It Up

Step 1: Set your Collection Source to Recipes

Step 2: From the right panel, add a filter with these settings:

Conditions: 

  • Field: Recipes (Select the source collection)
  • Condition: Related
  • Association Field: Author (Reference field)

Result: This will display the recipes by the same author of that item’s page. 

This is similar to filtering by a reference field, but now the field can hold multiple connected values instead of just one.

Simple Concept First

Imagine you have two collections:

  • Recipes — each recipe has a field called "Tags" that can link to multiple tags
  • Tags — a separate collection containing things like "Vegan", "Italian", "Quick Meals", "Gluten Free"

This multi-link between them is called a Multi-Reference Field.

When you're on a specific Recipe page, you want to show other recipes that share similar tags. This filter makes that possible.

You're on a Pasta Carbonara recipe page. It has these tags:

  • Italian
  • Quick Meals
  • Comfort Food

You want to show other recipes at the bottom that share at least some of these tags.

How to Set It Up

Step 1: Set your Collection Source to Recipes

Step 2: From the right panel, add a filter with these settings:

Conditions: 

  • Field: Recipes (Select the source collection)
  • Condition: Related
  • Association Field: Tags (Multi-Reference field)
  • Match: Any/All

The Match Setting

Because Tags is a Multi-Reference Field, you get a Match option. This is where it gets a bit different from a regular reference field.

  • Match: Any — Shows recipes that share at least one tag with the current recipe.
  • Match: All — Shows recipes that contain every single tag the current recipe has.

Example: Pasta Carbonara is tagged Italian, Quick Meals, and Comfort Food.

Italian Comfort Pasta is tagged Italian, Quick Meals, Comfort Food, and Creamy -> Shows up because it has all three tags.

Spaghetti Bolognese is tagged Italian and Hearty -> Excluded because it is missing Quick Meals and Comfort Food.