Menu → Settings → KPI formulas
In short: a custom KPI is a formula written once and reused wherever you choose a KPI: reports, charts, score tables, benchmarks. It's recalculated live based on the page's filters, period and team, and can rely on the topics and sentiment calculated by AI.
Create a KPI
Go to Settings → KPI formulas and click Add a formula.
Enter the Name, a Description and the Formula.
Choose a Suffix (
%,/5,h, a currency…) and a Format (0,0.0,0.00…).Turn on Lower is better if a decrease is good news (detractors, delays, effort).
Set the Visibility for your teams, then save.
The formula is tested when you save. If it can't be calculated, the message "This formula is invalid." appears. See Troubleshooting.
Best practices: a name everyone understands, a description whenever the scope isn't obvious, always a suffix, and one simple KPI per question rather than a formula that does everything.
Syntax
A formula combines functions. Each function can be restricted by conditions, always written in groups of three:
function("parameter.property", "operator", "value")Rule | Example |
One condition |
|
Several conditions = AND |
|
Several values (array) = OR |
|
No condition = the whole scope |
|
Combine with |
|
Straight quotes are required around the parameter, the operator and the value (except numbers and booleans in an array). The number of arguments in a function is always a multiple of three.
A division by zero returns 0. A formula never returns data that a user isn't allowed to see.
Functions
Function | Returns | Unit | Accepted parameters |
| Number of feedback | Count | All standard parameters* |
| Number of feedback with at least one matching response | Count | Standard* |
| Number of invitations sent (email and SMS) | Count |
|
| Net Promoter Score | −100 to 100 | Standard* |
| Satisfaction ratio (includes the sentiment of text responses) | 0 to 100 | Standard* |
| Average sentiment, calculated by AI | 0 to 100 | Standard* |
| Customer Effort Score | The question's scale | Standard* |
| Average of ratings / rating grids | The question's scale | Standard* |
| Average time to complete a survey | Minutes |
|
| Average resolution time (assigned feedback only) | Seconds | Same as |
| Financial impact: (opportunities − risks) × average customer value | Currency |
|
| Aggregation of a numeric attribute | The attribute's unit |
|
| A value read from an external API | Free |
|
* Standard parameters: attribute, feedback, import, nps, question, response, segment, survey, team, topic.
push() only counts invitations from Feedier surveys: it returns 0 without a Feedier Survey connection or without a survey source in the scope. financial() uses the average customer value set in Settings → Teams → Advanced; without it, it returns 0.
KPIs that rely on AI
Building block | Calculated by AI | KPI example |
| The sentiment of each passage | Sentiment of Google reviews about delivery: |
| The classification of each verbatim into your topics | Share of feedback that mentions waiting: |
| The qualitative half of the ratio (text sentiment) | See KPIs and scores |
Parameters
Parameter | Values | Good to know |
|
| With |
| The attribute to aggregate | For |
| An ID | — |
|
| Feedier surveys only: imported feedback is excluded |
|
| For |
|
| No |
|
|
|
|
| For |
|
|
|
|
| Includes reminders |
| An ID or the exact label | Including accents and punctuation |
|
| No |
| A choice or a grid row | — |
|
| Combine with a |
| An ID | Visible in the URL of the corresponding page |
| The exact name of a topic | A topic from your taxonomy, assigned by AI |
| A URL | For |
Values are checked against your workspace: an unknown ID, topic or label makes the whole formula invalid.
Operators
Operator | Scope | Effect |
| Whole feedback | Keeps the feedback that meets the condition |
| Whole feedback | Excludes that feedback |
| Element (response, verbatim, topic) | The condition must be met by the same element |
| Element | Removes those elements from the calculation, keeps the rest of the feedback |
The strict operators == and !== can only be used with question, response and topic. Example with a topic's sentiment:
Formula | What is measured |
| Entire feedback that mentions packaging, including everything else it says |
| Only the passages about packaging |
| Feedback that never mentions packaging |
| All feedback, minus what it says about packaging |
Ready-to-use formulas
KPI | Formula | Settings |
Response rate |
|
|
Detractor rate |
|
|
Promoter rate |
|
|
CSAT (ratings of 4 or 5) |
|
|
Share of Google reviews |
|
|
Share of a chosen option |
|
|
Resolution time |
|
|
Revenue at risk |
| Currency (negative value) |
Detractors' average order value |
| Currency |
Response rate: only Feedier surveys generate invitations. On a source that mixes 57 survey responses and 181 CSV rows for 654 invitations, the rate is 57 / 654 = 8.7%: CSV rows are excluded.
Read an external value with url()
url("link.link", "=", "https://example.com/api/metric~data.value")Element | Role |
The URL | Called with GET, server-side, over |
The path after | The key to read in the JSON response (default: |
| Replaced by the page's filters |
| Replaced by the user viewing the KPI |
| Replaced by the workspace's private key |
The request contains your private key: only call endpoints you control. An endpoint that's too slow makes the whole formula fail.
Troubleshooting
Symptom | Cause | Solution |
"This formula is invalid." | Syntax, unknown value or parameter not accepted | Check in this order: quotes and groups of three, exact values, Accepted parameters column |
Operator rejected |
| Go back to |
The KPI shows 0 | Division by zero, or nothing matches | Create the numerator and the denominator as two KPIs to find the empty one |
| No Feedier Survey connection or source in the scope | Check the source being measured |
Value off by a factor |
| Convert and adjust the suffix |
| Timeout or nonexistent JSON path | Test the URL outside Feedier |
Last reviewed: November 11, 2026, version 4.23.5.

