KPI Plume

Section destinée aux assistants IA (ChatGPT, Claude, Copilot…) : tous les champs, toutes les options du volet Format avec leurs noms internes, le format des données et des exemples DAX. Générée depuis le code du visuel, version 1.4.0.0. Vous pouvez la copier dans votre assistant pour qu'il vous guide.

# KPI Plume: technical reference for AI assistants

> Power BI custom visual by Plume Studio (Plume Visuals). Visual version **1.4.0.0**. This page is generated from the visual's source code at each site build: field names, option names and defaults are exact for this version.

Use it to help someone build a report with KPI Plume: which fields to drag, how to shape the data, which Format pane option to change, or how to write the visual's settings in a PBIP `visual.json` file.

- Product page: https://plumevisuals.com/en/visuals/kpi-card (French: https://plumevisuals.com/fr/visuels/kpi-card)
- Summary: KPI cards that flip: value, comparison, target, trend, icon, and on the back the definition and the figures you choose.
- Power BI visual GUID (`visualType`): `plumeKpiCardC478BD14F72F4580AC1F80652CEB51D7`
- Power BI visuals API: 5.11.1
- Support: https://plumevisuals.com/support · contact@plumevisuals.com
- Index of everything on the site for AI assistants: https://plumevisuals.com/llms.txt

## What the visual does

KPI Plume (formerly Plume KPI) is a Power BI custom visual (base range, version 1.4.0.0, installed from the `.pbiviz` file; AppSource submission in progress) that draws KPI cards: one card per measure, or, with a category field, one card per region / product / team (optionally plus a "Total" card). Cards always fit in the visual with no scroll bar (`layout.overflow` = `fit`, default; `scroll` keeps the minimum sizes and scrolls). Each card shows a title, an icon (134 built-in Lucide icons in 11 themes, chosen per KPI in `kpiFormat.icon` or picked automatically from the measure name: revenue → €, orders → cart, rate → %, customers → people…; or given by a text measure in the Icon field), an optional ↗ link button (`kpiFormat.link`), the value with automatic units per number (1.5M, 171K, 451), a comparison (change in % or value, ▲▼ arrows, badge, "vs …" label, neutral zone, good / bad / neutral colors), a target (a field, or a value typed per KPI in `kpiFormat.targetValue`; progress bar or text; ring and bullet ★), an optional second comparison ★ (Comparison 2 field) and a trend sparkline (line, area, smooth area; columns and step ★) placed at the bottom, in the background or on the right. The signature feature: cards **flip** (on hover, on click, or on the ↻ icon) to show their back: an information text with **bold**, line breaks and placeholders, plus key figures chosen KPI by KPI in the dynamic card "Back of the card: content per KPI" (`backItems`: comparison, change, comparison 2, target, achievement, period, last period, min, max, average, tooltip fields, and up to 8 measures of the "Back of the card: figures" field shown only on the back). At rest a card is drawn flat (no 3D transform) so its text stays sharp; 3D is only used during the flip. Trend-axis dates sent by Power BI Desktop as ISO text are read as dates ("Dec 2025 vs Nov 2025"; `sparkline.dateFormat` overrides the period format). The visual makes no network request.

**New in version 1.4.0.0 (30/10/2026):** Format pane reorganized (`compare` → `comparison`, `trend` → `sparkline`); free native-parity additions: **Title** and **Note** text-measure fields per KPI, **Reference labels** fields and card, accent bar on the right with its own color, KPI title position and italics, distance to target, date of the last period.

## Free vs premium (★)

- Every feature works without a key and nothing is ever blocked. Free features never show a watermark.
- Shared Style card (the same in every Plume visual): the styles `none`, `minimal` and `blackWhite`, the two Plume gradient palettes (`crest`, `crestDiverging`), "Follow report theme" and all custom colors (`style.customColors` and the colors under it) are **free**; every other `style.preset`, the other gradient palettes (`style.palette`) and `style.themeJson` ("Theme JSON ★") are **premium** (watermark without a key). See "Styles and theme JSON" below.
- Using a premium feature without a valid key shows **"Plume Visuals · Premium preview"** (French: « Plume Visuals · Aperçu premium ») in the footer of the visual, with an "Unlock →" link to the pricing page. It disappears once a key is pasted in **Format › Plume Studio License › License key** (`license.key`; French: « Licence Plume Studio › Clé de licence »), the **first card** of the Format pane.
- Premium features of KPI Plume:
  - `card.shape` = `circle`, `leaf`, `chamfer` ("Cut corners ★") or `ticket`;
  - `layout.arrange` = `heroLeft` / `heroTop` ("First one large, on the left / on top ★", size in `layout.heroSize`);
  - `target.style` = `ring` or `bullet`: counts only when a Target field is present and `target.show` is on;
  - `sparkline.type` = `columns` or `step`: counts only with a Trend axis field and `sparkline.show` on;
  - `flip.animation` = `slide`, `door`, `curtain`, `zoom`, `cube`, and `flip.easing` = `bounce`: count only when `flip.trigger` is not `none`;
  - the **Comparison 2** field (`reference2`): counts when it is filled and `comparison.show` and `comparison.show2` are on;
  - `comparison.statusFrom` = `both` ("Target and comparison (green, amber, red) ★").
- Free in 1.3: per-KPI icons, the Icon field, fixed target and field numbers per KPI, the back content per KPI and the "Back of the card: figures" field, the link per card, `layout.hideBlank`, `layout.overflow`, `comparison.statusFrom` = `compare` / `compare2` / `target` (thresholds with `comparison.warnFrom`, amber `comparison.warnColor`).
- Premium options and list values have " ★" appended to their label. Accepted keys: only keys starting with `PLUM1.` shown in the buyer's account on plumevisuals.com, checked offline (Ed25519 signature), covering `kpi-card` or the whole catalog. In edit mode, a wrong key shows "Invalid license key", "License expired (date)" or "This key does not cover this visual".
- Licenses last one year (one-time payment, no automatic renewal, key accepted for 30 more days, reminders 30 and 7 days before the end), for this visual: 39 € personal, 99 € SME, 299 € enterprise per year, or the catalog packs (199 € / 399 € / 1,199 € per year; tiers by number of users, designers and viewers included: personal 1–10, SME 11–200, enterprise more than 200). Version 1.3.2.0, available on plumevisuals.com (`.pbiviz` file); AppSource submission in progress.

## Expected data shape

A **matrix** data view: trend periods on rows, category members on columns, measures in cells, plus the grand total that Power BI computes (hidden `subTotals` object, kept on).

- **Values (one KPI per measure)** (`values`, « Valeurs (un KPI par mesure) », measures, required): one card per measure.
- **Comparison (previous year…)** (`reference`, « Comparaison (année précédente…) », measures): compared with the value **of the same rank** (1st with 1st…), or the field number set per KPI in `kpiFormat.refField` (0 = same rank, -1 = none).
- **Comparison 2 (budget…)** ★ (`reference2`, « Comparaison 2 (budget…) », measures, same rank): second change under the first one (label `kpiFormat.refLabel2`).
- **Target** (`target`, « Objectif », measures): target of the KPI of the same rank, or the field number set in `kpiFormat.targetField`; `kpiFormat.targetValue` (non-zero) types a fixed target for one KPI instead.
- **Trend axis (date)** (`trend`, « Axe de tendance (date) », one column): month, week, year… draws the sparkline (data window of 2,000 periods).
- **One KPI per… (category)** (`category`, « Un KPI par… (catégorie) », one column): repeats the KPIs for each member.
- **Back of the card (text)** (`backText`, « Dos de la carte (texte) », measures): text measure shown on the back of the KPI of the same rank (a definition, a comment).
- **Back of the card: figures** (`backFields`, « Dos de la carte : chiffres », up to 8 measures): label + value rows shown only on the back, with the measure's own format; switched on or off per KPI with `backItems.f1` … `backItems.f8`.
- **Icon (text measure)** (`icon`, « Icône (mesure texte) », measures, same rank): an icon key (`trendUp`) or Lucide name (`trending-up`), an emoji or short symbol, or an inline image `data:image/svg+xml…` (also png, jpeg, gif, webp). Web addresses are never loaded.
- **Tooltips** (`tooltips`, « Infobulles », measures) and **Dynamic format** (`format`, « Format dynamique », measures named `card.setting`).

| Month (`trend`) | Revenue (`values`) | Target (`target`) |
|---|---|---|
| 2025-10-01 | 118 400 | 110 000 |
| 2025-11-01 | 151 900 | 110 000 |
| Total | 1 512 000 | 1 320 000 |

