Filter Widget

Filter Content

Post Widget Target

Define the CSS selector for the post widget that the filter will interact with.

Details: Use this setting to specify a unique CSS selector (either an ID or class) to target the desired post widget. This ensures the filter applies only to the intended content.

Examples:

• #my-posts (targets an element by ID)
• .post-grid (targets an element by class)

Post Type to Filter

Select the type of content to filter.

Details: Choose from available post types such as post, page, or custom post types like product for WooCommerce. This setting determines which content the filter will apply to.

Columns

Set the number of columns for the filter layout.

Details: Adjust the layout of filter elements by selecting 1 to 8 columns. This setting impacts the visual presentation and responsiveness of the filter on your site.

Options:

Option	Description
1–8 Columns	Select a number from 1 to 8 to define the grid layout for filter elements.

 

Group Title

Add a descriptive label to organize filter groups.

Details: Assign a label to categorize related filters, improving user navigation and clarity, especially when using multiple filter groups.

Enable Toggle Mode

Collapse or expand filter groups individually.

Details: Turns this filter group into a collapsible toggle section. Each group can have toggle mode enabled or disabled independently, improving UX when multiple filter groups are present.

Data Source

Define the source of filter data.

Details: Select the type of data to filter by. You can filter using categories, tags, custom taxonomies (added via plugins like Custom Post Type UI or ACF), or custom meta fields. This setting is essential for defining how your content will be filtered.

Options:

Data Source	Description
Taxonomy	Filter by taxonomy terms (e.g., product categories, tags).
Custom Field	Filter by custom field values associated with posts.
Custom Field (Numeric)	Filter by numeric custom field values (e.g., price, stock quantity).

Tips:

• Choose Taxonomy for category- or tag-based filtering, such as WooCommerce product categories.
• Use Custom Field for text-based meta.
• Use Custom Field (Numeric) for ranges like price or stock quantity.

Select a Taxonomy

Choose a specific taxonomy/meta for filtering.

Details: Pick from default taxonomies (category, post_tag) or WooCommerce-specific taxonomies like product_cat or product_tag. Meta keys need to be entered manually.

Field Type

Choose the user interaction style for custom field filters.

Details: Select how users interact with filter options, similar to WooCommerce’s filter widgets.

Options:

Field Type	Description
Checkboxes	Allow multiple selections.
Radio Buttons	Restrict to a single selection.
Label List	Display selectable labels.
Dropdown	Show options in a dropdown format.
Select2	Enhanced dropdown with search functionality. Multiselect option available.
Input Field	Allow users to enter custom values.

Tips:

• Use Select2 for large datasets, like WooCommerce product attributes.
• Choose Input Field for free-text filtering, such as SKU searches.

Custom Field Filter Settings

Field Key

Specify the meta key for custom field filtering.

Details: Enter the meta key associated with the custom field when Custom Field or Custom Field (Numeric) is selected. Meta keys are identifiers for custom data stored with posts, such as WooCommerce’s product meta.

How to Find the Meta Key:

1. Navigate to the Edit Product or Edit Post page in WordPress admin.
2. Locate the Custom Fields section (enable it in Screen Options if hidden).
3. Identify the meta key listed next to the custom field value.

Note: Custom fields will only display if the correct post type is selected in the filter widget.

Before

Add text before numeric custom field values.

Details: Available when Custom Field (Numeric) is selected and Range is chosen as the filter type. Use this to add context, such as units (e.g., “$” for price).

Filter Type (Numeric)

Define how numeric custom fields are filtered.

Details: Select the interaction style for numeric custom field filters, such as those used in WooCommerce for prices or stock quantities.

Options:

Filter Type	Description
Range	Users select a range (e.g., $50–$100). Ideal for fields like _price.
Checkboxes	Allow multiple value selections (e.g., stock quantities like 10, 20, 30).
Radio Buttons	Restrict to a single value (e.g., specific price points).
Label List	Display values as selectable labels (e.g., “Low,” “Medium,” “High”).
Dropdown	Present values in a compact dropdown menu.

Common Post Meta Fields

Below are WooCommerce-specific meta keys frequently used for filtering products.

Examples:

• Price (_price): Stores the product price (e.g., 19.99).
• Sale Price (_sale_price): Stores the discounted price (e.g., 15.99).
• Stock Quantity (_stock): Stores the available stock (e.g., 50).
• Stock Status (_stock_status): Indicates stock availability (e.g., instock, outofstock).
• Weight (_weight): Stores product weight (e.g., 2.5 kg).
• Dimensions (_length, _width, _height): Stores product dimensions (e.g., 10, 5, 8 cm).

Tips:

• Refer to WooCommerce documentation for additional meta keys, such as _sku for product SKUs.
• Use consistent naming conventions for meta keys to ensure compatibility.

Filter List Advanced Options

Sort By

