Posted 14 July 2026, 6:33 am EST
Hi,
To answer your three questions directly:
- There is no report property or Viewer configuration that controls this today — the Excel (.xlsx) export always maps one worksheet per rendered report page when the report is in paginated mode. The sheetName export setting is only a naming prefix applied per generated sheet, not a way to control sheet count.
- This isn’t currently supported as a built-in option — there’s no way to force the native export to single-sheet while leaving the Viewer’s own pagination untouched.
- This request is already logged in our product backlog. Internal tracking ID: “ARJ-1789”. There’s no committed ETA on this right now, but we’ll update this thread as soon as we have anything concrete to share.
In the meantime, here’s a workaround that gets you a single continuous worksheet without changing how readers view the report day-to-day:
The Report Viewer exposes a public renderMode property (‘Paginated’ | ‘Galley’). Default is ‘Paginated’, which is why export follows the same page-by-page layout as the screen. Switching to ‘Galley’ renders the report as one continuous flow, and an Excel export taken from that state produces a single worksheet.
Reference: https://developer.mescius.com/activereportsjs/api/classes/ReportViewer.Viewer#rendermode
Since you want the Viewer to stay paginated for viewing and only the export to be single-sheet, flip the mode only around the export call, using the Viewer’s own export() method, then flip it back:
async function exportSingleSheetExcel(viewer, filename = 'report.xlsx') {
const previousMode = viewer.renderMode; // 'Paginated'
viewer.renderMode = 'Galley';
try {
const result = await viewer.export('xlsx', { /* your usual xlsx export settings */ });
result.download(filename);
} finally {
viewer.renderMode = previousMode; // restore paginated view
}
}
Wire this to a custom toolbar button in place of the built-in Excel export item (see our doc on adding custom export buttons: https://developer.mescius.com/activereportsjs/docs/DeveloperGuide/ActiveReportsJSViewer/Export and https://developer.mescius.com/activereportsjs/demos/features/viewer-customization-toolbar/purejs).
Readers keep the paginated view at all times, and the mode only flips for the moment the export runs.
You may also find this earlier thread useful, where we discussed single-sheet/CSV export for ActiveReportsJS: https://developer.mescius.com/forums/activereportsjs/how-to-export-csv-using-activereportsjs
Thanks,
Priyam