CSV Table Viewer: Sort & Search for Confluence
CSV files as tables readers can sort, search and page through.
Get it on the Atlassian Marketplace →
Overview
Show CSV files on Confluence pages as tables readers can sort, search and page through.
- From a .csv or .tsv file attached to the page, or CSV pasted in a code block inside the macro.
- The separator (comma, semicolon, tab or vertical bar) is detected automatically, or you choose it.
- Quoted values, and separators or line breaks inside cells, are read correctly.
- Sort any column: numbers, dates and text each sort the right way, including numbers such as 1,234.50 or 1.234,50.
- Search all cells, with several words at once.
- Pages of 10 to 100 rows.
Getting started
- A Confluence administrator installs the app from its Atlassian Marketplace listing.
- Attach the CSV file to the page, or keep it ready to paste.
- Edit the page, type
/CSV Tableand insert the macro. With no settings, it shows the first .csv or .tsv attached; to paste the data instead, put it in a code block inside the macro. - Publish the page.
Macro settings
| Setting | What it does |
|---|---|
| Title | Optional heading shown above the table. |
| Attachment | Optional. The name of the attached file to show. |
| Separator | Detect automatically (default), comma, semicolon, tab or vertical bar. |
| First row | Column names (default) or data. |
| Rows per page | 10, 25 (default), 50 or 100. |
Moving from CSV File To Table
Atlassian ends support for Connect, the platform used by CSV File To Table, on 31 January 2027. This app is built on Forge and runs on Atlassian's cloud.
Existing macros of the other app are not converted automatically. For each page:
- Keep the CSV file attached to the page.
- Type
/CSV Table, insert the macro and name the file in Attachment if the page has more than one. - Choose the Separator and whether the First row has the column names.
- Delete the old macro and publish.
Both apps can be installed at the same time, so you can try this one before you uninstall the other.
Limitations
- Files up to 4 MB; the first 5,000 rows and 100 columns are shown.
- Values are shown as text, without formulas or formatting.
Permissions
| Scope | Why |
|---|---|
read:attachment:confluence | List the attachments of the page, as the person viewing it, to find the file. |
readonly:content.attachment:confluence | Download that file, as the person viewing the page. |
No egress: the app does not connect to any server outside Atlassian.
Data and privacy
The app stores nothing. The file is read with the permissions of the person viewing the page and parsed in their browser. Nothing is logged and no data leaves Atlassian. See the privacy policy.
Troubleshooting
All the data is in one column
The separator was not detected: choose it in the macro settings.
The app says it needs an active license
The app is paid and checks the license on every request. Ask your site administrator to check the app's subscription in the administration of Jira or Confluence (Apps → Manage apps). During a free trial the app works normally.
Need help?
See the support page.