Skip to main content

Filters, periods, segments and FQL

Filter your feedback, understand a filter's scope, save reusable segments and write FQL queries for the API.

F
Written by François Forest

In short: a filter narrows what you see on a page. A segment is a saved filter, reusable everywhere. FQL is the technical syntax of these filters, used by the API. AI helps you write them and provides two of the most useful criteria: topics and sentiment.

Filter your feedback

On most pages, Apply a filter opens the condition editor: source, attribute, topic, NPS, satisfaction, team, status…

Example: all feedback from the Marseille or Singapore locations that mentions food quality.

Logic

Rule

Conditions within the same group

Combined with AND, evaluated first

Groups with each other

Combined with OR

Example: (site = Berlin AND topic = Drinks) OR (topic = Locker room).

[SCREENSHOT MISSING] Filter editor with two groups of conditions.

Filter with AI

What you want

How AI helps

Write a filter without knowing the fields

Describe your need to Ask Feedier ("dissatisfied customers in Chicago who mention waiting"): it turns it into conditions

Find all feedback on a subject

Filter on a topic: each verbatim has been classified there by AI, whatever words the customer used

Isolate unhappy customers, even without a rating

Filter on the sentiment detected by AI, useful for reviews, tickets and messages without NPS

Scope: whole feedback or element

A feedback can contain several verbatims on different topics. The scope decides what's kept.

Scope

Filter "Topic = Delivery"

Whole feedback (default)

The entire feedback: the rating, the verbatim about delivery and the one about product quality

Feedback element

Only the verbatim about delivery

Period

The period selector applies to the whole page. Each team can define a default period and a default filter in Settings → Teams → View, applied to members who don't have a personal view.

Segments

Menu → Settings → Segments

A segment saves a complex filter so you can reuse it in reports, KPIs, automations and Text Analysis.

Type

Use

Normal

A filter reusable everywhere

Locked

Applied automatically to the user when they sign in

Subject

Used in Text Analysis, so AI analyzes a specific scope

Role

Access

Admin

Full access

Editor

Create segments; edit the ones they own

Viewer, Restricted Viewer

Read-only

Tip: create one segment per population you track ("Premium customers", "Support detractors", "Negative sentiment on delivery") and use it as an automation trigger or a report filter.

FQL (Feedback Query Language)

FQL is the syntax of Feedier filters. It's used in the API and in the feedback display widget.

Get FQL without writing it

  1. Build the filter in the feedback feed.

  2. Copy the page URL.

  3. Decode it with a URL decoder: the FQL is the value of the fql= parameter.

[[{"Form":{"$in":[453],"$type":"and"}}],[{"Attribute":{"$in":["United States"],"name":"country","$type":"and"}}],[{"Nps":{"$in":["promoter"],"$type":"and"}}]]

Operators

Operator

Meaning

Value

$type

and (default) or or

—

$eq / $ne

Equal / not equal

Number or text

$gt / $lt / $gte / $lte

Greater / less than (or equal)

Number or text

$like / $nlike

Contains / doesn't contain

Number or text

$in / $nin

Is / isn't in the list

Array

$btw

Between two dates (start and end of day)

Array

Selectors

Selector

Example

Attribute

{"Attribute":{"name":"age","$in":["23"],"$type":"and"}}

Period (creation date)

{"TimePeriod":{"$eq":"date_last_month","$type":"and"}} or {"TimePeriod":{"$gt":"2026-03-01T00:00:00.000Z","$type":"and"}}

Source

{"Form":{"$in":[28121],"$type":"and"}}

Feedback ID

{"Id":{"$in":[12,23],"$type":"and"}}

Satisfaction ratio

{"SatisfactionRatio":{"$gt":"50","$type":"and"}}

Answer to a question

{"QuestionAnswer":{"question_id":1132803,"question_type":"textarea","$eq":"50","$type":"and"}}

Team

{"Team":{"$in":[13682],"$type":"and"}}

Owner (assignee)

{"Owner":{"$in":[17107],"$type":"and"}}

Status

{"Status":{"$eq":1,"$type":"and"}}

Topic (detected by AI)

{"Topic":{"$in":[2713],"$type":"and"}}

NPS

{"NPS":{"$in":["promoter"]}}

For the previous day, use date_last_day in the period selector.

FAQ

Why doesn't my filter return anything?

Check the period, the AND / OR logic between your groups, and the selected team.

How do I enforce a filter for all members of a team?

Set the team's default filter in Settings → Teams → View, or use a locked segment.

A topic filter misses some feedback. Why?

AI didn't classify the verbatim under that topic. Correct it in the feedback feed, or adjust the topic's rules in the Taxonomy Lab.


Last reviewed: November 11, 2026, version 4.23.5.

Did this answer your question?