Define how filter terms are sorted.

Details: Choose the sorting criteria for filter terms, similar to WooCommerce’s product sorting options.

Options:

Sort By	Description
Name	Sort alphabetically by term name.
Slug	Sort by term slugs.
Count	Sort by the number of associated posts.
Term Group	Sort by term groups.
Term Order	Sort by order defined in WordPress admin.
Term ID	Sort by unique term IDs.

Order

Control the display order of terms.

Details: Set how terms are sorted within the filter (ACS or DESC).

Group Logic

Set the logical operator for filter groups.

Details: Define how selected terms within the same group interact.

Options:

Logic	Description
OR	Any filter in the group can match.
AND	All filters in the group must match.

Tips:

• Use OR for flexible filtering, like combining product categories.
• Choose AND for strict criteria, such as price and stock status.

Display Empty Terms

Show terms in the list even when they have no associated posts.

Show Post Count

Display the number of posts per term.

Details: Enable to show post counts next to filter terms.

Show Hierarchy

Display parent/child term relationships.

Details: Enable to show hierarchical taxonomies (e.g., parent and child product categories), improving organization.

Toggle Child Terms

Allow users to expand/collapse child terms.

More/Less

Add “More/Less” functionality for checkboxes and radio buttons.

Note: Will display when the list has 5 terms or more.

Details: Enable to let users toggle visibility of child terms in hierarchical taxonomies, enhancing usability.

Select All

Allow users to quickly select all terms in a filter group.

Note: Available only for label lists, checkboxes, and radio lists.

Details: Adds a “Select All” option at the top of the terms list. Can be enabled or disabled per group for more granular control over filter behavior.

Parent Options

Parent Logic

Set the logical operator for parent filters.

Details: Define how parent filters interact within the same group (post meta or taxonomy).

Options:

Logic	Description
AND	All selected terms in taxonomy/meta groups must match.
OR	Any selected terms in taxonomy/meta groups can match.

Tips:

• Use AND for strict parent filter combinations, like category and price.
• Choose OR for more flexible filtering.

Dynamic Archive Filtering

Enable filtering on archive pages.

Details: Include the current archive context in the filter’s query.

Default Filters

Default Filter Rules

Apply fixed filter rules that users can’t override.

Details: Use this setting to define default taxonomy, meta, numeric meta, or date-based filters. These are always applied when filtering posts. This feature allows site owners to enforce filtering rules regardless of frontend user input.

Examples:

• Only show products with the term “red”, included.
• Pre-filter blog posts to only include those newer than 30 days.

Performance Settings

Load Only Post ID

Load only post IDs instead of full post objects.

Details: Improves performance by retrieving only post IDs. Ideal for widgets that only need the ID, but may break widgets that depend on full post data.

Default: Off
Impact on Speed: High

Skip Pagination Count

Avoid counting total matching posts.

Details: Skips the expensive pagination count query. Only use when pagination is not needed.

Default: Off
Impact on Speed: Medium

Bypass Query Modifications

Disable internal query modifications.

Details: Ignores additional logic added to the query by the plugin. Useful for debugging or avoiding third-party conflicts, but may break features that rely on enhanced queries.
Note: Do not enable this option if you’re using a translation plugin, as it may prevent language-specific filtering from working correctly.

Default: Off
Impact on Speed: Medium

Posts Per Page

Set how many posts are returned per query.

Details: Controls the number of posts returned. Set to -1 to use the default value defined in the post widget (if accessible).
Default: -1
Impact on Speed: High

Cache Filter Terms

Improve page load time by caching the filter terms list.

Details: Stores the list of available filter terms in a transient to reduce database load on each page load. This does not affect the post query itself. Set to 0 to disable (not recommended unless you’re debugging or frequently updating taxonomy terms).

Default: 86400 (1 day)
Impact on Speed: High

Additional Options

Display Reset Button

Show or hide the reset button.

Details: Enable to allow users to clear all filter selections with a single click, similar to WooCommerce’s filter reset.

Reset Button Text

Customize the reset button’s text.

Details: Set the text for the reset button (e.g., “Clear Filters”) when enabled.

Display Submit Button

Show or hide the submit button.

Details: Enable to allow users to manually apply filter selections, unlike WooCommerce’s default real-time filtering.

Submit Button Text

Customize the submit button’s text.

Details: Set the text for the submit button (e.g., “Apply Filters”) when enabled.

Scroll to Top

Enable automatic scrolling after filtering.

Details: Activate to scroll the page to the top when filters are applied, improving user experience.

Nothing Found Message

Customize the message for no filter results.

Details: Set a custom message to display when no posts match the filter criteria. Default: “It seems we can’t find what you’re looking for.”

Enable Query Debugging

Troubleshoot filter behavior and query output.

Details: When enabled, this option will display the filter query on the frontend, below the filter (visible to logged-in admins only).