{"title":"Get started creating report layouts","url":"https://jonas-paprotka.de/docs/ui-get-started-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-get-started-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-get-started-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 customize report layouts in Dynamics 365 Business Central.","date":"2026-11-12","meta":{"topic":"get-started"},"outline":[{"level":1,"title":"Get started creating report layouts","slug":"get-started-creating-report-layouts","at":0,"chars":17873},{"level":2,"title":"Overview of report layouts","slug":"overview-of-report-layouts","at":614,"chars":1823},{"level":2,"title":"Get started","slug":"get-started","at":2437,"chars":1200},{"level":2,"title":"Decide what type of layout you want","slug":"decide-what-type-of-layout-you-want","at":3637,"chars":1874},{"level":2,"title":"Create a new layout","slug":"create-a-new-layout","at":5511,"chars":5281},{"level":3,"title":"Copy a layout<#tab/copy>","slug":"copy-a-layouttabcopy","at":5873,"chars":963},{"level":3,"title":"Export a layout copy and import it as a new layout<#tab/export>","slug":"export-a-layout-copy-and-import-it-as-a-new-layouttabexport","at":6836,"chars":2229},{"level":3,"title":"Create from blank<#tab/blank>","slug":"create-from-blanktabblank","at":9065,"chars":1727},{"level":2,"title":"Modify a layout","slug":"modify-a-layout","at":10792,"chars":1426},{"level":2,"title":"Replace a layout","slug":"replace-a-layout","at":12218,"chars":712},{"level":2,"title":"Rename a layout","slug":"rename-a-layout","at":12930,"chars":554},{"level":2,"title":"Validate a layout","slug":"validate-a-layout","at":13484,"chars":550},{"level":2,"title":"Manage layout status","slug":"manage-layout-status","at":14034,"chars":987},{"level":2,"title":"Get information about a layout","slug":"get-information-about-a-layout","at":15021,"chars":722},{"level":2,"title":"Delete a layout","slug":"delete-a-layout","at":15743,"chars":484},{"level":2,"title":"Mark a layout as obsolete","slug":"mark-a-layout-as-obsolete","at":16227,"chars":1052},{"level":2,"title":"Related information","slug":"related-information","at":17279,"chars":594}],"text":"# Get started creating report layouts\nBusiness Central includes many built-in layouts that you can use on your reports. Other layouts might be added as part of extensions. In addition, you can create your own report layouts, either from scratch or based on an existing layout.\n> NOTE\n> You can also use report layouts to add content to email messages, which saves time and helps ensure consistency when you communicate with your customers. Only custom report layouts of the Word type can be used with email. You can't use RDLC layouts with email. See admin-how-setup-email#set-up-reusable-email-texts-and-layouts.\n## Overview of report layouts\nIt can be helpful to think of a report layout as a file that is imported and assigned to a report. You manage all layouts in Business Central in basically the same way, regardless of the layout type. You mainly work from the Report Layouts page. The layouts differ mainly in the way that you design them. Each layout is designed by using the software that the layout is built on, such as Word, Excel, or SQL Server Report Builder.\nWord layouts can also have a subtype, which defines the layout's role. A stand-alone layout uses the Default subtype. A layout with the Body subtype contains report-specific content that can be combined with a reusable theme and header/footer when the report runs. The theme and header/footer are separate reusable parts that administrators manage on their own. See Set up reusable themes and header/footer layouts<ui-set-up-report-themes-header-footer-layouts>.\nThe process of setting up a layout for a report involves three or four basic tasks.\n1. Decide which layout type to use.\n2. Export a copy of an existing layout so that you can use it as a starting point.\n3. Make changes to the layout file in the appropriate application.\n4. Add the new layout file to the report.\n> IMPORTANT\n> You can modify or replace only user-defined layouts. You can't modify or replace extension layouts, which are layouts that originate from an extension. On the Report Layouts page, you can tell whether a layout is a user-defined layout or an extension layout by looking in the Extension column. For an extension layout, the Extension column shows information about the source extension. For a user-defined layout, the Extension column is blank.\n> Learn more about the difference between extension layouts and user-defined layouts in ui-manage-report-layouts#layout-sources.\n## Get started\nDepending on your situation, the actual tasks vary. Use the following table to get started.\nWhat do you want to do?|Learn more\nFigure out the best layout type to use for my situation.|Decide what type of layout you want<#decide>\nCreate a new layout for a report, either from scratch or based on a copy of an existing layout.|Create a new layout<#create>\nMake changes to the layout that a report uses.|Modify a layout<#modify>\nReplace the current layout file that a report uses with a new version of the layout file.|Replace a layout<#replace>\nChange the current layout that a report uses to another layout.|Set the layout used by a report<ui-set-report-layout>\nApply a reusable theme and header/footer to Word body layouts.|Set up reusable themes and header/footer layouts<ui-set-up-report-themes-header-footer-layouts>\nChange the name and description of a layout.|Rename a layout<#rename>\nChange whether a layout is available for selection.|#manage-layout-status\nMark a layout as obsolete|#mark-a-layout-as-obsolete\nValidate a layout.|Validate a layout<#validate>\nView information about a layout.|#get-information-about-a-layout\nDelete a user-defined layout.|Delete a layout<#delete>\n## Decide what type of layout you want\nThe first task when you create a layout is to decide which ui-manage-report-layouts#layout-types you want. You can choose among the Word, Excel, and RDLC layout types. Your choice depends on how you want the generated report to look. It also depends on your knowledge of the software that is used to create the layout, such as Word, Excel, and SQL Server Report Builder.\n Excel layouts are generally the easiest to create and modify because summarizing data, adding graphics, and styling are common Excel features. However, not all reports have datasets optimized for Excel layouts. Aggregations and complex calculations work best with RDLC or Word layouts. Documents that use aggregations or complex calculations also work best with RDLC or Word layouts.\n If you're making only style changes, such as changes to the font type, size, and colors, a Word layout is a good choice.\n The capabilities for adding and rearranging data fields are more advanced in Word and RDLC layouts than in Excel layouts.\n Word and RDLC layouts are good choices for printable reports.\n The design concepts for Word and RDLC layouts are similar, but each has specific features that affect the report's appearance in Business Central. The same report might look different depending on whether a Word or RDLC layout is used.\nIf you want to apply reusable themes and header or footer layouts, create a Word layout and set its Subtype to Body. Use Default for a stand-alone Word layout that renders without reusable parts. Learn more about setting the subtype in Create a new layout<#create>.\n> NOTE\n> The Subtype field and ui-manage-report-layouts#composite-word-layouts options are available when the Document Report Experience feature is enabled on the Feature Management page. See Enabling new and upcoming features ahead of time<admin-feature-management>.\n## Create a new layout\nThere are different methods for creating a new layout. The easiest methods involve using a copy of an existing layout. For these methods, you can either save the existing layout directly as a copy, or export it and then import it into a new layout. Another, more advanced method is to create a layout from scratch by using a blank layout.\n### Copy a layout<#tab/copy>\nCopying an existing layout lets you quickly create a new, identical layout that you can customize.\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.\n The Report Layouts page lists all layouts for all reports.\n1. Select the layout that you want to copy for the new layout, and then select the Edit Info action.\n If you select an extension layout, you're asked whether you want to edit a copy of it. Select Yes.\n> TIP\n> To find the layout that you want, use the search field, the filter pane, and column sorting.\n1. In the Layout Name field, enter a new name.\n1. Turn on the Save Changes to Copy toggle, if it isn't already on.\n1. Select OK.\n The new layout appears on the Report Layouts page.\nIf needed, you can change the settings in your new layout. See Modify a layout<#modify>.\n### Export a layout copy and import it as a new layout<#tab/export>\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 layout that you want to copy for the new layout, and then select the Export Layout action.\n The layout file is downloaded to your device.\n> TIP\n> To find the layout that you want, use the search field, the filter pane, and column sorting.\n1. Open the layout file in the appropriate application, such as Word (for a .docx file) or Excel (for an .xlsx file).\n Learn more in the following articles:\n  Map data fields with the XML Mapping Pane<ui-how-add-fields-word-report-layout>\n  Working with Microsoft Excel Layouts<ui-excel-report-layouts>\n  Working with RDLC Layouts<ui-rdlc-report-layouts>\n1. Make the changes you want to the file-such as adding fields, adjusting tables, or updating formatting-and then save it.\n1. On the Report Layouts page, select New.\n1. In the Add New Layout for a Report dialog box, fill in the fields described in the following table.\n Field|Description|Mandatory\n Report ID|Enter the ID that is assigned to the report.|Yes\n Layout Name|Enter a brief, descriptive name for the layout to help you easily identify it.|Yes\n Description|Enter more detailed information about the layout.|No\n Format Options|Set this field to match the type of the layout (for example, Word, Excel, or RDLC).|Yes\n Subtype|For a Word layout, select Body to apply reusable themes and header/footer layouts. Select Default for a stand-alone layout.|Yes\n Available in All Companies|Turn on this option to make the layout available in all companies. Turn it off to limit the layout to the current company.|Yes\n1. Select OK.\n1. Follow one of these 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 you're returned to the Report Layouts page.\nTo view how the report looks with the new layout, select the layout in the list, and then select Run Report.\n### Create from blank<#tab/blank>\nWhen you create a new layout from a blank layout, you must design it completely. The layout file provides all the report fields that you can add and arrange as you require.\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 any layout that is for the same report that you want use the new layout for.\n1. Select New.\n1. In the Add New Layout for a Report dialog box, set the following fields.\n Field|Description|Mandatory\n Report ID|Enter the ID that is assigned to the report.|Yes\n Layout Name|Enter a brief descriptive name for the layout to help you easily identify it.|Yes\n Description|Enter more detailed information about the layout.|No\n Format Options|Set this field to match the type of the layout (for example, Word, Excel, or RDLC).|Yes\n Subtype|For a Word layout, select Body to apply reusable themes and header/footer layouts. Select Default for a stand-alone layout.|Yes\n Available in All Companies|Turn on this option to make the layout available in all companies. Turn it off to limit the layout to the current company.|Yes\n1. Turn on the Create a blank layout from the report object option.\n1. Select OK.\n The new layout appears in the list. The layout is blank, but all the report fields and captions are available so that you can start to add them to the layout.\n1. You can now start to Modify a layout<#modify>.\nNew user-defined layouts start with the Draft status. After you finish designing and validating the layout, change its status to Approved to make it available for selection. See #manage-layout-status.\n## Modify a layout\nFollow these steps to modify an existing user-defined layout.\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 layout that you want to modify, and then select the Export Layout action.\n The layout file downloads to your device.\n> TIP\n> To find the layout that you want, use the search field, the filter pane, and column sorting.\n1. Open the layout file in the appropriate application, such as Word (for a .docx file) or Excel (for an .xlsx file).\n Learn more in the following articles:\n  Map data fields with the XML Mapping Pane<ui-how-add-fields-word-report-layout>\n  Working with Microsoft Excel layouts<ui-excel-report-layouts>\n  Working with RDLC Layouts<ui-rdlc-report-layouts>\n1. Make the changes you want to the file-such as adding fields, adjusting tables, or updating formatting-and then save it.\n1. On the Report Layouts page, select the existing layout, and then select the Replace Layout action.\n1. Select OK and then Choose to open File Explorer on your device.\n1. Find and select the Excel file, and then select Open.\n The selected file is uploaded to the layout, and you're returned to the Report Layouts page.\n1. To view how the report looks with the new layout, select the layout in the list, and then select Run Report.\n## Replace a layout\nFollow these steps to replace the existing user-defined layout file with a new file.\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 existing layout, and then select the Replace Layout action.\n1. Select OK and then Choose to open File Explorer on your device.\n1. Find and select the Excel file, and then select Open.\n The selected file is uploaded to the layout, and you're returned to the Report Layouts page.\n1. To view how the report looks with the new layout, select the layout in the list, and then select Run Report.\n## Rename a layout\nFollow these steps if you want to change the name and description of a user-defined layout.\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 layout that you want to rename, and then select the Edit Info action.\n> TIP\n> To find the layout that you want, use the search field, the filter pane, and column sorting.\n1. In the Layout Name, enter a new name.\n1. Select OK.\n## Validate a layout\nValidate a user-defined layout to check for problems and view the results. Follow these steps to validate a layout.\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 layout you want to validate, and then select the Validate action.\n> TIP\n> To find a layout, use the Search field, Filter pane, or column sorting.\n1. A dialog opens to show the validation results.\n## Manage layout status\nThe status controls whether a layout is available for selection on report request pages.\nStatus|Use\nDraft|The layout is being prepared and isn't available for selection.\nPending Approval|The layout is ready for review and isn't available for selection.\nApproved|The layout is available for selection.\nRetired|The layout is no longer available for selection.\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 one or more layouts.\n1. Select Layout > Layout Status, and then select Set Draft, Set Pending Approval, Set Approved, or Set Retired.\nWhen you change the status of an extension-provided layout, Business Central saves your change as an override. The original extension-provided layout stays unchanged. The override applies your new status while keeping the layout that the extension provides.\n## Get information about a layout\nView information about the layout, such as its ID, the associated report, and when it was created and last modified. This information is useful for troubleshooting. Follow these steps to view layout information.\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 layout you want to gather information for, and then select the Show layout info action.\n> TIP\n> To find a layout, use the search field, the filter pane, or column sorting.\n1. In the Layout information dialog, select the text and copy it to share with others.\n## Delete a layout\nTo delete a user-defined layout, follow these steps.\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 layout that you want to delete, and then select the Delete action.\n> TIP\n> To find a layout, use the Search field, the Filter pane, or column sorting.\n1. In the Delete layout dialog, select Yes.\n## Mark a layout as obsolete\nA layout can become obsolete for various reasons. For example, the data model might change, making the layout outdated, or a more efficient layout might be introduced, making the current layout redundant. Marking a layout as obsolete signals to others that it might be removed in a later release, so they should use an alternative layout.\nTo identify which layouts are obsolete, refer to the Obsolete column on the Report Layouts page. You can mark a user-defined layout as obsolete if needed.\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.\n2. Select the layout that you want to change, and then select the Edit Info action.\n3. Turn on the Mark layout as obsolete toggle.\n4. Select OK.\n> NOTE\n> Extension layouts are marked as obsolete in AL code using the dev-itpro/developer/properties/devenv-obsoletestate-property and can't be changed using the Edit Info action.\n## Related information\nReport and document layouts overview<ui-manage-report-layouts>\nSet up reusable themes and header/footer layouts<ui-set-up-report-themes-header-footer-layouts>\nui-design-word-layouts-business-central-add-in\nMap data fields with the XML Mapping Pane<ui-how-add-fields-word-report-layout>\nWorking with Microsoft Excel Layouts<ui-excel-report-layouts>\nRun and print reports in Business Central<ui-work-report>\nWork with Business Central<ui-work-product>\nFind free e-learning modules for Business Central here<https://learn.microsoft.com/training/dynamics365/business-central>"}