{"title":"Report discoverability","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-reports-discoverability/","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/dev-itpro/developer/devenv-reports-discoverability, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (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/dev-itpro/developer/devenv-reports-discoverability","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Introducing how to make Business Central reports discoverable by users.","date":"2024-03-11","meta":{"topic":"article"},"outline":[{"level":2,"title":"Adding reports to Tell me","slug":"adding-reports-to-tell-me","at":559,"chars":563},{"level":2,"title":"Adding reports to role centers","slug":"adding-reports-to-role-centers","at":1122,"chars":536},{"level":2,"title":"Adding reports to the Report/Role explorer","slug":"adding-reports-to-the-reportrole-explorer","at":1658,"chars":645},{"level":2,"title":"Adding reports to pages","slug":"adding-reports-to-pages","at":2303,"chars":770},{"level":2,"title":"Adding teaching tips to your reports","slug":"adding-teaching-tips-to-your-reports","at":3073,"chars":425},{"level":2,"title":"Adding help links to your reports","slug":"adding-help-links-to-your-reports","at":3498,"chars":489},{"level":2,"title":"Related information","slug":"related-information","at":3987,"chars":555}],"text":"After you develop a report and before you make it available for users, you must consider discoverability for the report, meaning:\n How users can discover that the report exists?\n Ensure that users can find it.\n Ensure that users know how to use it.\nBusiness Central comes with various features that you can use to make that happen, such as Tell me search, actions on role centers and pages, Report/Role explorer, teaching tips, and context-specific help.\nIn this article, you can learn how to use all of them to maximize the user experience for your reports.\n## Adding reports to Tell me\nThe Business Central client includes the Tell me feature that lets users find objects by entering search terms. When you have added a report in your app/extension, you most likely want it to be discoverable to users in Tell me.\nIn AL, you make a report searchable from Tell me by setting the properties/devenv-usagecategory-property in code. The UsageCategory setting makes the report searchable, and the value chosen for the setting further sub categorizes the item.\nSee Adding reports to Tell Me<devenv-al-menusuite-functionality>.\n## Adding reports to role centers\nRole centers in Business Central have a navigation area that appears at the top of the window, and contains multiple sections that enable users to quickly navigate and perform actions. These actions display the most important or most often used tasks and operations required by users and typically contain links to pages, reports, and codeunits. For reports, you can add them under the Reporting area.\nSee Adding links to the navigation menu on the role center<devenv-adding-menus-to-navigation-pane>.\n## Adding reports to the Report/Role explorer\nWhen pages and reports are added to role centers, they also become available in the Report/Role explorer overviews (if the Report/Role explorer feature is enabled for the roles).\nTo verify that the Report/Role explorer feature is enabled for a role, open the Profile (Role) card and select the Show in Role Explorer check box. For more information about Report/Role explorer visibility for a role, see Manage user profiles</admin-users-profiles-roles#to-activate-a-profile>.\nFor more information about the Report/Role explorer feature, see Finding Reports with the Role Explorer</ui-role-explorer>.\n## Adding reports to pages\nAll pages in Business Central allow you to add actions that run a report. Before putting a report action on a page, you should think about the business processes that the report supports. Creating these actions can make it easier for the user to perform their daily tasks, such as getting a sales order overview or analyzing the inventory.\nTo read more about how to add reports as actions on pages in versions before version 2022 release wave 2, see devenv-adding-actions-to-a-page.\nWith Business Central 2022 release wave 2, the way that you promote actions on pages or page extensions has changed. Promoting actions is defined in a specific section of the page definition and contains a reference to the action. See devenv-promoted-actions.\n## Adding teaching tips to your reports\nWith teaching tips, you can help explain logic that's relevant to the report therefore allowing users to get on with a reporting task right away without blocking them. After users dismiss a teaching tip, they can choose or hover over the report title in the request page. This action reopens the teaching tip.\nSee devenv-request-pages-for-reports#adding-teaching-tips-to-your-reports.\n## Adding help links to your reports\nA key pillar of helping users help themselves is to give them access to help for the particular part of Business Central that they're working in. This also applies for reports.\nStarting with Business Central 2023 release wave 1 (version 22), you can set the ContextSensitiveHelpPage property on report request pages, which will in turn show the report help link in the Help pane.\nSee devenv-request-pages-for-reports#adding-help-links-to-your-reports.\n## Related information\nAdding reports to Tell Me<devenv-al-menusuite-functionality>\nAdding links to the navigation menu on the role center<devenv-adding-menus-to-navigation-pane>\nAdding actions to a page (before version 2022 release wave 2)<devenv-adding-actions-to-a-page>\nPromoted Actions (version 2022 release wave 2 and later)<devenv-promoted-actions>\ndevenv-request-pages-for-reports#adding-teaching-tips-to-your-reports\ndevenv-request-pages-for-reports#adding-help-links-to-your-reports\nReports overview<devenv-reports>\ndevenv-report-design-overview"}