Merge pull request #5441 from MicrosoftDocs/kepontop-edit-in-excel-li…

…st-pages

Edit in Excel for developers

dev-itpro/TOC.md

@@ -1520,6 +1520,7 @@
 ### Integrating with Microsoft Excel
 #### [Using Excel for viewing and editing Business Central data](/dynamics365/business-central/across-work-with-excel)  
 #### [Using Excel to design analytical reports](/dynamics365/business-central/ui-excel-report-layouts?tabs=any-report)  
+#### [Controlling Edit in Excel on list pages](developer/devenv-edit-in-excel-lists.md)
 ### [Integrating with Microsoft Graph (System Application reference)](https://github.com/microsoft/BCApps/tree/main/src/System%20Application/App/MicrosoftGraph)  
 ### Integrating with Microsoft Onedrive
 #### [Integrating with Onedrive for Business overview (for administrators)](/dynamics365/business-central/across-onedrive-overview)  

dev-itpro/developer/devenv-designing-list-pages.md

@@ -69,6 +69,7 @@ The following table describes the elements of a typical list page.
 - List pages that are accessed from the Role Center page open embedded within the Role Center framework. The pages are always opened in the read-only mode, regardless of the [Editable](properties/devenv-editable-property.md) property.
 - There are a few system actions that are automatically added to the actions bar, such as **Search**, **See Attached** and **Open in Excel**.
 - Analysis mode is enabled by default on list pages. If you want to turn off this ability, set the [AnalysisModeEnabled](properties/devenv-analysismodeenabled-property.md) property to **false**. 
+- The Edit in Excel action is enabled by default on list pages (for users with the right permissions). If you want to turn off this ability, see  [Controlling Edit in Excel on list pages](devenv-edit-in-excel-lists.md).
 - Media and image fields only display in tile view.
 
 ## [Developer tips](#tab/tips)
@@ -85,6 +86,7 @@ From the user's perspective, the following are qualities of a well-designed list
 > [!IMPORTANT]
 > List pages are designed for using a single `repeater()` control within the content area only. If you include more than one repeater or another control like a `group` or `grid`, the page might not behave as expected. If you want to design a page that includes controls in the content area other than a repeater, then try using a `Worksheet` page type instead.
 
+
 ## [Designing for devices](#tab/targets)
 
 For the most part, mobile devices will display the same content as the [!INCLUDE[d365fin_web_md](includes/d365fin_web_md.md)], but it is presented in different way to suit how users hold and interact with their mobile device.

dev-itpro/developer/devenv-edit-in-excel-lists.md

@@ -0,0 +1,35 @@
+---
+title: Controlling Edit in Excel on list pages
+description: This article explains how to control the Edit in Excel system action on list pages.
+ms.date: 05/02/2024
+ms.topic: conceptual
+ms.reviewer: solsen
+ms.author: kepontop
+author: kennienp
+---
+
+# Controlling Edit in Excel on list pages
+
+This article explains how the system action Edit in Excel appears on list pages. The **Edit in Excel** action is a system action that allows users to open a list page in Excel and edit the data in Excel and then publish the changes back to [!INCLUDE [prod_short](includes/prod_short.md)]. 
+
+## Default behavior for visibility of the Edit in Excel action
+
+For a list page in an app or per-tenant extension, the **Edit in Excel** action is visible for users with the right permissions. The user can select the **Edit in Excel** action from the action bar on the list page by selecting the system action icon :::image type="content" source="media/SystemActionIcon.png" alt-text="The system action icon":::.
+
+## Turning off Edit in Excel with permissions
+
+As an admin, you can exclude permission to the **Edit in Excel** action for users who you don't want to have access to the feature. The following permission sets control Edit in Excel: 
+
+- `EDIT IN EXCEL - VIEW`
+- `EDIT IN EXCEL-ADMIN`
+- `EXCEL EXPORT ACTION`
+
+## How to set up Edit in Excel for on-premises (and Docker sandbox) environments 
+
+The **Edit in Excel** action isn't enabled by default for on-premises (and Docker sandbox) environments and without extra setup, the **Edit in Excel** action doesn't show on list pages that would usually include the action. 
+
+For more information on how to enable the action for on-premises (and Docker sandbox) environments, see [Setting up the Business Central add-in for Excel (on-premises)](../administration/configuring-excel-addin.md).
+
+## See also
+
+[Setting up the Business Central add-in for Excel (on-premises)](../administration/configuring-excel-addin.md)