App launcher layout

The App launcher is a key navigation page in Magnolia that you can access using the App launcher icon icon to the right of the Find Bar at the top of every page.

App launcher layout

The App launcher layout organizes apps into groups and defines what the groups look like.

You can use both YAML and JCR to configure the App launcher. Apps defined in YAML will always appear before those defined in JCR.

Example definitions

You can configure the App launcher via decoration:

magnolia-personalization-personas-app/src/main/resources/personalization-personas-app/decorations/admincentral/config.yaml
appLauncherLayout:
  hiddenApps:
    - notifications
  groups:
    - name: target
      apps:
        - name: personas-app

To specify the order of apps, provide a complete list of apps in a group using the !override directive:

magnolia-personalization-segmentation-app/src/main/resources/personalization-segmentation-app/decorations/admincentral/config.yaml
appLauncherLayout:
  groups:
    - name: target
      apps: !override
        - name: preview-app
        - name: personas-app
        - name: segmentation-app

App launcher properties

Property Description

groups

required

List of app groups.

     <group‑name>

required

App group name. This internal name is not displayed to users. Users see the group label instead.

         apps

required

List of apps in the group.

             <app‑name>

required

Name of an app that belongs to the group. The name must match the name given in the app configuration (for example, pages).

         permissions

optional

Defines which users can see the app in the App launcher. This allows you to provision the app to a limited group of users in your organization.

         clientGroup

optional, default is false

Moves the group to the bottom of the App launcher and sets the group color to white. Set the property to true when you create your own app groups. This way they will stand apart from Magnolia native apps, and editors can identify them as your company’s apps.

         label

optional

Text displayed on the group tile. Use a label that says something about all apps in the group such as Edit or Manage. Magnolia converts the text to all caps.

defaultGroup

optional, default is edit

Defines the group where a new app is added automatically, provided the app has not been added to another group of the App launcher.

During installation, Magnolia sets the value of the defaultGroup property to edit. During an update, it is set to edit only if the property has not been set already.

hiddenApps

optional

List of apps to be hidden in the App launcher.

     <app-name>

optional

Name of an app that should not be shown in the App launcher. The name of the property is arbitrary.

Example

Change pages to pages-app to fall back to the compatibility version of the app. Remember to log out and back in to see any changes in the App launcher.

Related topics
Feedback