The discussion in https://magnolia-cms.slack.com/archives/C02RDRV2N2E/p1661236730707299

has led to the conclusion that we should split the current page

https://docs.magnolia-cms.com/product-docs/6.2/Apps/App-configuration/App-launcher-layout.html

to two new pages:

• App Launcher layout
• Compatibility App Launcher layout

where we would make it clearer how to configure the layouts:

• App Launcher layout - the modern layout, under the layout node (from a yaml file), but currently with a bug in the impossibility of configuring app permissions (Property [permissions] not found in class [info.magnolia.admincentral.layout.DefaultGroupDefinition] - see ADMINCTR-213)

• Compatibility App Launcher layout - under the compatibilityLayout node (from a yaml file), basically reusing the https://documentation.magnolia-cms.com/display/DOCS57/App+launcher+layout, but where the permissions property can be used for app groups. Here, however, a JCR-based configuration under appLauncherLayout may exist (be added) as well, but will take precedence over the one under the compatibilityLayout node.

After the users will have migrated their layout configs, and also in the 6.3 context, we will be able to ditch the Compatibility App Launcher layout page.

NOTE:  For 6.2.22 release bringing the new layout, it was decided to use the compatibility by default and let customers change to the new one if they want to.