CSV Macro

On this page


The CSV macro can import, format and display comma-separated values (CSV) data from anywhere, by:

  • Reading the CSV data from any of these sources:
    • Within your Confluence page.
    • From a file residing on the Confluence server (Server only).
    • From a global or space template (Server only).
    • From a page attachment.
    • From an external URL.
  • Allowing customizable delimiters, quote characters, and character encoding.
  • Supporting inclusion of Wiki Markup macros within the CSV data.
  • Combining with the Chart macro to produce powerful data visualization.
  • Leveraging the same table styling capabilities as the Table Plus macro.

CSV is not a formal standard, but the best reference is The Comma Separated Value (CSV) File Format. The support in this macro comes close to following this pseudo-standard.  This macro supports Common table capabilities

Feature Video

Basic Use

This macro can be deployed using one of the following methods:

Selected from the Macro BrowserCSV (Comma Separated Values)
Markup Shortcut{csv}



(info) Click a column heading to toggle the sorting of that column.

Augment parameters

See Augments for details.

Common parameters



  • Chart Macro - the CSV Macro can be used to create data for a chart
  • Beanshell macro - can be used to generate CSV macro and data as output from Java code (use output=wiki)
  • Groovy macro - can be used to generate CSV macro and data as output from Groovy code (use output=wiki)
  • Jython macro - can be used to generate CSV macro and data as output from Jython code (use output=wiki)

Other Macros

Below is a list of all other Macros available within this Add-on:

Additional References