{"title":"Create and modify Microsoft Excel report layouts","url":"https://jonas-paprotka.de/docs/ui-excel-report-layouts/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/ui-excel-report-layouts, MicrosoftDocs/dynamics365smb-docs at 46907ac (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/ui-excel-report-layouts","source":{"name":"Business Central application docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-docs","commit":"46907ace177f8d31deba47a2fdb57c3336e66252","date":"2026-11-19"},"checked":"2026-11-19","description":"Learn how to create and import Excel report layouts in Business Central, configure data sheets, and preserve the dataset structure in your workbook.","date":"2026-11-09","meta":{"topic":"how-to"},"outline":[{"level":1,"title":"Create and modify Microsoft Excel report layouts","slug":"create-and-modify-microsoft-excel-report-layouts","at":0,"chars":8887},{"level":2,"title":"Why use Excel layouts?","slug":"why-use-excel-layouts","at":420,"chars":1343},{"level":2,"title":"Get started with Excel layouts","slug":"get-started-with-excel-layouts","at":1763,"chars":181},{"level":2,"title":"Task 1: Create the Excel layout file","slug":"task-1-create-the-excel-layout-file","at":1944,"chars":2944},{"level":3,"title":"#tab/any-report","slug":"tabany-report","at":2133,"chars":839},{"level":3,"title":"From an existing Excel report layout<#tab/other-layout>","slug":"from-an-existing-excel-report-layouttabother-layout","at":2972,"chars":1516},{"level":3,"title":"From Visual Studio Code<#tab/from-code>","slug":"from-visual-studio-codetabfrom-code","at":4488,"chars":400},{"level":2,"title":"Task 2: Add the Excel layout to the report","slug":"task-2-add-the-excel-layout-to-the-report","at":4888,"chars":1464},{"level":2,"title":"Understand Excel layout data sheets","slug":"understand-excel-layout-data-sheets","at":6352,"chars":1861},{"level":2,"title":"Related information","slug":"related-information","at":8213,"chars":674}],"text":"# Create and modify Microsoft Excel report layouts\nMicrosoft Excel report layouts are based on Excel workbooks (.xlsx files). With them, you can create reports that include familiar Excel features for summarizing, analyzing, and presenting data such as formulas, PivotTables, and PivotCharts.\n![Example of an Excel layout.]\nThis article explains important information you need to know to get started with Excel layouts.\n## Why use Excel layouts?\nBenefits of using Excel layouts:\n You can create your own report layouts with Excel, either from scratch or based on an existing layout.\n You can include multiple worksheets, interactive elements, visualizations, pivot tables, and slicers.\n You can view raw data from the report dataset to help understand how the report works and where the data in visuals comes from.\n You can use built-in Microsoft Office features for post-processing on rendered reports, including:\n   https://support.microsoft.com/office/protect-a-worksheet-3179efdb-1285-4d49-a9c3-f4ca36276de6\n   https://support.microsoft.com/office/apply-sensitivity-labels-to-your-files-and-email-in-office-2f96e7cd-d5a4-403b-8bd7-4cc636bae0f9\n   Adding comments and notes<https://support.microsoft.com/office/insert-comments-and-notes-in-excel-65f504d8-160b-4a05-ac30-46fbd5227a52>\n   Forecasting and analysis<https://support.microsoft.com/office/introduction-to-what-if-analysis-22bffa5f-e891-4acc-bf7a-e4645c446fb4>\n You can use installed add-ins and app integrations, such as Power Automate flows and OneDrive.\n> TIP\n> With OneDrive integration set up, when you run a report with an Excel layout, the Excel workbook file is copied to OneDrive and then opened in Excel online. See across-onedrive-overview#save-excel-workbooks-and-report-files-in-onedrive\n## Get started with Excel layouts\nThere are two tasks involved in setting up an Excel layout for a report:\n1. Create the new Excel layout file.\n1. Add the new layout to the report.\n## Task 1: Create the Excel layout file\nThere are several ways to create an Excel layout for your report:\n From any report.\n From an existing Excel report layout.\n From Visual Studio Code.\n### #tab/any-report\nFollow these steps to create an Excel layout from any report, regardless of the current layout type. The exported workbook contains the report dataset. Its data sheet structure depends on whether the report uses a single data sheet or multiple data sheets.\n1. Select Search (Alt+Q) in the upper-right corner, enter Report Layouts, and then choose the related link. The Report Layouts page appears and lists all the layouts currently available for all reports.\n1. On the Report Layouts page, choose any layout for the report, then select the Run Report action.\n1. On the report's request page, select Send to, then Microsoft Excel Document (data only), and then OK.\n This step downloads an Excel workbook that contains the report dataset.\n1. Open the downloaded file in Excel, make your changes, and then save the file.\n### From an existing Excel report layout<#tab/other-layout>\nIf there's already an Excel layout for a report, you can use the existing layout as a starting point. There are two approaches to getting a copy of the layout. You can either export the existing layout from the Report Layouts page or download the layout from the report's request page. Both ways download an Excel layout file that includes all the sheets of the existing file. The difference is when you download it from the request page, the layout includes actual data. The data isn't required, but it helps when you design the layout.\nApproach 1: Export the layout from the Report Layouts page\n1. Select Search (Alt+Q) in the upper-right corner, enter Report Layouts, and then choose the related link. The Report Layouts page appears and lists all the layouts currently available for all reports.\n1. Select the Excel layout from the list, and then select the Export Layout action.\n1. Open the file in Excel, make your changes, and then save the file.\nApproach 2: Download the layout from the report's request page\n1. Select Search (Alt+Q) in the upper-right corner, enter Report Layouts, and then choose the related link. The Report Layouts page appears and lists all the layouts currently available for all reports.\n1. On the Report Layouts page, choose the Excel layout that you want to use, and then select the Run Report action.\n1. On the report's request page, select Download.\n1. Open the file in Excel, make your changes, and then save the file.\n### From Visual Studio Code<#tab/from-code>\nUsing Visual Studio Code is the most advanced way to create an Excel report layout. It requires knowledge of AL code and is intended for programmers. In this approach, the Excel layouts are part of an extension package you install. See Creating an Excel layout report<dev-itpro/developer/devenv-howto-excel-report-layout> in the Developer and IT Pro help.\n## Task 2: Add the Excel layout to the report\nWhen you have the Excel layout file, the next task is to add it as a new layout for the report.\n1. Select Search (Alt+Q) in the upper-right corner, enter Report Layouts, and then choose the related link. The Report Layouts page appears and lists all the layouts currently available for all reports.\n1. Select New.\n1. In Report ID, enter the ID of the report that the layout belongs to.\n1. In the Layout Name field, enter a name.\n1. In the Format Options field, select Excel.\n1. Leave Create a Blank Layout from the report object turned off to import your existing workbook. Set Available in All Companies to control whether the layout is available in all companies or only the current company. Set Create Multiple Data Sheets to match the layout's data sheet configuration.\n1. Select OK, and then do one of the following steps to upload the layout file for the report:\n  Drag the file from File Explorer on your device to the dialog box.\n  Select the click here to browse link, find the file, and then select Open.\n The selected file is uploaded to the layout, and the Report Layouts page opens.\n1. To review the report in the new layout, select the layout from the list, and then select Run Report.\n> NOTE\n> In version 29, a new or replaced user-defined layout has the Draft status. After testing the layout, select Layout > Layout Status > Set as Approved to make it available for selection on report request pages.\n## Understand Excel layout data sheets\nThere are a few things you need to know or consider when you create or change Excel layouts. A layout can use a single data sheet or multiple data sheets. This configuration defines how the business data from Business Central is organized for the calculations and visualizations on other sheets.\nFor a single-data-sheet layout, the Data sheet and Data table link the layout to the report dataset. For a multiple-data-sheet layout, preserve the data sheets, tables, and column names generated for the report's data items. Don't combine them into a single Data table.\nFor the layout to work, there are some requirements to the structure of the Excel workbook that must be met. The following diagram and table outline the elements and requirements of a single-data-sheet layout.\n![The different elements of an Excel layout.]\n|No.|Element|Description|Mandatory|\n|1|Data sheet|<ul><li>Must have the name Data.</li><li>Can only include one table, which must be named Data.</li></ul>|Yes|\n|2|Data table|<ul><li>Must have the name Data.</li><li>Must have at least one column.</li><li>Can only include columns that are in the report dataset.</li><li>Must start in the first cell A1 of the Data sheet.</li></ul>|Yes|\n|3|Presentation sheets|<ul><li>Used to present data.</li><li>Data comes from the Data sheet. </li></ul>||\n|4|Report Metadata sheet|<ul><li>Automatically included if the layout was created by exporting another Excel report.</li><li>Contains general information about the report.</li><li>Can be deleted.</li></ul>|\nIn summary when working with the Data sheet:\n You can delete or hide columns.\n You can place the sheets in any order, with the Data sheet first or last.\n You shouldn't rename the Data sheet, Data table, or any of the columns.\n You shouldn't add columns unless they already exist in the report dataset.\n## Related information\nCreating an Excel layout report (developer documentation)<dev-itpro/developer/devenv-howto-excel-report-layout?toc=/dynamics365/business-central/toc.json>\nReport and document layouts overview<ui-manage-report-layouts>\nSet the layout used by a report<ui-set-report-layout>\nImport and export a custom report layout (Legacy)<ui-how-import-and-export-report-layout>\nAnalyzing report data with Excel and XML<report-analyze-excel>\nRun and print reports in Business Central<ui-work-report>\nWorking with Business Central<ui-work-product>\nFind free e-learning modules for Business Central here<https://learn.microsoft.com/training/dynamics365/business-central>"}