- With a trend axis, `value.aggregate` = `total` (default) shows the **total row computed by Power BI** (exact for rates and averages); if no total is available it falls back to the last period. Other values: `last`, `first`, `avg`, `max`, `min` of the periods.
- `comparison.source` = `auto` uses the Comparison field when filled, otherwise the previous period of the trend axis. With `previous` / `first`, the change compares the **last period** with the previous / first one (label like "Dec 2025 vs Nov 2025"), even when the displayed value is the total.
- Status (`comparison.statusFrom`): `auto` (default) = good / bad from the sign of the change (`kpiFormat.lowerIsBetter` reverses it, `comparison.neutral` = neutral band in %), without a comparison from the target being reached; `compare` / `compare2` = from one change; `target` = good from 100 %, warning (amber) from `comparison.warnFrom` % (default 90), bad below; `both` ★ = good when the target is reached, warning when only a comparison is favorable, bad otherwise. Each change badge keeps the color of its own direction.

## DAX recipes

```dax
Revenue = SUM ( Sales[Amount] )
Orders = COUNTROWS ( Sales )
Average basket = DIVIDE ( [Revenue], [Orders] )
Margin rate = DIVIDE ( SUM ( Sales[Margin] ), [Revenue] )
Target = 110000 * DISTINCTCOUNT ( Sales[Month] )

// Comparison field: needs a marked date table; take the trend axis from that table too
Revenue LY = CALCULATE ( [Revenue], SAMEPERIODLASTYEAR ( 'Calendar'[Date] ) )

// Back of the card (text)
Revenue back = "Top region: " & MAXX ( TOPN ( 1, VALUES ( Sales[Region] ), [Revenue] ), Sales[Region] )
```

Back text placeholders (`kpiFormat.backText`): `{name}`, `{value}`, `{ref}`, `{delta}`, `{deltaPct}`, `{ref2}`, `{delta2}`, `{deltaPct2}`, `{target}`, `{progress}`, `{min}`, `{max}`, `{avg}` are formatted values; `{first}`, `{last}`, `{period}` are period labels. `**…**` = bold; a line break or a literal `\n` = new paragraph. `kpiFormat.note` (note under the value) accepts `{value}`, `{ref}`, `{delta}`, `{target}`, `{progress}`, `{period}`. Back text priority: the text set for that measure, then the Back of the card measure, then the "All KPIs" text. `backItems.textAfter` puts it after the figures; `back.figLayout` (`auto` / `columns` / `stacked`) and `back.fit` (shrink to 75 % before scrolling, no visible scroll bar) keep the back readable.

## Interactions with the report

- With One KPI per…, clicking a card cross-filters the report (`interaction.select`), other cards are dimmed (`interaction.dim`), clicking the background clears. When `flip.trigger` = `click`, a click flips and **Ctrl + click** filters.
- Power BI tooltips on cards (value, comparison, change, target, tooltip fields) when `tooltip.show` is on and `flip.trigger` is not `hover`; per-period tooltip on the sparkline (`tooltip.periodTip`). Context menu on each card.
- Keyboard: Tab to reach the cards, ← → to move, Enter or Space flips, Esc flips back. The back is announced to screen readers. Reduced motion makes flips and the counter instant. High contrast uses host colors. Never flips on a dashboard tile. `flip.preview` shows the back in edit mode to format it.

## Dynamic formats

- **No fx button**: Power BI does not offer conditional formatting of Format pane options to table / matrix visuals (Table Plume, Matrix Plume, KPI Plume). Everything goes through the **Dynamic format** well (role `format`).
- Rename each measure for this visual `card.setting`, e.g. `flip.trigger`, `layout.arrange`, `title.text`, `kpiFormat.backText`. Case, accents and the separator are ignored. It wins over the fixed setting, the style and the JSON theme.
- KPI Plume reads the **grand total** value. Examples: `"Data as of " & FORMAT ( MAX ( Sales[Month] ), "mmmm yyyy" )` renamed `kpiFormat.backText`; `IF ( ISFILTERED ( Sales[Region] ), "none", "click" )` renamed `flip.trigger`.
- For the dynamic card **Per-KPI settings**, only the "All KPIs" level is driven (`kpiFormat.color`, `kpiFormat.backText`…); a value set for one specific measure in the pane stays first.
- Driving a setting with DAX is free; a ★ value set by DAX still shows the watermark without a key.

## Format pane: how to read the tables below

- Each option has an ID `card.option` (for example `flip.trigger`). The card is the capabilities.json **object name**, the option is the **property name**. Note that the visual has a Format card named `card` ("Card"), so its options read `card.shape`, `card.colorBy`…
- Card order: `license` (always first), `style` (shared Style card), `kpiFormat` (dynamic card "Per-KPI settings": a list at the top, "Apply settings to", picks "All KPIs" or one measure), then `layout`, `card`, `kpiTitle`, `value`, `icon`, `comparison`, `target`, `trend`, `flip`, `back`, `backItems` (dynamic card "Back of the card: content per KPI", same "Apply settings to" list, only when `flip.trigger` is not `none`), `interaction`, then `title`, `source`, `container` and `texts`. Format pane in version 1.4.0.0 (30/10/2026), top to bottom: `license`, `style`, `kpiFormat`, `backItems`, `layout`, `card`, `kpiTitle`, `value`, `refLabels`, `icon`, `comparison`, `target`, `sparkline`, `flip`, `back`, `interaction`, `tooltip`, `title`, `source`, `container`, `texts`. Settings moved or renamed in this version keep working in older reports (the old names are still read).
- Labels follow the language of Power BI Desktop; `texts.language` can force French or English inside the visual.
- "Visible when" means the option only appears when another option has one of the listed values (most `flip` options only when `flip.trigger` is not `none`).

## Editing a PBIP report (visual.json)

`visualType` is the visual GUID, `queryState` keys are the data role names, `objects` keys are the option IDs. Literal syntax: booleans `true` / `false`, numbers suffixed with `D`, strings and enumeration values in single quotes (double an apostrophe inside), colors wrapped in `solid.color`. Per-KPI settings are entries of `kpiFormat` with a `selector` on the measure's `queryRef`.

```json
{
  "visualType": "plumeKpiCardC478BD14F72F4580AC1F80652CEB51D7",
  "query": {
    "queryState": {
      "values": { "projections": [
        { "field": { "Measure": { "Expression": { "SourceRef": { "Entity": "Sales" } }, "Property": "Revenue" } }, "queryRef": "Sales.Revenue", "nativeQueryRef": "Revenue" },
        { "field": { "Measure": { "Expression": { "SourceRef": { "Entity": "Sales" } }, "Property": "Margin rate" } }, "queryRef": "Sales.Margin rate", "nativeQueryRef": "Margin rate" } ] },
      "target": { "projections": [
        { "field": { "Measure": { "Expression": { "SourceRef": { "Entity": "Sales" } }, "Property": "Target" } }, "queryRef": "Sales.Target", "nativeQueryRef": "Target" } ] },
      "trend": { "projections": [
        { "field": { "Column": { "Expression": { "SourceRef": { "Entity": "Sales" } }, "Property": "Month" } }, "queryRef": "Sales.Month", "nativeQueryRef": "Month" } ] }
    }
  },
  "objects": {
    "layout":  [ { "properties": { "arrange": { "expr": { "Literal": { "Value": "'row'" } } } } } ],
    "card":    [ { "properties": { "colorBy": { "expr": { "Literal": { "Value": "'status'" } } },
                                   "statusBar": { "expr": { "Literal": { "Value": "'left'" } } } } } ],
    "trend":   [ { "properties": { "type": { "expr": { "Literal": { "Value": "'line'" } } } } } ],
    "flip":    [ { "properties": { "trigger": { "expr": { "Literal": { "Value": "'hover'" } } },
                                   "animation": { "expr": { "Literal": { "Value": "'fade'" } } },
                                   "duration": { "expr": { "Literal": { "Value": "400D" } } } } } ],
    "kpiFormat": [
      { "properties": { "backText": { "expr": { "Literal": { "Value": "'**Revenue** for the period: {value}.\\nBest month: {max}.'" } } },
                        "color": { "solid": { "color": { "expr": { "Literal": { "Value": "'#b8462a'" } } } } } },
        "selector": { "metadata": "Sales.Revenue" } },
      { "properties": { "icon": { "expr": { "Literal": { "Value": "'percent'" } } },
                        "decimals": { "expr": { "Literal": { "Value": "1D" } } } },
        "selector": { "metadata": "Sales.Margin rate" } } ],
    "license": [ { "properties": { "key": { "expr": { "Literal": { "Value": "'PLUM1.…'" } } } } } ]
  }
}
```

The custom visual package must also be embedded in the report (Power BI does this when the visual is imported from the `.pbiviz` file). Do not turn off the hidden `subTotals` properties: the period total comes from them.

