# Candle Plume: every field and setting explained

> Every field well and every Format pane setting of Candle Plume: what it does, its possible values and its default value.

- Language: English
- Web page: https://plumevisuals.com/en/tutorials/candle-plume-champs-et-reglages
- Published: 2026-10-19
- Visual: Candle Plume, technical reference: https://plumevisuals.com/ai/visuals/candle-chart.md
- If an option name in this tutorial differs from the technical reference, the reference is right (it is generated from the visual's code).

This page describes everything Candle Plume offers: the field wells, then each card of the Format pane, in the order they appear. The default value of each setting is in **bold**, premium features carry a ★. For a guided first visual, see [getting started](/en/tutorials/candle-plume-prise-en-main).

## Fields of the visual

| Field | Required? | How many | What goes in | What it does | Example |
|---|---|---|---|---|---|
| Date / time | Yes | 1 | A date or date-and-time column | One source bar per row | `Prices[Date]` |
| Symbol (series) | No | 1 | A text column | One button per stock; comparison in % ★ | `Prices[Symbol]` |
| Open, High, Low, Close | Yes, unless Price is used | 1 each | Measures | The four prices of the candle | `Close price` |
| Price (single value) | Instead of the four | 1 | A measure | The visual builds the OHLC of each bar | `Copper price` |
| Volume | No | 1 | A measure | Volume pane, volume indicators | `Traded volume` |
| Lines on prices | No | Up to 5 | Measures | Target, benchmark, forecast drawn over the prices | `Target price` |
| Event text | No | 1 | A text measure | A marker on each bar where it is not empty | "Annual results" |
| Event type | No | 1 | A text measure | Chooses the icon: buy, sell, flag, circle, star, diamond, a letter | "buy" |
| Position state ★ | No | 1 | A measure | +1 long, −1 short, 0 out of the market: the visual derives the positions | `Strategy signal` |
| Entry price ★, Exit price ★ | No | 1 each | Measures | Actual execution prices, otherwise the close | `Executed price` |
| Tooltips | No | Several | Measures | Added to the tooltip | `Margin rate` |
| Dynamic format | No | Several | Measures named `card.setting` | Drive a Format pane setting with DAX ([dynamic formatting](/en/tutorials/formats-dynamiques)) | `yAxis.min` |

**Date / time.** The visual detects the granularity (minute, hour, day, week, month…) from the most common gap between two dates. A text in YYYY-MM-DD format is also read as a date; any other text ("Lot 1", "Lot 2") gives a category axis in data order, with no grouping.

**Price (single value).** Handy for readings: the copper purchase price recorded each day becomes, in **1M**, one candle per month (first price, high, low, last price). As long as each bar has a single price (one-day timeframe for daily readings), the *Automatic* type draws a line rather than flat candles.

Tooltips and Dynamic format: see [the shared basics](/en/tutorials/bien-demarrer-visuels-plume).

## Format pane settings

The cards shared by every Plume visual (Plume Studio License, Style, Tooltips, Title, Source note, Frame, Language and numbers) and the two basic settings of the Interactions card are described in [the common basics](/en/tutorials/bien-demarrer-visuels-plume). Here are the cards specific to Candle Plume, in the order of the pane. Color and text settings have the **fx** button: a measure or a rule can drive them.

### Layout

The chart type and the symbol watermark (formerly the "Chart type" card). The new default choice, *Automatic*, draws a line when only the **Price** field is filled with one price per bar, and candles otherwise; an explicit choice is kept.

| Setting | What it does | Options (default in **bold**) |
|---|---|---|
| Chart type | Automatic: candles with Open, High, Low and Close; a line when only the Price field is filled and each bar has a single price. | **Automatic (candles; line with the Price field alone)** · Candles · Hollow candles · OHLC bars · Line · Area · Heikin-Ashi ★ · Baseline ★ · HLC columns ★ · Line with markers ★ |
| Baseline value | Baseline: the level that separates green from red (shown when Chart type = *Baseline*) | text; **empty** (first visible close) |
| Line width | Line styles (shown when Chart type = *Automatic (candles; line with the Price field alone)* or *Line* or *Area* or *Baseline* or *Line with markers*) | **1.5** (0.5 to 6) |
| Symbol watermark | The name of the security (Symbol field) in large type, behind the candles | **off** |

### Data and timeframe

Chooses the timeframe at startup, the timeframes offered to readers, the time axis, the session and the window shown.

| Setting | What it does | Options (default in **bold**) |
|---|---|---|
| Default timeframe | Timeframe at startup | **Same as the data** · 1 minute · 5 minutes · 15 minutes · 30 minutes · 1 hour · 4 hours · 1 day · 1 week · 1 month · 1 quarter · 1 year |
| Timeframes offered to readers | Buttons of the selector, separated by spaces | text; **empty** |
| Time axis | One bar per step, or spacing by real time | **One bar per step (no weekend gaps)** · Real time (gaps shown) |
| Week starts on | First day of 1W bars | **Monday** · Sunday · Saturday |
| First month of the fiscal year (quarters, years) | Start of quarters and years | **1** (1 to 12) |
| Market session (intraday) | Ignores rows outside the session; 1H and 4H start at the beginning of the session | text; **empty** |
| Time zone offset (hours) | Shifts the display | **0** (-14 to 14) |
| Initial range | Window at startup | **Automatic (readable bars)** · 1 month · 3 months · 6 months · Year to date · 1 year · 5 years · All |
| Display from | Earlier bars are only used to compute the indicators | text; **empty** |
| Series shown | Forces a stock (Symbol field) | text; **empty** |
| Compare series in % ★ | The other stocks as lines, in % | **off** |

### Candles

| Setting | What it does | Options (default in **bold**) |
|---|---|---|
| Up | Body colors | color; **#2E7D4F** |
| Down | Body colors | color; **#C0392B** |
| Unchanged (empty = secondary) | — | color; **empty** |
| Up border (empty = body) | — | color; **empty** |
| Down border (empty = body) | — | color; **empty** |
| Up wick (empty = body) | — | color; **empty** |
| Down wick (empty = body) | — | color; **empty** |
| Body width (% of spacing) | Thickness of the candles | **70** (10 to 100) |
| Shade by volume | Low-volume candles are paler | **off** |

### Volume

| Setting | What it does | Options (default in **bold**) |
|---|---|---|
| Show (with the Volume field) | With the Volume field | **on** |
| Placement | Pane under the prices or overlaid | **Pane below prices** · Overlay at the bottom of prices |
| Height (%) | — | **18** (5 to 50) |
| Up (empty = candles) | — | color; **empty** |
| Down (empty = candles) | — | color; **empty** |
| Opacity (%) | — | **45** (5 to 100) |
| Volume average | — | **off** |
| Average length | (shown when Volume average = on) | **20** (1 to 500) |

### Indicators

| Setting | What it does | Options (default in **bold**) |
|---|---|---|
| Indicators (one per line) | List written by the visual's Indicators button, or by hand | text; **empty** |
| Moving average 1 | Shortcuts: type, length, color | **off** |
| Type | **Moving average 1** group. (shown when Moving average 1 = on) | **Simple (SMA)** · Exponential (EMA) · Weighted (WMA) ★ · Volume-weighted (VWMA) ★ · Smoothed (SMMA) ★ · Double EMA (DEMA) ★ · Triple EMA (TEMA) ★ · Hull (HMA) ★ |
| Length (bars) | **Moving average 1** group. (shown when Moving average 1 = on) | **20** (1 to 500) |
| Color (empty = palette) | **Moving average 1** group. (shown when Moving average 1 = on) | color; **empty** |
| Moving average 2 | — | **off** |
| Type | **Moving average 2** group. (shown when Moving average 2 = on) | Simple (SMA) · **Exponential (EMA)** · Weighted (WMA) ★ · Volume-weighted (VWMA) ★ · Smoothed (SMMA) ★ · Double EMA (DEMA) ★ · Triple EMA (TEMA) ★ · Hull (HMA) ★ |
| Length (bars) | **Moving average 2** group. (shown when Moving average 2 = on) | **50** (1 to 500) |
| Color (empty = palette) | **Moving average 2** group. (shown when Moving average 2 = on) | color; **empty** |
| Moving average 3 | — | **off** |
| Type | **Moving average 3** group. (shown when Moving average 3 = on) | **Simple (SMA)** · Exponential (EMA) · Weighted (WMA) ★ · Volume-weighted (VWMA) ★ · Smoothed (SMMA) ★ · Double EMA (DEMA) ★ · Triple EMA (TEMA) ★ · Hull (HMA) ★ |
| Length (bars) | **Moving average 3** group. (shown when Moving average 3 = on) | **200** (1 to 500) |
| Color (empty = palette) | **Moving average 3** group. (shown when Moving average 3 = on) | color; **empty** |
| Bollinger Bands ★ | Length, standard deviations, color | **off** |
| Length | **Bollinger Bands ★** group. | **20** (2 to 500) |
| Standard deviations | — | **2** (0.1 to 10) |
| Color (empty = palette) | **Bollinger Bands ★** group. | color; **empty** |
| RSI ★ | Length, levels | **off** |
| Length | **RSI ★** group. | **14** (2 to 500) |
| Upper level | — | **70** (0 to 100) |
| Lower level | — | **30** (0 to 100) |
| MACD ★ | Fast, slow and signal lengths | **off** |
| Fast length | — | **12** (1 to 500) |
| Slow length | — | **26** (1 to 500) |
| Signal | — | **9** (1 to 500) |

### Panes

| Setting | What it does | Options (default in **bold**) |
|---|---|---|
| Height of each indicator pane (%) | — | **22** (8 to 45) |
| Separator lines | — | **on** |
| Levels and band between them | E.g. RSI 70 / 30, with ticks at the levels | **on** |

### Positions ★

| Setting | What it does | Options (default in **bold**) |
|---|---|---|
| Show | Positions from the Position state field and from the list | **on** |
| Profit | Color of winning positions | color; **#2E7D4F** |
| Loss | Color of losing positions | color; **#C0392B** |
| Neutral period (empty = accent) | — | color; **empty** |
| Label | — | **Result, %, duration, risk / reward** · Result in % · None |
| Label background | Background behind the result of each position | **Visual background color** · Transparent |
| Default quantity | Quantity of a new position | **1** (min. 0) |
| Default fees (amount or %) | — | text; **empty** |
| Statistics panel | — | **off** |
| Equity curve | — | **off** |
| Positions (one per line) | List written by the Position button, or by hand | text; **empty** |

### Time axis

| Setting | What it does | Options (default in **bold**) |
|---|---|---|
| Show | Labels: year, month, day, hour depending on the room | **on** |
| Size | — | **9** (6 to 24) |
| Color (empty = secondary text) | — | color; **empty** |
| Label spacing (px) | Density | **90** (40 to 300) |
| Day / month / year separators | Dotted lines where they change | **off** |

### Price axis

| Setting | What it does | Options (default in **bold**) |
|---|---|---|
| Show | Labels | **on** |
| Position | Side of the labels | **Right** · Left |
| Size | — | **9** (6 to 24) |
| Color (empty = secondary text) | — | color; **empty** |
| Display units | — | Auto · **None** · Thousands · Millions · Billions |
| Decimals (-1 = auto) | — | **-1** (-1 to 6) |
| Prefix | — | text; **empty** |
| Suffix (e.g. €) | — | text; **empty** |
| Scale | Linear, logarithmic, % from the first visible bar, indexed to 100 | **Linear** · Logarithmic · Percent (from the first visible bar) · Indexed to 100 |
| Minimum | Fixed bottom of the price scale (prices). Keep it under a filter with a DAX measure in the Dynamic format field named yAxis.min, e.g. CALCULATE(MIN(Prices[Low]), REMOVEFILTERS()). | text; **empty** |
| Maximum | Fixed top of the price scale. DAX: a yAxis.max measure, e.g. CALCULATE(MAX(Prices[High]), REMOVEFILTERS()). | text; **empty** |
| Invert axis | Highest prices at the bottom | **off** |
| Top margin (%) | Margins above and below the prices | **8** (0 to 40) |
| Bottom margin (%) | Margins above and below the prices | **8** (0 to 40) |
| Last price line | Marker of the last price, colored by the last candle | **on** |
| Label on the axis | Marker of the last price, colored by the last candle | **on** |
| Axis title | — | **off** |
| Title text | (shown when Axis title = on) | text; **empty** |

### Gridlines

The guide lines and session bands (formerly the "Grid and background" card), with the line width as in the native line chart.

| Setting | What it does | Options (default in **bold**) |
|---|---|---|
| Horizontal | — | **on** |
| Vertical | — | **on** |
| Line style | — | **Solid** · Dashed · Dotted |
| Color (empty = lines) | — | color; **empty** |
| Width | — | **1** (0.5 to 4) |
| Alternate session bands | — | **off** |

### Legend

The top-left line that gives the open, high, low, close and indicators of the hovered bar (formerly "Legend and crosshair").

| Setting | What it does | Options (default in **bold**) |
|---|---|---|
| Show (OHLC and indicators) | Values of the hovered bar, or of the last bar | **on** |
| Size | — | **11** (7 to 18) |
| Color (empty = text) | — | color; **empty** |
| Keep room for the legend | The price scale keeps the height of the legend free at the top: candles never run under its text, even on a small visual | **on** |

### Annotations

| Setting | What it does | Options (default in **bold**) |
|---|---|---|
| Show | — | **on** |
| Text | Label on the chart or tooltip only | **Label on the chart** · Tooltip only |
| Marker position | — | **Automatic (buy below, sell above)** · Above the high · Below the low |
| Vertical line across panes | — | **off** |
| Color (empty = accent) | — | color; **empty** |
| Size | — | **9** (6 to 20) |
| Label width (px) | A longer text goes to the next line (up to the maximum number of lines) instead of being cut. | **180** (60 to 600) |
| Maximum lines | — | **3** (1 to 10) |
| Label background | Background behind the annotation text: transparent lets the candles and position zones show | **Visual background color** · Transparent |
| Manual annotations ★ | List written by the Annotate button, or by hand: `date \| text \| icon \| color \| position` | text; **empty** |

### Crosshair

The two lines that follow the mouse, with the date and the price on the axes. It is cleared when the mouse leaves the chart.

| Setting | What it does | Options (default in **bold**) |
|---|---|---|
| Show | — | **on** |
| Mode | — | **Snapped to the close** · Free |
| Line style | — | Solid · **Dashed** · Dotted |
| Color (empty = secondary text) | — | color; **empty** |

### Navigation

| Setting | What it does | Options (default in **bold**) |
|---|---|---|
| Timeframe selector | — | **on** |
| Range buttons (1M, 3M… All) | — | **on** |
| Mouse wheel zoom | — | **on** |
| Navigator (mini chart) ★ | Strip at the bottom with the window shown | **off** |
| Initial bar spacing (px) | — | **8** (2 to 40) |
| Right margin (bars) | — | **3** (0 to 50) |

### Tooltips

The common **Tooltips** card, with two settings specific to Candle Plume (formerly the "Tooltip" card).

| Setting | What it does | Options (default in **bold**) |
|---|---|---|
| Show | Tooltip on hover (with the fields of the "Tooltips" well and report page tooltips). | **on** |
| Change and % | Difference from the previous close, in value and in % | **on** |
| Volume | The volume of the bar (with the Volume field) | **on** |

## Premium ★ features of this visual

| Feature | Where to set it |
|---|---|
| Heikin-Ashi, baseline, HLC columns, line with markers | Format › Layout › Chart type |
| Bollinger Bands, RSI, MACD | Format › Indicators (shortcuts), Indicators button |
| 55 more indicators (Ichimoku, SuperTrend, VWAP, Stochastic, ATR, OBV…), more than one pane, crossover signals | Indicators button, Format › Indicators › Indicators (one per line) |
| WMA, VWMA, SMMA, DEMA, TEMA, HMA average types | Format › Indicators › Moving average 1 to 3 |
| Click-to-add annotations | Annotate button, Format › Annotations › Manual annotations ★ |
| Positions, statistics, equity curve | Position state field, Position button, Format › Positions |
| Comparison of series in % | Format › Data and timeframe |
| Navigator | Format › Navigation |

## Learn more

- [Getting started with Candle Plume](/en/tutorials/candle-plume-prise-en-main): the data to prepare and a first visual, step by step.
- [Candle Plume how-to guides](/en/tutorials/candle-plume-cas-pratiques): recipes for common needs.
- [Getting started with Plume visuals](/en/tutorials/bien-demarrer-visuels-plume): installation, license, styles and shared settings.
- The visual's page: [Candle Plume](/en/visuals/candle-chart). A question? [Support](/en/support).