Words in Ziffr
Every word Ziffr uses, and what it means. The app, this guide and the people who build Ziffr all use these words in the same way, so a word here means the same thing on every screen.
Some entries end with "Elsewhere you may see": words other tools use for something similar. Ziffr does not use them, because they usually mean something slightly different. If you are used to a "KPI", look up Metric.
Throughout the guide, a term in bold leads to its entry here.
Metrics
Metric
A named, fully described number tracked over time. It must be defined before any value can be recorded for it.
Elsewhere you may see: Number, KPI, series
Metric Description
Everything that defines a metric: name, description, unit and format, period, submission rule, sources, target range, polarity, owner and, for a derived metric, its formula.
Elsewhere you may see: Settings, config, schema
Derived Metric
A metric computed by a formula from other metrics. It never receives observations directly.
Elsewhere you may see: Calculated field, formula metric
Aggregation
How a metric's values combine into a longer period: summed (revenue, deals), averaged (a score), the last value (a balance), or not at all (a rate).
Elsewhere you may see: Roll-up, rollup method, combine rule
Target Series
Target values for individual periods, such as a monthly budget, uploaded like observations. Where a period has none, the metric's target range applies.
Elsewhere you may see: Budget, plan, goal series
Projection
A value for a future period, from an outside forecast or Ziffr's own, uploaded like an observation and always shown as a projection, never as an observation.
Elsewhere you may see: Forecast value, estimate, prediction
Polarity
Which direction is good for a metric: higher is better, lower is better, or closer to target is better.
Elsewhere you may see: Direction, trend preference
Target Range
The band of values a metric should stay within.
Elsewhere you may see: Threshold, goal, limits
Metric Owner
The user responsible for a metric's description and for accepting corrections to its observations.
Elsewhere you may see: Admin, maintainer
Metric Catalog
A library of predefined metric descriptions. Picking one copies its description into a new metric of your own, with no link back to the catalog.
Elsewhere you may see: Template library, presets
Observation
One value of a metric for one period.
Elsewhere you may see: Number, entry, data point, upload
Breakdown
Labelled values that split one observation, such as revenue by country for October, uploaded with it. Labels are free text; the observation's value stays the metric's number even when the rows do not add up to it.
Elsewhere you may see: Dimension, segment, table, drill-down
Comparing
Comparison
A metric's latest value against an earlier span: the previous period, or the same span one day, week, month, quarter, half-year or year earlier (DoD, WoW, MoM, QoQ, HoH, YoY), as an absolute and a relative change. Spans longer than the metric's period compare to date against the same span before, unless a widget asks for full periods.
Elsewhere you may see: Delta, variance, period over period
Attainment
How far a value reaches its target, as a percentage where higher is always better, whichever way the metric's polarity runs.
Elsewhere you may see: Achievement, target fulfilment, performance
Input
Connector
A link between Ziffr and an outside system, such as Slack, email, WhatsApp, a ticket system or the web form, and what it can do there: receive values, send reminders, send questions and tasks, bring replies back, keep a task's status in step. Some, such as Slack, are connected per Workspace by an Owner or Admin, to one workspace of that system, and reach a person only once they are found there by their proven address or link themselves.
Elsewhere you may see: Integration, plugin, channel
Source
A Connector used to receive observations, such as mail, a messenger, Slack or a web form. Programs with an Access Key and Feeds use the API Source, which a metric turns on separately from the personal form link.
Elsewhere you may see: Input, integration
Submitter
A person allowed to record observations for a given metric: a Member, a Guest, a Contact without a login, or a Feed.
Elsewhere you may see: Reporter, contributor
Feed
A program outside Ziffr that brings in values for some metrics from another system, such as a CRM or a data warehouse. It belongs to the Workspace, not to a person, and only Owners and Admins create one. It is a Submitter of its own, uses a Feed Key, is never sent Prompts, and keeps working when the person who created it leaves. Ziffr never runs its code or holds its credentials for the other system. An n8n or Zapier flow that sends values is an automation, never a Workflow.
Elsewhere you may see: Integration, sync, pipeline
Import
Values a Feed records for past periods that had none yet, such as two years of history when it is first connected. They skip the Unusual Value check and are marked as imported in the metric's history.
Elsewhere you may see: Backfill, migration, sync
Token
The standing permission that links one submitter to one metric. Every incoming value is checked against a token, which is usually invisible and implied by who sent the value and where.
Elsewhere you may see: Key, code, credential
Submission Rule
Part of a metric's description that sets its period and what happens when a second value arrives for the same period: reject, overwrite, add up, or keep both.
Elsewhere you may see: Dedup rule, overwrite policy
Prompt
A scheduled message asking a submitter for a metric's value for the current period, e.g. "How many deals today?" It goes out through the submitter's Connector; where that Connector receives values, answering it records the value, elsewhere it carries the personal form link.
Elsewhere you may see: Reminder, nudge
Workflow
A named, reusable path a metric's value takes each period: ask the submitter, remind, escalate, check, approve, publish and lock. Several metrics can share one, such as "Monthly finance close". Its owner can close a period for all of them at once.
Elsewhere you may see: Process, pipeline, flow
Due Date
When a period's value must be in, counted in working days after the period ends, e.g. the 3rd working day.
Elsewhere you may see: Deadline, cut-off
Stand-in
The person asked instead of a submitter who is Away, or who has not answered by the Due Date.
Elsewhere you may see: Deputy, backup, substitute
Away
The dates a person is not available. While someone is away, Prompts meant for them go to their Stand-in.
Elsewhere you may see: Absence, out of office, leave
Escalation
A Workflow step that, when a value is still missing, asks the Stand-in or tells the metric owner.
Elsewhere you may see: Alert, warning
Unusual Value
A value that changes more than a set share against the period before, or falls outside the target. Only unusual values need Approval. An Import is not checked.
Elsewhere you may see: Outlier, anomaly
Approval
Confirming an Unusual Value, by each Approver in order. An approver can approve it, send it back to the submitter with a comment, or correct it. Until it is approved the value shows, marked as not approved yet.
Elsewhere you may see: Sign-off, review, verification
Lock
A published period of a metric that takes no more values. A late value or a correction becomes a proposal that needs Approval again; only the metric owner unlocks it, with a reason.
Elsewhere you may see: Freeze, finalize, close
Presentation
View
A way of drawing a metric, such as a number with sparkline, a line chart, bars, a gauge or a history table.
Elsewhere you may see: Chart type, visualization plugin
Finding
A widget set as an editorial graphic: a frame of kicker, headline stating the finding, subline, footnotes and source, around one or more panels. Findings sit on dashboards, where they read like the sections of an article in the Read view, and on slides.
Elsewhere you may see: Story widget, infographic, chart card, editorial chart
Panel
One chart inside a Finding, such as ranked bars, period bars, a bridge or an annotated line, showing one measure of one or more metrics. Several metrics in one panel are drawn side by side as small multiples.
Elsewhere you may see: Chart, subplot, facet
Measure
What a panel draws from a metric: its value, a comparison, its attainment or a share of a breakdown.
Elsewhere you may see: Field, calculation, KPI
Annotation
A callout, highlight ring or note in a panel, attached to what it is about (the highest bar, the last period, the France row) rather than to a position, so it follows the data or disappears when its target is gone.
Elsewhere you may see: Label, comment, sticker, markup
Bridge
A panel that walks from a start value through signed steps to an end value, either from one breakdown's rows or from the change between two periods, row by row.
Elsewhere you may see: Waterfall, walk, cascade
Widget Template
A starting point for a new widget or Finding: a view, its settings and, when the team saved it, its words and annotations, with the metrics left open as Slots. Ziffr ships built-in templates; anyone can save a widget as a team template, which only its creator edits. If none is chosen, the default template is used.
Elsewhere you may see: Preset, widget type, blueprint
Dashboard Template
A starting point for a new dashboard: its widgets with their views, settings, words and layout, with the metrics left open as Slots. One Slot can fill several widgets. Ziffr ships built-in ones; anyone who may change a dashboard and sees every metric on it can save it as a team template, which only its creator changes. A dashboard made from one is an independent copy. "Template" alone is never used in UI text without "Widget" or "Dashboard".
Elsewhere you may see: Preset, blueprint, starter dashboard
Slot
A place in a Widget Template or Dashboard Template that is filled with a metric when the template is used. A slot takes exactly one metric, or one or more for small multiples.
Elsewhere you may see: Variable, parameter, input
Placeholder
A word in a template's text that is filled in from the data when the template is used, such as the metric's name, the latest period or the change against last year.
Elsewhere you may see: variable, merge field
Widget
One metric drawn with a view and its settings, such as time window, target band or visible history. A saved widget can be reused; placing it on a dashboard places an independent copy.
Elsewhere you may see: Tile, card, chart
Free Layout
A widget that holds an artboard of its own, laid out like a slide: widgets from the Pool, text, arrows, shapes and drawings placed freely. On a dashboard it shows read-only with live numbers; its owner or Editors change it with Edit layout…. What is drawn stays where it was placed, so it says when its Metrics have newer periods than when it was drawn.
Elsewhere you may see: Canvas, drawing, board, freeform widget
Pool
The side panel that holds everything a user can drag onto a canvas: the metrics they can see, their saved widgets and the Widget Templates.
Elsewhere you may see: Library, palette, sidebar
Preview
A Widget Template, Dashboard Template, saved widget or metric drawn small before it is placed, without its menus. A template's Preview draws Sample Data; a saved widget's or a metric's draws the viewer's own data.
Elsewhere you may see: Thumbnail, mock-up
Sample Data
Made-up metrics and values that a template's Preview draws, because a template has no metrics of its own. The same for everyone and never a workspace's data.
Elsewhere you may see: Dummy data, fake data, demo data
Dashboard
A canvas of widgets that a user arranges and can share, to watch numbers as they come in. It has a name and may have an introduction, and reads two ways: Grid, as arranged, and Read, the introduction and then its widgets one below the other in reading order, for a phone or to explain what happened. Ziffr opens on a person's Home dashboard, which they choose.
Elsewhere you may see: Board, report, page, story
Analysis Canvas
A workspace where a user drops one or more metrics and runs analyses on them.
Elsewhere you may see: Workbench, lab, playground
Analysis
A statistical method run on one or more metrics, such as forecast, correlation, clustering or impact analysis. Its result can be saved as a widget.
Elsewhere you may see: Stats, model, insight
Recipe
A ready-made analysis setup that runs with one click, e.g. "What drives Cost?"
Elsewhere you may see: Preset analysis, template
Decks
Deck
An ordered set of slides that a user designs from widgets, text, arrows and shapes, and exports as a presentation.
Elsewhere you may see: Presentation, slideshow, report
Slide
One 16:9 page of a deck. Its order follows its position on the deck canvas, left to right and top to bottom.
Elsewhere you may see: Page, frame, board
Theme
A named look for everything that shows numbers: colours for text, surfaces, data, good, bad and the target band, the fonts for headlines, text and figures, how cards are drawn, and what every slide shows (logo, footer, slide number, background image, type sizes). The team has one default theme; a dashboard or deck may use another, and a deck may set its own footer. A slide may hide the logo, footer and number. Ziffr's own screens keep their look. Only the workspace owner changes themes.
Elsewhere you may see: Master, skin, style, brand kit, palette
Snapshot
What something showed, fixed so it never changes when observations do. A dashboard's Snapshot keeps the dashboard as it stood for one week, month or quarter: its layout and the values of every Metric period complete by the period's last day. Its numbers never change, and a value corrected since is shown with a note of what it is now; its words (the introduction, each Finding's headline and sentences) are written after it is taken, and every change is a Version. It is a draft for the dashboard's owner and Editors until one of them shows it; then whoever may open the dashboard may open it, and sees in it only the Metrics they may see now. Its owner may have the dashboard take one of every week, month or quarter by itself, once every Metric on it is Locked for the period or a set number of days after it ends. A deck's Snapshot is the values its widgets show at the moment it is exported, stamped with that date.
Elsewhere you may see: Copy, freeze, archive, export data
Sharing
Workspace
One team's own space in Ziffr, with its people, metrics, dashboards, decks, themes and connectors. A person can belong to several and switches between them; nothing is shared across workspaces.
Elsewhere you may see: Tenant, organisation, account, company
Installation
One running Ziffr: its app, its database and its keys, reached at one address. It can hold many workspaces, and whoever runs it decides its settings, such as whether it offers the demo.
Elsewhere you may see: Instance, deployment, server, tenant
Workspace Profile
What kind of business a Workspace belongs to: its industry, who it sells to (B2B, B2C, B2B2C, public sector, non-profit), its country and currency, and how many people and how much revenue it has, each picked from a fixed list. Ziffr uses it to suggest Metrics; teams within a workspace are Groups, not part of it.
Elsewhere you may see: Classification, company profile, firmographics, tenant settings
Workspace Role
What a person may do in a Workspace as a whole. A Workspace Owner manages settings, themes, groups, members and billing; a Workspace Admin does the same except billing and removing owners; a Member creates and shares metrics, dashboards and decks; a Guest only sees what is shared with them, answers questions and submits values, and creates nothing. A workspace can have several owners.
Elsewhere you may see: Permission level, admin rights
Invitation
An offer to join a Workspace with a Workspace Role, made by an Owner or Admin. One sent to an email address is accepted once, by that address; a link works for anyone who has it until it ends or is revoked. Inviting a Contact makes them a member who keeps their history.
Elsewhere you may see: Invite code, access grant
Domain Joining
A Workspace setting, off by default, that lets people with a verified address at the company's domain ask to join; an Owner or Admin lets each one in.
Elsewhere you may see: Auto-join, SSO
Contact
A person known to a Workspace who has no login, such as a field worker or an outside bookkeeper who submits values by Slack, email or the form. A contact can be invited later and then becomes a Member or Guest.
Elsewhere you may see: External user, anonymous submitter
Access Key
A secret a person creates so a program can use the API on their behalf, limited to some actions (reading metrics, submitting values, creating metrics owned by that person, reading dashboards, building dashboards as that person), bound to one Workspace and ending on a set date. Owners can see and revoke every access key in their workspace; Admins can see every key and its Access Log. Not to be confused with a Token, which lets a submitter record values for one metric.
Elsewhere you may see: API token, personal access token, credential
Feed Key
An Access Key that acts for a Feed instead of a person. It can only record values for the metrics that Feed submits to, and see their descriptions and which periods already have a value, never the values themselves or the workspace's people. Owners and Admins create and revoke it.
Elsewhere you may see: Service account, bot token, connector key
MCP Server
The program that lets an AI assistant read a workspace's metrics and submit values through the API, with an access key. It runs on the person's own computer and sees no more than the key does.
Elsewhere you may see: AI integration, plugin
Access Log
The record of every call a program made with an access key: when, what it asked for, and whether it worked. Owners and Admins see it for every key in their workspace, a person for their own keys.
Elsewhere you may see: Audit trail, request log, API history
Demo Mode
A visit to the demo workspace: a made-up company anyone can look around without an account, switching between its made-up people and resetting it. It sits next to real workspaces and never reaches them, and an installation can switch it off.
Elsewhere you may see: Sandbox, test mode
Share
Giving another user or a Group access to a metric or a dashboard. Sharing a dashboard also gives view access to every metric on it.
Elsewhere you may see: Invite, publish
View Link
A link that shows one dashboard or deck to someone outside the team, without logging in and without being able to change or ask anything. It expires on a set date and can be revoked. It shows live numbers; for a deck, numbers frozen when it was made; for a dashboard, one of its Snapshots once shown, which ends the link when it is deleted.
Elsewhere you may see: Public link, guest access, embed
Group
A named set of users, such as Management or Sales, that things are shared with or a Thread is limited to. Whoever joins a group gets what was shared with it. The workspace owner manages groups. Every workspace also has the group Everyone in the workspace: all its members except guests, kept up to date by itself.
Elsewhere you may see: Team, role, department
Viewer
A user a dashboard or metric is shared with who can look at it, inspect history and assign actions, but not change it. Viewer is a role on one shared thing; Guest is a role in the whole Workspace.
Elsewhere you may see: Reader
Editor
A user a dashboard, deck or metric is shared with who can also change it: arrange a dashboard's widgets or a deck's slides, or a metric's targets, description and Sources. Deleting it and sharing it stay with its owner.
Elsewhere you may see: Collaborator, co-owner
Governance
Version
A saved state of something people build (a widget, dashboard, deck, master, metric description or a Snapshot's words) with its author, time and an optional message or name. Edits by one person within ten minutes form one version; restoring a version creates a new one. A Version keeps how something was built; a Snapshot keeps what a dashboard showed.
Elsewhere you may see: Revision, commit, backup
Superseded Value
An earlier value of an observation or breakdown row, kept when an overwrite or correction replaced it, with the time it was replaced.
Elsewhere you may see: Old value, previous version, overwritten value
Audit Log
The record of who changed who may see or do what in a Workspace, and of the decisions taken on numbers: roles, removals, invitations, joining, Shares, Groups, View Links, Access Keys, Locks, Approvals, Corrections, Snapshots taken, shown and deleted, settings, exports and sign-ins. Each event names the person, the kind, the object as it was named then, the time and small details such as the old and new role, never a value or a message. Nothing in it can be changed or removed; it keeps two years. Owners and Admins read and export it. Not the Access Log, which records a program's calls, nor a Version, which keeps what something looked like.
Elsewhere you may see: Audit trail, activity log, event log, history
Collaboration
Action
A question or task about a specific observation or time range of a metric that one user assigns to another. It moves from open to answered to closed, and can be reopened.
Elsewhere you may see: Ticket, request, to-do
Question
An action that is done once the assignee has answered it, e.g. "Why is cost so high this month?"
Elsewhere you may see: Inquiry
Task
An action that is done once the assignee has carried it out, e.g. "Renegotiate the shipping rate", optionally with a due date.
Elsewhere you may see: To-do, job
Assignee
The user an action is assigned to.
Elsewhere you may see: Owner, responsible
Thread
The replies between asker and assignee on an action. Everyone can read it, unless the asker limits it to a Group; the people on it can always read it.
Elsewhere you may see: Conversation, chat, comments
Correction
A change to an observation proposed in an action's thread, which takes effect once the metric owner accepts it.
Elsewhere you may see: Fix, edit, amendment
Delivery
One message Ziffr sends through a Connector to one person: a new question or task, a reminder, a reply, a proposed correction or a closed task. Answers to it come back into the Thread.
Elsewhere you may see: Notification, outbox item, message
Outbox
Every Delivery, newest first, with what it said and where it went. An email or Slack one also shows whether it was really sent, is waiting or failed; the other Connectors only record it.
Elsewhere you may see: Sent items, log
Delivery Preference
Where a person wants to get questions, tasks, reminders and replies. The team sets a default; whoever sends may choose another for one message.
Elsewhere you may see: Notification settings, routing