## Styles and theme JSON

- `style.preset` takes one of the 20 style IDs shared by every Plume visual: `none`, `minimal`, `blackWhite`, `press`, `vintage`, `earth`, `nordic`, `executive`, `accessible`, `pastel`, `bauhaus`, `climate`, `blueprint`, `unknownPleasures`, `dark`, `neon`, `terminal`, `infographic`, `cockpit`, `hologram`.
- `style.themeJson` (Format › Style › Theme JSON ★) takes a JSON theme as plain text. Format v2: an object with an optional `extends` (a style ID above) and optional groups `colors`, `palettes`, `typography`, `shape`, `table`, `marks`, `effects`; the v1 flat format (`style`, `palette`, `accent`, `background`…) is still read. Every field is optional. Colors are `#RRGGBB` (`#RGB` and `#RRGGBBAA` accepted, opacity ignored). Unknown fields and values outside the allowed lists are ignored, out-of-range numbers are clamped. Invalid JSON shows "Invalid theme JSON: ignored" in edit mode and the visual keeps its look.
- Full field list with allowed values, examples and troubleshooting: tutorial https://plumevisuals.com/ai/tutorials/en/themes-json.md (French: https://plumevisuals.com/ai/tutorials/fr/themes-json.md). The same JSON can be pasted in every Plume visual of a page.
- Priority (the last one wins): visual defaults → `style.preset` → `style.themeJson` → `style.palette` (if not "Style or theme palette") → `style.followTheme` → custom colors → options set by hand in the other cards → DAX formats (fx button, "Dynamic format" field) → Windows high contrast.

## Common pitfalls

- Target or comparison on the wrong card: pairing is by rank; keep the same order in Values, Comparison, Target and Back of the card, or set `kpiFormat.targetField` / `kpiFormat.refField` for that KPI, or type a fixed target (`kpiFormat.targetValue`).
- The change does not match the displayed value: with `comparison.source` = `auto` and no Comparison field, it compares the last two periods of the trend axis. Add a last-year measure.
- `Revenue LY` blank or wrong: time intelligence on a date table, but the trend axis comes from the fact table; take both from the date table.
- A click flips instead of filtering: `flip.trigger` = `click`; use Ctrl + click, or `hover` / `icon` (with `hover`, cards show no Power BI tooltip: the back replaces it).
- Watermark visible: a ★ shape, layout, target style, trend type, animation or easing, a filled Comparison 2 field, the "Target and comparison" status, or a ★ style / palette / Theme JSON, without a valid key.
- Choosing the icon of one card: Per-KPI settings, pick the measure in "Apply settings to", then Icon (the list reads "Theme · Icon").

## Features that do NOT exist (do not suggest them)

An fx button on any option, a needle gauge or speedometer, more than one target per KPI, a third comparison, a forecast on the sparkline, icons or images loaded from a web address (only built-in icons, symbols / emoji, or `data:image/…` from the Icon field), page navigation or drillthrough on click (only the context menu and the ↗ link), drill-down on the trend, a play / animation over time, write-back of targets, dynamic Top N of categories, highlighting from other visuals.

## Data fields (wells)

Internal name = data role name (PBIP `queryState` key). Labels as shown in Power BI (English / French). ★ = premium.

| Internal name | Label (EN) | Label (FR) | Kind | Max fields | Description |
|---|---|---|---|---|---|
| `values` | Values (one KPI per measure) | Valeurs (un KPI par mesure) | measure | several | Each measure is one KPI card. |
| `reference` | Comparison (previous year…) | Comparaison (année précédente…) | measure | several | Compared with the value of the same rank (1st with 1st…). |
| `reference2` | Comparison 2 (budget…) | Comparaison 2 (budget…) | measure | several | Second comparison of the KPI of the same rank, shown under the first one. |
| `target` | Target | Objectif | measure | several | Goal of the KPI of the same rank: progress bar or ring. |
| `trend` | Trend axis (date) | Axe de tendance (date) | column | 1 | Draws the sparkline (month, week, year…). |
| `category` | One KPI per… (category) | Un KPI par… (catégorie) | column | 1 | Repeats the KPIs for each value of the field (region, product…). |
| `backText` | Back of the card (text) | Dos de la carte (texte) | measure | several | Text measure shown on the back of the KPI of the same rank (a definition, a comment…). |
| `backFields` | Back of the card: figures | Dos de la carte : chiffres | measure | several | Measures shown only on the back (label and value). Choose them per KPI in “Back of the card: content per KPI”. |
| `icon` | Icon (text measure) | Icône (mesure texte) | measure | several | Icon name (trending-up, euro…), emoji or SVG image (data:image/svg+xml…) for the KPI of the same rank, for instance per category. |
| `titles` | Title (text measure) | Titre (mesure texte) | measure | several | Title of the KPI of the same rank, computed by DAX (for instance “Sales” & the selected year). Replaces Per-KPI settings › Title. |
| `notes` | Note (text measure) | Note (mesure texte) | measure | several | Note under the value of the KPI of the same rank, computed by DAX. Placeholders such as {delta} are filled. |
| `refLabels` | Reference labels | Libellés de référence | measure | several | Measures shown under the value (label and value), like the reference labels of the native card. |
| `refDetails` | Reference labels: details | Libellés de référence : détails | measure | several | Detail written under the reference label of the same rank (text or number). |
| `tooltips` | Tooltips | Infobulles | measure | several |  |
| `format` | Dynamic format | Format dynamique | measure | several | Measures named card.setting (e.g. title.fontSize): drive any Format option with DAX |

Data view: matrix (like the native matrix visual, subtotals computed by Power BI), rows = `trend`, columns = `category`, 2,000 rows per data window (more fetched automatically); values = `values`, `reference`, `reference2`, `target`, `backText`, `backFields`, `icon`, `titles`, `notes`, `refLabels`, `refDetails`, `tooltips`, `format`.
Capabilities: supportsKeyboardFocus, supportsMultiVisualSelection, supportsLandingPage, supportsEmptyDataView.
Network access: none (no privileges requested, no external request).

## Format pane options (228)

Columns: option ID (`object.property`), labels EN / FR as shown in Power BI, control type, PBIP literal type, default value, allowed values, notes.

### Plume Studio License / Licence Plume Studio (`license`, Format pane)

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `license.buy` | Get a license | Obtenir une licence | info | text | `plumevisuals.com` |  |  |
| `license.key` | License key | Clé de licence | text | text | (empty) |  | Paste the key received after purchase on plumevisuals.com (starts with PLUM1.). Checked offline. |
| `license.showOwner` | Show license holder (edit mode) | Afficher le titulaire (mode édition) | toggle | bool | `true` | true / false |  |

### Style (`style`, Format pane)

**Style**

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `style.preset` | Style | Style | dropdown | enumeration | `none` | `none` None; `minimal` Minimal; `blackWhite` Black & White; `press` Newspaper ★; `vintage` Vintage (antique plate) ★; `earth` Earth ★; `nordic` Nordic ★; `executive` Executive ★; `accessible` Accessible (high legibility) ★; `pastel` Pastel ★; `bauhaus` Bauhaus (pop) ★; `climate` Climate ★; `blueprint` Blueprint ★; `unknownPleasures` Unknown Pleasures ★; `dark` Graphite (dark) ★; `neon` Neon ★; `terminal` Terminal (Matrix) ★; `infographic` Infographic ★; `cockpit` Cockpit (HUD) ★; `hologram` Hologram ★ | Complete look shared by all Plume visuals: colors, three palettes, fonts, frame, table header, marks and effects. Customize colors below. |
| `style.themeJson` | Theme JSON ★ | Thème JSON ★ | textarea | text | (empty) |  | Paste a JSON theme: see the 'JSON themes' tutorial on plumevisuals.com |
| `style.followTheme` | Follow report theme | Suivre le thème du rapport | toggle | bool | `false` | true / false | Text, background, accent and data colors come from the Power BI report theme. |
| `style.reverse` | Reverse gradients | Inverser les dégradés | toggle | bool | `false` | true / false |  |

