GuidePlugin LogoGuidePlugin Docs

Filter

Create interactive filters that transform facets into user-friendly selection options for your guides.

Filters transform your facets into interactive questions and selection options for users. Each filter represents one step in your guide where users make choices to narrow down results.

Filter Types Overview

Filter TypeBest ForExample Use Cases
CardsMultiple choice selectionsProduct categories, features, styles
SliderNumeric rangesPrice ranges, sizes, quantities

Creating a Filter

Go to GuidePlugin > Filter > Create in your WordPress admin.

Configure Text Settings

Set up the user-facing question and description:

FieldPurposeExample
QuestionWhat users see"What's your budget range?"
DescriptionOptional clarification"Select your preferred price range"

Filter text configuration

Keep questions short and clear - users decide quickly whether to continue or leave.

Define Filter Options

Link your facets to user choices:

Filter options configuration

Available Filter Types:

  • Cards - Visual tiles for multiple choice
  • Slider - Range selection for numeric values
  • More types coming - Date, location, etc.

Add Help Text (Optional)

Provide additional context for complex questions:

Filter help text

Help appears above navigation buttons in the frontend:

Frontend help display

Configure Progress Display

Set loading messages during result processing:

Progress configuration

SettingPurpose
Show in ProgressEnable/disable loading message
Progress LabelCustom message during search

Save and Test

Save your filter and test it in a guide to ensure proper functionality.

Filter Configuration Best Practices

AspectRecommendationWhy
Question LengthKeep under 10 wordsMaintains user engagement
Options Count3-7 choices per filterAvoids decision paralysis
Help TextUse sparinglyOnly for complex concepts
Progress MessagesBe specific"Finding products..." vs "Processing..."

Common Issues

ProblemSymptomsSolutions
No ResultsFilter shows but returns nothingVerify linked facets have data
Check facet-filter mapping
Ensure content matches filter criteria
Too Many ResultsFilter doesn't narrow down enoughAdd more specific filter options
Combine multiple facets in one filter
Review facet data granularity
Slow LoadingFilter takes long to displayOptimize facet indexing
Reduce complex query combinations
Check server performance

Next Steps

Once your filters are ready:

ComponentPurposeLink
GuidesCombine filters into complete experiencesLearn More →
TemplatesDesign how results are displayedLearn More →
LogicAdd conditional filter behaviorLearn More →