Accentuate Custom Fields
  • Welcome!
  • Introduction
    • Getting started with ACF
    • Field scopes
    • How to show fields in your storefront
  • Dashboard
    • Reference Manager
      • Creating a new reference within Reference Manager
    • Filter & Group
      • Filter editor
      • Filter usage
    • Activity log
    • App settings
  • Field Definitions
    • Fields & Sections
    • Deciding on a field type
    • ACF Field types
      • Text
      • Markdown text
      • HTML
      • Checkbox
      • Selection
      • Tags
      • Number
      • Date
      • Color
      • Media v1 (legacy)
      • Media v2
      • Custom Object (JSON)
      • Multi-language Text
      • Reference fields
      • References to Global fields
    • Shopify Field types
      • Shopify » Single line text
      • Shopify » Multi-line text
      • Shopify » Boolean
      • Shopify » Color
      • Shopify » Custom objects (JSON)
      • Shopify » URL
      • Shopify » Date
      • Shopify » Date and Time
      • Shopify » Integer
      • Shopify » Decimal
      • Shopify » Weight
      • Shopify » Volume
      • Shopify » Dimensions
      • Shopify » Reference fields
    • Automatic tagging
    • Large sets
    • Field contexts
    • Field context filters
    • Copy and paste fields
    • Change field name and type
    • Import existing fields
    • Linking multiple stores
  • The Editor
    • Using the editor
    • Promote fields to sidebar
    • Layouts
    • Hide from search
    • Repeatable fields
    • Version control
    • Update value on order creation
  • Bulk Import & Export
    • Export custom field values
    • Import custom field values
    • Metaobject export / import
  • METAOBJECTS
    • What are Metaobjects?
    • Metaobject Definitions
    • Metaobject instances / values
    • Displaying Metaobjects on your storefront
    • Metaobject export / import
  • THEME EXTENSIONS
    • SEO keywords
    • Sticky promo bar
    • Products promotion
  • Liquid Guides
    • Learning Liquid
    • Resize & crop images
    • Check for empty values
    • Access field definitions
    • Order notifications
    • Allow customers to change their field values
  • OTHER
    • Webhooks
    • API
      • Access to custom fields
      • Endpoints
  • Help
    • FAQ
      • Why are one of my products no longer showing in my reference field?
      • I have multiple products/variants with the same name
      • How do I make changes to my field values in bulk?
      • I added a new field definition but it is not showing in my storefront
      • How do I copy my field setup to another store?
      • My fields are still showing after I have deleted their field definition
      • Why are none of my fields showing in the editor?
      • My newly created object in Shopify is not available in ACF
      • Reference lists are empty?
      • Why am I seeing a "value cannot exceed 100,000 characters" error when saving?
      • Why can't I name my field "first", "last" or "size"?
    • Need help?
  • Product
    • Changelog
    • Feedback & Suggestions
Powered by GitBook
On this page
  • What is ACF Filter & Group?
  • How to access Filter & Group?
  • How to utilize ACF Filter & Group?
  • Grouping the queries
  • Previewing affected items
  1. Dashboard
  2. Filter & Group

Filter editor

Learn how to use filters to easily select data and reuse it all around your store.

PreviousFilter & GroupNextFilter usage

Last updated 2 months ago

What is ACF Filter & Group?

Manipulating data can sometimes be an exhausting process. To make it easier, more intuitive and effective, we’ve created an optimal solution to get the data in almost no time - ACF Filter & Group. This functionality allows for swift querying within the data encompassed by the following scopes:

  • Products

  • Variants

  • Collections

  • Orders

How to access Filter & Group?

Accessing Filter & Group is straightforward - simply click on the dropdown menu as shown below, and you'll find Filter & Group among the available options.

How to utilize ACF Filter & Group?

Upon entering Filter & Group, you'll be greeted by the Filter list page. At the top, there's a banner providing information about Filter & Group and its capabilities.

To create a new query, simply click either the button with the label “new”, or the hyperlink down the filters list segment and you’ll be redirected to the Query Builder Page, which should look like this.

Let’s break the page's functionality into pieces to make it easier to understand each segment. First of all, the top of the page contains action buttons: new (creates a completely new filter), duplicate (duplicates current filter), preview (shows a modal that includes all the affected items by the desired filter) and finally save, which saves the current filter.

Next up, it’s time to choose one of the available scopes from the dropdown menu (in this case, the chosen scope is products). We encourage you to give filters descriptive names in order to make it easier to use them later.

If you accidentally make a mistake that makes the query unavailable to run, Filter & Group will warn you about it in the status bar (in case everything seems okay, the All good label will appear).

The selector dropdown menu enables you to choose from 10 distinct selectors (with the total number varying based on the scope). Depending on the selected selector and the logical operators available, the value type is dynamically adjusted. Utilizing the plus button on the right side enables the addition of another statement to the current query.

Grouping the queries

In case you have to manipulate more than one segment of queries, there is an option to group filters. To achieve that, you have to select the desired filters and click the “Group by” button.

Previewing affected items

When you're done editing your filter we recommend you preview the affected items to double-check your results before going on to save your filter. Some mistakes might have flown under your radar and this is a great way to catch them.

Note that the individual filters order can be rearranged by simply dragging and dropping them in the desired place. Also, it’s possible to toggle the operator value (AND/OR) by clicking the icon. Add more menu options allows you to add AND/OR operators, as well as bracket symbols.