**Custom colors / Couleurs personnalisées**

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `style.customColors` | Customize colors | Personnaliser les couleurs | toggle | bool | `false` | true / false | Start from the style and pick your own colors. A color left empty keeps the style's color. |
| `style.colorBackground` | Background | Fond | color | fill | (empty) | hex color | Visible when `style.customColors` = `true` |
| `style.colorText` | Text | Texte | color | fill | (empty) | hex color | Visible when `style.customColors` = `true` |
| `style.colorMuted` | Secondary text | Texte secondaire | color | fill | (empty) | hex color | Visible when `style.customColors` = `true` |
| `style.colorGrid` | Lines and grid | Traits et grille | color | fill | (empty) | hex color | Visible when `style.customColors` = `true` |
| `style.colorAccent` | Accent | Accent | color | fill | (empty) | hex color | Visible when `style.customColors` = `true` |
| `style.colorPositive` | Favorable | Favorable | color | fill | (empty) | hex color | Visible when `style.customColors` = `true` |
| `style.colorNegative` | Unfavorable | Défavorable | color | fill | (empty) | hex color | Visible when `style.customColors` = `true` |
| `style.series1` | Series 1 | Série 1 | color | fill | (empty) | hex color | Visible when `style.customColors` = `true` |
| `style.series2` | Series 2 | Série 2 | color | fill | (empty) | hex color | Visible when `style.customColors` = `true` |
| `style.series3` | Series 3 | Série 3 | color | fill | (empty) | hex color | Visible when `style.customColors` = `true` |
| `style.series4` | Series 4 | Série 4 | color | fill | (empty) | hex color | Visible when `style.customColors` = `true` |
| `style.series5` | Series 5 | Série 5 | color | fill | (empty) | hex color | Visible when `style.customColors` = `true` |
| `style.series6` | Series 6 | Série 6 | color | fill | (empty) | hex color | Visible when `style.customColors` = `true` |
| `style.series7` | Series 7 | Série 7 | color | fill | (empty) | hex color | Visible when `style.customColors` = `true` |
| `style.series8` | Series 8 | Série 8 | color | fill | (empty) | hex color | Visible when `style.customColors` = `true` |
| `style.palette` | Gradient palette | Palette du dégradé | dropdown | enumeration | `auto` | `auto` Style or theme palette; `crest` Plume (sequential); `crestDiverging` Plume (diverging); `viridis` Viridis ★; `magma` Magma ★; `inferno` Inferno ★; `cividis` Cividis (colorblind-safe) ★; `warmingStripes` Warming stripes ★; `rdYlBu` Red–Yellow–Blue ★; `brBG` Brown–Teal (drought) ★; `spectral` Spectral ★; `blues` Blues ★; `reds` Reds ★; `grays` Grays ★; `press` Press (ink and paper) ★; `nordic` Nordic ★; `earth` Earth (ochre to umber) ★; `pastel` Pastel ★; `okabeIto` Okabe-Ito (colorblind-safe) ★ | Visible when `style.customColors` = `true`. Gradient from the catalog (Viridis, Magma…). The start, middle and end colors below replace it. |
| `style.scaleLow` | Gradient: start | Dégradé : début | color | fill | (empty) | hex color | Visible when `style.customColors` = `true` |
| `style.scaleMid` | Gradient: middle (diverging) | Dégradé : milieu (écarts) | color | fill | (empty) | hex color | Visible when `style.customColors` = `true` |
| `style.scaleHigh` | Gradient: end | Dégradé : fin | color | fill | (empty) | hex color | Visible when `style.customColors` = `true` |

**Text / Texte**

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `style.fontFamily` | Font | Police | font | formatting | `Segoe UI, wf_segoe-ui_normal, helvetica, arial, sans-serif` |  | Used by every text of the visual (title, axes, labels, cells). |

**Animations**

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `style.animate` | Animations | Animations | toggle | bool | `true` | true / false | Smooth transitions when data changes. Automatically disabled when the system asks to reduce motion. |

### Per-KPI settings / Réglages par KPI (`kpiFormat`, Format pane)

