Docs

Variables

Learn how to embed live variable values from your visualisations inline in your documents.

Revenue was {/u/acme/p/revenue/v/total} million.

Variables let you embed live values from any novem visualisation directly in your document text. When the underlying data changes, the variable value updates automatically across all outputs.

Variables use the Fully Qualified Novem Path (FQNP) syntax wrapped in single curly braces. They render inline — within paragraphs, lists, callouts and other content.

The variable syntax follows the pattern:

{/u/<username>/<type>/<vis_id>/v/<var_name>}

Where:

  • <username> — the novem username who owns the visualisation
  • <type> — the vis type: p (plot), g (grid), m (mail), d (doc), r (repo), j (job)
  • <vis_id> — the visualisation identifier
  • <var_name> — the variable name defined on the visualisation

Variables can be used anywhere inline text is supported:

  • Regular paragraphs
  • Inside {{ para }} sections
  • Inside {{ callout }} sections
  • Inside list items
  • Inside [[span: sections]]

Variables are not processed inside code blocks or inline code.

The index returned {/u/acme/p/nei/v/ytd_return} year to date.


Revenue hit {/u/acme/p/rev/v/total} this quarter, up from
{/u/acme/p/rev/v/prev} last quarter — a {/u/acme/p/rev/v/growth}
increase.


{{ para
  b: l3 blue-500
  p: l2
}}
**Current value:** {/u/acme/p/dashboard/v/current_price}
{{ /para }}


- North America: {/u/acme/p/regions/v/na_return}
- Europe: {/u/acme/p/regions/v/eu_return}
- Asia Pacific: {/u/acme/p/regions/v/apac_return}
Next
Spans