Per-item card: Power BI shows it once per series, category, column or KPI (an "Apply settings to" list where relevant). In PBIP `visual.json`, each entry of `objects.kpiFormat` carries a `selector` (`metadata` = the field's queryRef, or `data` for a category value); an entry without a selector applies to all items.

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `kpiFormat.title` | Title (empty = measure name) | Titre (vide = nom de la mesure) | text | text | (empty) |  |  |
| `kpiFormat.note` | Note under the value | Note sous la valeur | text | text | (empty) |  | Short text such as “Year to date”. Placeholders: {value}, {ref}, {delta}, {target}, {progress}, {period}. |
| `kpiFormat.icon` | Icon | Icône | dropdown | enumeration | `auto` | `auto` Automatic (from the name); `none` None; `euro` Finance · Euro; `dollar` Finance · Dollar; `pound` Finance · Pound sterling; `coins` Finance · Coins; `banknote` Finance · Banknote; `wallet` Finance · Wallet; `piggyBank` Finance · Piggy bank (savings); `creditCard` Finance · Credit card; `receipt` Finance · Receipt; `landmark` Finance · Bank; `handCoins` Finance · Payment; `calculator` Finance · Calculator; `percent` Finance · Percent; `badgePercent` Finance · Discount; `cart` Sales · Cart; `bag` Sales · Shopping bag; `store` Sales · Store; `tag` Sales · Tag (price); `ticket` Sales · Ticket; `handshake` Sales · Handshake (deals); `briefcase` Sales · Briefcase; `gift` Sales · Gift; `megaphone` Sales · Megaphone (marketing); `users` People · People; `user` People · Person; `userPlus` People · New customer; `userCheck` People · Verified customer; `userMinus` People · Lost customer; `contact` People · Contact; `baby` People · Baby; `smile` People · Smile (satisfaction); `frown` People · Frown; `thumbsUp` People · Thumbs up; `messages` People · Messages; `target` Performance · Target; `trendUp` Performance · Rise; `trendDown` Performance · Fall; `bars` Performance · Column chart; `barsH` Performance · Bar chart; `line` Performance · Line chart; `pie` Performance · Pie chart; `gauge` Performance · Gauge; `activity` Performance · Activity; `award` Performance · Award; `trophy` Performance · Trophy; `medal` Performance · Medal; `flag` Performance · Flag (milestone); `rocket` Performance · Rocket (launch); `star` Performance · Star; `zapFast` Performance · Speedometer; `layers` Performance · Layers; `sigma` Performance · Sum; `clock` Time · Clock; `timer` Time · Timer; `hourglass` Time · Hourglass; `calendar` Time · Calendar; `calendarCheck` Time · Calendar check; `calendarDays` Time · Days; `history` Time · History; `truck` Operations · Truck (delivery); `box` Operations · Box (stock); `packageCheck` Operations · Package delivered; `boxes` Operations · Boxes; `warehouse` Operations · Warehouse; `factory` Operations · Factory; `wrench` Operations · Wrench (maintenance); `settings` Operations · Settings; `hardHat` Operations · Hard hat; `forklift` Operations · Forklift; `ship` Operations · Ship; `plane` Operations · Plane; `car` Operations · Car; `route` Operations · Route; `fuel` Operations · Fuel; `clipboard` Operations · Checklist; `check` Status · Check; `checkPlain` Status · Tick; `circleX` Status · Rejected; `alert` Status · Alert; `alertCircle` Status · Warning; `info` Status · Information; `shield` Status · Shield; `shieldCheck` Status · Security; `lock` Status · Lock; `bell` Status · Bell; `bug` Status · Bug; `eye` Status · Eye (views); `leaf` Energy and environment · Leaf; `sprout` Energy and environment · Sprout; `recycle` Energy and environment · Recycle; `bolt` Energy and environment · Bolt (energy); `battery` Energy and environment · Battery; `plug` Energy and environment · Plug; `sun` Energy and environment · Sun; `cloud` Energy and environment · Cloud; `cloudRain` Energy and environment · Rain; `wind` Energy and environment · Wind; `flame` Energy and environment · Flame; `drop` Energy and environment · Drop (water); `waves` Energy and environment · Waves; `thermometer` Energy and environment · Thermometer; `trees` Energy and environment · Trees; `globe` Energy and environment · Globe; `heart` Health and education · Heart; `heartPulse` Health and education · Heart pulse; `stethoscope` Health and education · Stethoscope; `pill` Health and education · Pill; `hospital` Health and education · Hospital; `graduation` Health and education · Graduation; `book` Health and education · Book; `school` Health and education · School; `dumbbell` Health and education · Dumbbell (sport); `utensils` Health and education · Utensils (meals); `coffee` Health and education · Coffee; `phone` Digital · Phone; `mail` Digital · Mail; `message` Digital · Message; `click` Digital · Click; `monitor` Digital · Monitor; `smartphone` Digital · Smartphone; `server` Digital · Server; `database` Digital · Database; `wifi` Digital · Wi-Fi; `download` Digital · Download; `upload` Digital · Upload; `share` Digital · Share; `search` Digital · Search; `link` Digital · Link; `fileText` Digital · Document; `home` Places · House; `building` Places · Building; `mapPin` Places · Location; `map` Places · Map; `hotel` Places · Hotel | Choose “All KPIs” or one measure in “Apply settings to” above, then its icon (134 Lucide icons, by theme). |
| `kpiFormat.symbol` | Or symbol / emoji (replaces the icon) | Ou symbole / emoji (remplace l'icône) | text | text | (empty) |  |  |
| `kpiFormat.color` | KPI color (empty = “Card” card) | Couleur du KPI (vide = carte « Carte ») | color | fill | (empty) | hex color |  |
| `kpiFormat.units` | Display units | Unités d'affichage | dropdown | enumeration | `fit` | `fit` Automatic (full value when it fits); `auto` Abbreviated (K, M, bn); `none` None; `k` Thousands; `m` Millions; `b` Billions | Automatic: the full value with the format of the measure when it fits in the card, otherwise abbreviated (1.5M). |
| `kpiFormat.decimals` | Decimals (-1 = automatic) | Décimales (-1 = automatique) | number | integer | `-1` | -1 to 6 |  |
| `kpiFormat.prefix` | Prefix | Préfixe | text | text | (empty) |  |  |
| `kpiFormat.suffix` | Suffix | Suffixe | text | text | (empty) |  |  |
| `kpiFormat.lowerIsBetter` | Lower is better | Plus bas = mieux | toggle | bool | `false` | true / false | A decrease is shown in the “good” color (costs, delays, incidents…). |
| `kpiFormat.refLabel` | Comparison label | Libellé de la comparaison | text | text | (empty) |  | Empty: “vs” + name of the comparison measure (or of the previous period). |
| `kpiFormat.refLabel2` | Comparison 2 label | Libellé de la comparaison 2 | text | text | (empty) |  | Second comparison (“Comparison 2” field). Empty: “vs” + name of the measure. |
| `kpiFormat.targetValue` | Fixed target (0 = “Target” field) | Objectif fixe (0 = champ « Objectif ») | number | numeric | `0` |  | A target typed here for this KPI, without a measure. It replaces the “Target” field. |
| `kpiFormat.targetField` | “Target” field number (0 = same rank, -1 = none) | N° du champ « Objectif » (0 = même rang, -1 = aucun) | number | integer | `0` | -1 to 30 | By default the 1st target goes with the 1st value, the 2nd with the 2nd… Type 2 to use the 2nd measure of “Target” for this KPI. |
| `kpiFormat.refField` | “Comparison” field number (0 = same rank, -1 = none) | N° du champ « Comparaison » (0 = même rang, -1 = aucun) | number | integer | `0` | -1 to 30 |  |
| `kpiFormat.link` | Link (web address) | Lien (adresse web) | text | text | (empty) |  | Adds a ↗ button to the card that opens this address (https:// or mailto: only; Power BI opens secure links only). Power BI asks for confirmation. |
| `kpiFormat.backText` | Back of the card text | Texte du dos de la carte | textarea | text | (empty) |  | Shown when the card flips (a definition, for instance). **bold**, line breaks and placeholders: {name}, {value}, {ref}, {delta}, {deltaPct}, {ref2}, {delta2}, {deltaPct2}, {target}, {progress}, {min}, {max}, {avg}, {first}, {last}, {period}. |

### Back of the card: content per KPI / Dos de la carte : contenu par KPI (`backItems`, Format pane)

Per-item card: Power BI shows it once per series, category, column or KPI (an "Apply settings to" list where relevant). In PBIP `visual.json`, each entry of `objects.backItems` carries a `selector` (`metadata` = the field's queryRef, or `data` for a category value); an entry without a selector applies to all items.

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `backItems.text` | Text (Per-KPI settings or “Back of the card” field) | Texte (Réglages par KPI ou champ « Dos de la carte ») | toggle | bool | `true` | true / false |  |
| `backItems.textAfter` | Text after the figures | Texte après les chiffres | toggle | bool | `false` | true / false |  |
| `backItems.ref` | Comparison value | Valeur de comparaison | toggle | bool | `true` | true / false |  |
| `backItems.delta` | Change | Écart | toggle | bool | `true` | true / false |  |
| `backItems.ref2` | Comparison 2 and change | Comparaison 2 et écart | toggle | bool | `true` | true / false |  |
| `backItems.target` | Target | Objectif | toggle | bool | `true` | true / false |  |
| `backItems.progress` | Target achievement | Atteinte de l'objectif | toggle | bool | `true` | true / false |  |
| `backItems.period` | Period | Période | toggle | bool | `true` | true / false |  |
| `backItems.last` | Last period | Dernière période | toggle | bool | `true` | true / false |  |
| `backItems.min` | Minimum | Minimum | toggle | bool | `true` | true / false |  |
| `backItems.max` | Maximum | Maximum | toggle | bool | `true` | true / false |  |
| `backItems.avg` | Average | Moyenne | toggle | bool | `true` | true / false |  |
| `backItems.tooltips` | “Tooltips” fields | Champs « Infobulles » | toggle | bool | `true` | true / false |  |
| `backItems.f1` | Back figure 1 | Chiffre 1 du dos | toggle | bool | `true` | true / false |  |
| `backItems.f2` | Back figure 2 | Chiffre 2 du dos | toggle | bool | `true` | true / false |  |
| `backItems.f3` | Back figure 3 | Chiffre 3 du dos | toggle | bool | `true` | true / false |  |
| `backItems.f4` | Back figure 4 | Chiffre 4 du dos | toggle | bool | `true` | true / false |  |
| `backItems.f5` | Back figure 5 | Chiffre 5 du dos | toggle | bool | `true` | true / false |  |
| `backItems.f6` | Back figure 6 | Chiffre 6 du dos | toggle | bool | `true` | true / false |  |
| `backItems.f7` | Back figure 7 | Chiffre 7 du dos | toggle | bool | `true` | true / false |  |
| `backItems.f8` | Back figure 8 | Chiffre 8 du dos | toggle | bool | `true` | true / false |  |

### Layout / Disposition (`layout`, Format pane)

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `layout.arrange` | Arrangement | Agencement | dropdown | enumeration | `auto` | `auto` Automatic grid; `row` One row; `column` One column; `grid` Grid (number of columns); `heroLeft` First one large, on the left ★; `heroTop` First one large, on top ★ | Automatic: the number of columns that gives the best card proportions. |
| `layout.columns` | Number of columns | Nombre de colonnes | number | integer | `3` | 1 to 12 | Visible when `layout.arrange` = `grid` |
| `layout.heroSize` | First KPI size (%) | Taille du premier KPI (%) | number | integer | `45` | 20 to 80 | Visible when `layout.arrange` = `heroLeft` or `heroTop` |
| `layout.gap` | Gap between cards | Espace entre les cartes | number | integer | `12` | 0 to 60 |  |
| `layout.overflow` | When the cards do not fit | Quand les cartes ne tiennent pas | dropdown | enumeration | `fit` | `fit` Shrink them (never a scroll bar); `scroll` Keep the minimum sizes and scroll | Shrink: every card stays visible, the minimum sizes only choose the number of columns. |
| `layout.minWidth` | Minimum card width (px) | Largeur minimale d'une carte (px) | number | integer | `150` | 60 to 800 | Below this size, the cards wrap (and scroll if “Keep the minimum sizes” is chosen). |
| `layout.minHeight` | Minimum card height (px) | Hauteur minimale d'une carte (px) | number | integer | `96` | 40 to 600 |  |
| `layout.lastRow` | Incomplete last row | Dernière ligne incomplète | dropdown | enumeration | `left` | `left` Aligned left; `center` Centered; `stretch` Stretched |  |
| `layout.order` | KPI order | Ordre des KPI | dropdown | enumeration | `data` | `data` Field order; `valueDesc` Value, descending; `valueAsc` Value, ascending; `deltaDesc` Best change first; `nameAsc` Name A → Z |  |
| `layout.hideBlank` | Hide blank KPIs | Masquer les KPI vides | toggle | bool | `false` | true / false | A card whose value is blank is not drawn (for instance a region without sales). |
| `layout.totalCard` | “Total” card (with “One KPI per…”) | Carte « Total » (avec « Un KPI par… ») | toggle | bool | `false` | true / false | Adds a card with the total over all categories, first. |
| `layout.totalLabel` | Total label | Libellé du total | text | text | (empty) |  | Visible when `layout.totalCard` = `true` |

### Card / Carte (`card`, Format pane)

**Shape / Forme**

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `card.shape` | Shape | Forme | dropdown | enumeration | `rounded` | `rect` Rectangle; `rounded` Rounded corners (Frame › Rounded corners); `pill` Pill; `circle` Circle ★; `leaf` Leaf (two rounded corners) ★; `chamfer` Cut corners ★; `ticket` Ticket (notches) ★; `underline` Underlined (no fill); `none` None (text only) |  |
| `card.fill` | Fill (empty = automatic) | Fond (vide = automatique) | color | fill | (empty) | hex color | Automatic: the style background, slightly raised on dark backgrounds. |
| `card.fillOpacity` | Fill opacity (%) | Opacité du fond (%) | number | integer | `100` | 0 to 100 |  |
| `card.tint` | KPI color tint in the fill (%) | Teinte de la couleur du KPI dans le fond (%) | number | integer | `0` | 0 to 40 |  |
| `card.border` | Border | Bordure | toggle | bool | `true` | true / false |  |
| `card.borderColor` | Color (empty = lines) | Couleur (vide = traits) | color | fill | (empty) | hex color | Visible when `card.border` = `true` |
| `card.borderWidth` | Width | Épaisseur | number | numeric | `1` | 0.5 to 6 | Visible when `card.border` = `true` |
| `card.shadow` | Soft shadow | Ombre douce | toggle | bool | `false` | true / false |  |

**Colors and status / Couleurs et état**

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `card.colorBy` | KPI color | Couleur des KPI | dropdown | enumeration | `accent` | `accent` Style accent (same for all); `palette` One color per KPI (palette); `status` By status (good / bad) | Used by the icon, the sparkline and the status bar. |
| `card.statusBar` | Accent bar (status) | Barre d'accent (état) | dropdown | enumeration | `none` | `none` None; `left` Left; `top` Top; `right` Right; `bottom` Bottom | Colored by the status of the card (good, warning, bad), otherwise the KPI color. |
| `card.statusWidth` | Accent bar width | Épaisseur de la barre d'accent | number | integer | `4` | 1 to 16 | Visible when `card.statusBar` = `left` or `top` or `right` or `bottom` |
| `card.accentColor` | Bar color (empty = status or KPI) | Couleur de la barre (vide = état ou KPI) | color | fill | (empty) | hex color | Visible when `card.statusBar` = `left` or `top` or `right` or `bottom` |

**Content / Contenu**

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `card.layout` | Content layout | Disposition du contenu | dropdown | enumeration | `stack` | `stack` Stacked (title, value, details); `center` Centered; `split` Value left, trend right |  |
| `card.align` | Alignment | Alignement | dropdown | enumeration | `left` | `left` Left; `center` Center; `right` Right | Visible when `card.layout` = `stack` or `split` |
| `card.vAlign` | Vertical position | Position verticale | dropdown | enumeration | `top` | `top` Top; `middle` Middle; `bottom` Bottom |  |
| `card.padding` | Inner padding | Marge intérieure | number | integer | `14` | 0 to 48 |  |
| `card.hover` | Hover effect | Effet au survol | dropdown | enumeration | `lift` | `none` None; `lift` Lift; `outline` Accent outline; `glow` Glow |  |

### KPI titles / Titre des KPI (`kpiTitle`, Format pane)

The card header toggle is `kpiTitle.show`.

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `kpiTitle.show` | Show | Afficher | toggle | bool | `true` | true / false |  |
| `kpiTitle.fontSize` | Size | Taille | number | formatting | `12` | 7 to 32 |  |
| `kpiTitle.color` | Color (empty = secondary text) | Couleur (vide = texte secondaire) | color | fill | (empty) | hex color |  |
| `kpiTitle.bold` | Bold | Gras | toggle | bool | `false` | true / false |  |
| `kpiTitle.italic` | Italic | Italique | toggle | bool | `false` | true / false |  |
| `kpiTitle.caps` | Small caps | Petites majuscules | toggle | bool | `false` | true / false |  |
| `kpiTitle.wrap` | Text wrap | Retour automatique à la ligne | toggle | bool | `true` | true / false | On a narrow card the title wraps (up to three lines) and gets slightly smaller before being cut. |
| `kpiTitle.position` | Position | Position | dropdown | enumeration | `above` | `above` Above the value; `below` Below the value | Below the value: like the category label of the native card. |

### Value / Valeur (`value`, Format pane)

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `value.autoSize` | Automatic size | Taille automatique | toggle | bool | `true` | true / false | The value fills the room left in the card, up to the maximum size. |
| `value.fontSize` | Size (maximum if automatic) | Taille (maximale si automatique) | number | formatting | `36` | 10 to 160 |  |
| `value.weight` | Weight | Graisse | dropdown | enumeration | `600` | `400` Regular; `600` Semibold; `700` Bold |  |
| `value.color` | Color (empty = text) | Couleur (vide = texte) | color | fill | (empty) | hex color |  |
| `value.statusColor` | Color by status (good / bad) | Couleur selon l'état (bon / mauvais) | toggle | bool | `false` | true / false |  |
| `value.aggregate` | Displayed value (with a trend axis) | Valeur affichée (avec un axe de tendance) | dropdown | enumeration | `total` | `total` Period total (computed by the measure); `last` Last period; `first` First period; `avg` Average of the periods; `max` Maximum; `min` Minimum | Total: the measure evaluated over the whole filter context (exact for ratios and averages). |
| `value.countUp` | Animated counter | Compteur animé | toggle | bool | `true` | true / false | The value counts up when data changes (respects Style › Animations). |
| `value.blank` | Text when blank | Texte si vide | text | text | (empty) |  |  |

### Reference labels / Libellés de référence (`refLabels`, Format pane)

The card header toggle is `refLabels.show`.

**Content / Contenu**

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `refLabels.show` | Show | Afficher | toggle | bool | `true` | true / false | Shown when measures are placed in “Reference labels” (label = measure name, value with its format; “Details” under it). |
| `refLabels.pairing` | KPIs concerned | KPI concernés | dropdown | enumeration | `all` | `all` Every label on each KPI; `rank` By rank (1st label with the 1st KPI…) |  |
| `refLabels.max` | Maximum per card | Nombre maximal par carte | number | integer | `3` | 1 to 8 |  |

**Layout / Disposition**

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `refLabels.position` | Position | Position | dropdown | enumeration | `below` | `below` Below the value; `bottom` Bottom of the card |  |
| `refLabels.arrange` | Arrangement | Agencement | dropdown | enumeration | `row` | `row` Side by side; `column` Stacked |  |
| `refLabels.divider` | Divider | Séparateur | toggle | bool | `true` | true / false |  |
| `refLabels.background` | Background | Arrière-plan | toggle | bool | `false` | true / false |  |
| `refLabels.bgColor` | Background color (empty = KPI tint) | Couleur de l'arrière-plan (vide = teinte du KPI) | color | fill | (empty) | hex color | Visible when `refLabels.background` = `true` |

**Text / Texte**

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `refLabels.titleSize` | Label size | Taille du libellé | number | formatting | `10` | 7 to 24 |  |
| `refLabels.titleColor` | Label color (empty = secondary text) | Couleur du libellé (vide = texte secondaire) | color | fill | (empty) | hex color |  |
| `refLabels.valueSize` | Value size | Taille de la valeur | number | formatting | `13` | 7 to 32 |  |
| `refLabels.valueColor` | Value color (empty = text) | Couleur de la valeur (vide = texte) | color | fill | (empty) | hex color |  |
| `refLabels.detailSize` | Details size | Taille des détails | number | formatting | `10` | 7 to 24 |  |

### Icon / Icône (`icon`, Format pane)

The card header toggle is `icon.show`.

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `icon.show` | Show | Afficher | toggle | bool | `true` | true / false | The icon of each KPI is chosen in Per-KPI settings › Icon, or by a text measure in the “Icon” field. |
| `icon.position` | Position | Position | dropdown | enumeration | `topRight` | `topRight` Top right; `topLeft` Before the title; `left` Left of the value; `above` Above (centered); `background` Watermark |  |
| `icon.style` | Icon background | Fond de l'icône | dropdown | enumeration | `circle` | `plain` None; `circle` Round badge; `square` Square badge; `ring` Ring; `solid` Solid badge |  |
| `icon.size` | Size | Taille | number | integer | `30` | 12 to 96 |  |
| `icon.color` | Color (empty = KPI color) | Couleur (vide = couleur du KPI) | color | fill | (empty) | hex color |  |

### Comparison / Comparaison (`comparison`, Format pane)

The card header toggle is `comparison.show`.

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `comparison.show` | Show | Afficher | toggle | bool | `true` | true / false |  |
| `comparison.source` | Compare with | Comparer à | dropdown | enumeration | `auto` | `auto` Automatic; `reference` “Comparison” field; `previous` Previous period (trend axis); `first` First period (trend axis) | Automatic: the “Comparison” field if present, otherwise the previous period of the trend axis. |
| `comparison.mode` | Display | Afficher | dropdown | enumeration | `pct` | `pct` Change in %; `abs` Change in value; `both` Change in value and %; `ref` Comparison value |  |
| `comparison.arrow` | Arrow | Flèche | dropdown | enumeration | `triangle` | `triangle` ▲ ▼; `arrow` ↑ ↓; `chevron` ⌃ ⌄; `none` None |  |
| `comparison.badge` | As a badge | En pastille | toggle | bool | `true` | true / false |  |
| `comparison.showLabel` | Label (“vs …”) | Libellé (« vs … ») | toggle | bool | `true` | true / false |  |
| `comparison.fontSize` | Size | Taille | number | formatting | `12` | 7 to 30 |  |
| `comparison.neutral` | Neutral zone (± %) | Zone neutre (± %) | number | numeric | `0` | 0 to 50 | A change smaller than this percentage is shown in the neutral color. |
| `comparison.show2` | Comparison 2 (“Comparison 2” field) | Comparaison 2 (champ « Comparaison 2 ») | toggle | bool | `true` | true / false | A second change under the first one, for instance vs budget and vs last year. |
| `comparison.statusFrom` | Card status (good, warning, bad) | État de la carte (bon, alerte, mauvais) | dropdown | enumeration | `auto` | `auto` Automatic (comparison, otherwise target); `compare` Comparison; `compare2` Comparison 2; `target` Target (thresholds); `both` Target and comparison (green, amber, red) ★ | Colors the status bar, the value and the cards “by status”. Target and comparison: good when the target is reached, warning when only the comparison is favorable, bad otherwise. |
| `comparison.warnFrom` | Warning from (% of target) | Alerte à partir de (% de l'objectif) | number | integer | `90` | 0 to 100 | Visible when `comparison.statusFrom` = `target`. With “Target”: good from 100 %, warning from this percentage, bad below. 0 = no warning level. |
| `comparison.goodColor` | “Good” color | Couleur « bon » | color | fill | `#2E7D4F` | hex color |  |
| `comparison.warnColor` | “Warning” color | Couleur « alerte » | color | fill | `#C77C02` | hex color | Visible when `comparison.statusFrom` = `target` or `both` |
| `comparison.badColor` | “Bad” color | Couleur « mauvais » | color | fill | `#C0392B` | hex color |  |
| `comparison.neutralColor` | Neutral color (empty = secondary text) | Couleur neutre (vide = texte secondaire) | color | fill | (empty) | hex color |  |

### Target / Objectif (`target`, Format pane)

The card header toggle is `target.show`.

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `target.show` | Show | Afficher | toggle | bool | `true` | true / false | Drawn when a field is placed in “Target”. |
| `target.style` | Shape | Forme | dropdown | enumeration | `bar` | `bar` Progress bar; `ring` Ring ★; `bullet` Bullet (bar and marker) ★; `text` Text only |  |
| `target.thickness` | Thickness | Épaisseur | number | integer | `6` | 2 to 24 |  |
| `target.showPct` | Percentage reached | Pourcentage atteint | toggle | bool | `true` | true / false |  |
| `target.label` | Label | Libellé | text | text | (empty) |  |  |
| `target.distance` | Distance to target | Distance à l'objectif | dropdown | enumeration | `none` | `none` Hidden; `pct` In %; `abs` As a value; `both` Value and % | Like the native KPI: “▲ +5.2% vs Target”, colored good / bad (“Lower is better” respected). |
| `target.color` | Color (empty = KPI color, “good” when reached) | Couleur (vide = couleur du KPI, « bon » si atteint) | color | fill | (empty) | hex color |  |
| `target.trackColor` | Track color (empty = grid) | Couleur du rail (vide = grille) | color | fill | (empty) | hex color |  |

### Sparkline / Courbe de tendance (`sparkline`, Format pane)

The card header toggle is `sparkline.show`.

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `sparkline.show` | Show | Afficher | toggle | bool | `true` | true / false | Drawn when a field is placed in “Trend axis”. |
| `sparkline.dateFormat` | Period format (empty = automatic) | Format des périodes (vide = automatique) | text | text | (empty) |  | Dates of the trend axis in the comparison label, the back and the tooltips. Automatic: month and year for monthly dates (Dec 2025), the year for yearly dates. Examples: mmm yy, dd/mm/yyyy. |
| `sparkline.type` | Type | Type | dropdown | enumeration | `area` | `line` Line; `area` Area; `smooth` Smooth area; `columns` Columns ★; `step` Step ★ |  |
| `sparkline.position` | Position | Position | dropdown | enumeration | `bottom` | `bottom` Bottom of the card; `background` Card background; `right` Right |  |
| `sparkline.height` | Height (% of the card) | Hauteur (% de la carte) | number | integer | `32` | 10 to 70 |  |
| `sparkline.color` | Color (empty = KPI color) | Couleur (vide = couleur du KPI) | color | fill | (empty) | hex color |  |
| `sparkline.width` | Line width | Épaisseur du trait | number | numeric | `1.5` | 0.5 to 5 |  |
| `sparkline.opacity` | Area opacity (%) | Opacité de l'aire (%) | number | integer | `22` | 0 to 100 |  |
| `sparkline.lastDot` | Dot on the last value | Point sur la dernière valeur | toggle | bool | `true` | true / false |  |
| `sparkline.minMax` | Minimum and maximum markers | Repères minimum et maximum | toggle | bool | `false` | true / false |  |
| `sparkline.refLine` | Target line | Ligne de l'objectif | toggle | bool | `false` | true / false | Horizontal line at the target value (per period: target ÷ number of periods when “Displayed value” is the total). |
| `sparkline.zero` | Start at zero | Partir de zéro | toggle | bool | `false` | true / false |  |
| `sparkline.showDate` | Date of the last period | Date de la dernière période | toggle | bool | `false` | true / false | Writes the last period of the trend axis under the value (like the “Date” option of the native KPI). |

### Flip / Retournement (`flip`, Format pane)

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `flip.trigger` | Flip the card | Retourner la carte | dropdown | enumeration | `click` | `none` Never; `hover` On hover; `click` On click; `icon` On click on the ↻ icon | The back shows the information text (Per-KPI settings or “Back of the card” field) and key figures (card “Back of the card: content per KPI”). Keyboard: Enter. |
| `flip.animation` | Animation | Animation | dropdown | enumeration | `flipX` | `flipX` Horizontal flip; `flipY` Vertical flip; `fade` Fade; `slide` Sliding panel ★; `door` Door (swing) ★; `curtain` Curtain ★; `zoom` Zoom ★; `cube` Cube ★ | Visible when `flip.trigger` = `hover` or `click` or `icon` |
| `flip.direction` | Direction | Sens | dropdown | enumeration | `left` | `left` To the left; `right` To the right; `up` Upwards; `down` Downwards | Visible when `flip.trigger` = `hover` or `click` or `icon` |
| `flip.duration` | Duration (ms) | Durée (ms) | number | integer | `600` | 100 to 3000 | Visible when `flip.trigger` = `hover` or `click` or `icon` |
| `flip.easing` | Motion | Mouvement | dropdown | enumeration | `smooth` | `smooth` Smooth; `easeInOut` Ease in and out; `linear` Linear; `bounce` Bounce ★ | Visible when `flip.trigger` = `hover` or `click` or `icon` |
| `flip.autoBack` | Flip back after (s, 0 = never) | Revenir seule après (s, 0 = jamais) | number | integer | `0` | 0 to 120 | Visible when `flip.trigger` = `click` or `icon` |
| `flip.single` | One flipped card at a time | Une seule carte retournée à la fois | toggle | bool | `true` | true / false | Visible when `flip.trigger` = `click` or `icon` |
| `flip.hint` | ↻ indicator on the cards | Indicateur ↻ sur les cartes | toggle | bool | `true` | true / false | Visible when `flip.trigger` = `hover` or `click` or `icon` |
| `flip.preview` | Show the back (preview in edit mode) | Montrer le dos (aperçu en mode édition) | toggle | bool | `false` | true / false | Visible when `flip.trigger` = `hover` or `click` or `icon`. Shows every back while you format them. Ignored in reading view. |

### Back of the card / Dos de la carte (`back`, Format pane)

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `back.content` | Content | Contenu | dropdown | enumeration | `both` | `both` Text and key figures; `text` Text only (figures if no text); `figures` Key figures only |  |
| `back.figures` | Key figures | Chiffres clés | dropdown | enumeration | `all` | `all` All available; `compare` Comparison and target; `trend` Trend (min, max, average) | Visible when `back.content` = `both` or `figures` |
| `back.figLayout` | Figures layout | Disposition des chiffres | dropdown | enumeration | `auto` | `auto` Automatic (two columns, stacked when the card is narrow); `columns` Label left, value right; `stacked` Value under the label | Visible when `back.content` = `both` or `figures` |
| `back.fit` | Shrink the text to fit | Réduire le texte pour tout afficher | toggle | bool | `true` | true / false | The text gets smaller (down to 75 %) before the back scrolls. |
| `back.showTitle` | Repeat the title | Rappeler le titre | toggle | bool | `true` | true / false |  |
| `back.fontSize` | Text size | Taille du texte | number | formatting | `12` | 7 to 32 |  |
| `back.align` | Alignment | Alignement | dropdown | enumeration | `left` | `left` Left; `center` Center |  |
| `back.fill` | Fill (empty = KPI tint) | Fond (vide = teinte du KPI) | color | fill | (empty) | hex color |  |
| `back.solid` | Solid KPI color fill | Fond plein à la couleur du KPI | toggle | bool | `false` | true / false | Text in white or black for contrast. |
| `back.textColor` | Text color (empty = automatic) | Couleur du texte (vide = automatique) | color | fill | (empty) | hex color |  |

### Interactions (`interaction`, Format pane)

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `interaction.select` | Click = filter the report (with “One KPI per…”) | Clic = filtrer le rapport (avec « Un KPI par… ») | toggle | bool | `true` | true / false | With “Flip on click”, use Ctrl + click to select. |
| `interaction.dim` | Opacity of unselected cards (%) | Opacité des cartes non sélectionnées (%) | number | integer | `35` | 5 to 90 |  |

### Tooltips / Infobulles (`tooltip`, Format pane)

The card header toggle is `tooltip.show`.

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `tooltip.show` | Show | Afficher | toggle | bool | `true` | true / false | Tooltip on hover (with the fields of the "Tooltips" well and report page tooltips). Not on a card that flips on hover (the back gives the details). |
| `tooltip.periodTip` | Tooltip per period on the sparkline | Infobulle par période sur la courbe | toggle | bool | `true` | true / false | Visible when `tooltip.show` = `true` |

### Title / Titre (`title`, Format pane)

The card header toggle is `title.show`.

**Title / Titre**

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `title.show` | Show | Afficher | toggle | bool | `true` | true / false |  |
| `title.text` | Text | Texte | text | text | (empty) |  | Leave empty for an automatic title built from the fields. |
| `title.fontSize` | Size | Taille | number | formatting | `14` | 7 to 40 |  |
| `title.bold` | Bold | Gras | toggle | bool | `true` | true / false |  |
| `title.italic` | Italic | Italique | toggle | bool | `false` | true / false |  |
| `title.underline` | Underline | Souligné | toggle | bool | `false` | true / false |  |
| `title.color` | Color (empty = text) | Couleur (vide = texte) | color | fill | (empty) | hex color |  |
| `title.bgColor` | Background color | Couleur d'arrière-plan | color | fill | (empty) | hex color |  |
| `title.align` | Horizontal alignment | Alignement horizontal | dropdown | enumeration | `left` | `left` Left; `center` Center; `right` Right |  |
| `title.wrap` | Text wrap | Retour automatique à la ligne | toggle | bool | `true` | true / false |  |

**Subtitle / Sous-titre**

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `title.subtitle` | Subtitle | Sous-titre | text | text | (empty) |  | Several lines allowed: type \n to go to the next line. |
| `title.subFontSize` | Size | Taille | number | formatting | `11` | 7 to 30 | Visible when `title.subtitle` =  |
| `title.subColor` | Color (empty = secondary text) | Couleur (vide = texte secondaire) | color | fill | (empty) | hex color | Visible when `title.subtitle` =  |
| `title.subItalic` | Italic | Italique | toggle | bool | `false` | true / false | Visible when `title.subtitle` =  |

**Divider / Séparateur**

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `title.divider` | Show divider | Afficher le séparateur | toggle | bool | `false` | true / false |  |
| `title.dividerColor` | Color (empty = lines) | Couleur (vide = traits) | color | fill | (empty) | hex color | Visible when `title.divider` = `true` |
| `title.dividerStyle` | Line style | Style de trait | dropdown | enumeration | `solid` | `solid` Solid; `dashed` Dashed; `dotted` Dotted | Visible when `title.divider` = `true` |
| `title.dividerWidth` | Width | Épaisseur | number | integer | `1` | 1 to 6 | Visible when `title.divider` = `true` |

**Spacing / Espacement**

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `title.spaceBelow` | Space below the title (px) | Espace sous le titre (px) | number | integer | `4` | 0 to 40 |  |

### Source note / Note de source (`source`, Format pane)

The card header toggle is `source.show`.

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `source.show` | Show | Afficher | toggle | bool | `false` | true / false |  |
| `source.text` | Text | Texte | text | text | (empty) |  |  |
| `source.fontSize` | Size | Taille | number | formatting | `9` | 6 to 20 |  |
| `source.italic` | Italic | Italique | toggle | bool | `false` | true / false |  |
| `source.color` | Color (empty = secondary text) | Couleur (vide = texte secondaire) | color | fill | (empty) | hex color |  |
| `source.align` | Alignment | Alignement | dropdown | enumeration | `left` | `left` Left; `center` Center; `right` Right |  |

### Frame / Cadre (`container`, Format pane)

**Background / Arrière-plan**

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `container.bgShow` | Background | Arrière-plan | toggle | bool | `false` | true / false |  |
| `container.bgColor` | Color | Couleur | color | fill | `#FFFFFF` | hex color | Visible when `container.bgShow` = `true` |
| `container.bgColor2` | Gradient end (optional) | Fin du dégradé (optionnel) | color | fill | (empty) | hex color | Visible when `container.bgShow` = `true` |
| `container.bgTransparency` | Transparency (%) | Transparence (%) | slider | numeric | `0` | 0 to 100 | Visible when `container.bgShow` = `true` |

**Border / Bordure**

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `container.border` | Border | Bordure | toggle | bool | `false` | true / false |  |
| `container.borderColor` | Color (empty = lines) | Couleur (vide = traits) | color | fill | (empty) | hex color | Visible when `container.border` = `true` |
| `container.borderWidth` | Width | Épaisseur | number | integer | `1` | 0 to 6 | Visible when `container.border` = `true` |
| `container.radius` | Rounded corners | Coins arrondis | number | integer | `8` | 0 to 24 |  |

**Shadow / Ombre**

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `container.shadow` | Shadow | Ombre | toggle | bool | `false` | true / false |  |
| `container.shadowColor` | Color (empty = soft) | Couleur (vide = douce) | color | fill | (empty) | hex color | Visible when `container.shadow` = `true` |
| `container.shadowSize` | Blur (px) | Flou (px) | number | integer | `12` | 0 to 40 | Visible when `container.shadow` = `true` |

**Spacing / Marges**

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `container.padding` | Inner padding | Marge intérieure | number | integer | `8` | 0 to 40 |  |

### Language and numbers / Langue et nombres (`texts`, Format pane)

| Option ID | Label (EN) | Label (FR) | Control | Type | Default | Allowed values | Notes |
|---|---|---|---|---|---|---|---|
| `texts.language` | Interface language | Langue de l'interface | dropdown | enumeration | `auto` | `auto` Same as Power BI; `fr` French; `en` English |  |
| `texts.numberLocale` | Number format locale (e.g. en-GB) | Format des nombres (ex. fr-FR) | text | text | (empty) |  | Thousands and decimal separators. Empty: same as Power BI. |

### Other objects (not in the Format pane cards above)

- `subTotals`: `subTotals.rowSubtotals` (bool), `subTotals.perRowLevel` (bool), `subTotals.columnSubtotals` (bool), `subTotals.perColumnLevel` (bool), `subTotals.levelSubtotalEnabled` (bool), `subTotals.rowSubtotalsType` (enumeration), read by Power BI itself to compute the subtotals sent to the visual (not shown in the Format pane).
- `compare`: `compare.show` (bool), `compare.source` (enumeration), `compare.mode` (enumeration), `compare.arrow` (enumeration), `compare.badge` (bool), `compare.showLabel` (bool), `compare.fontSize` (formatting), `compare.neutral` (numeric), `compare.show2` (bool), `compare.statusFrom` (enumeration), `compare.warnFrom` (integer), `compare.goodColor` (fill), `compare.warnColor` (fill), `compare.badColor` (fill), `compare.neutralColor` (fill).
- `trend`: `trend.show` (bool), `trend.dateFormat` (text), `trend.type` (enumeration), `trend.position` (enumeration), `trend.height` (integer), `trend.color` (fill), `trend.width` (numeric), `trend.opacity` (integer), `trend.lastDot` (bool), `trend.minMax` (bool), `trend.refLine` (bool), `trend.zero` (bool), `trend.hoverTip` (bool).