Launchpad settings
You can customize various launchpad settings, including, for example, entering a display name and description, configuring a custom login screen for users, configuring a PIN code screen for users, enabling an external chatbot functionality for the launchpad, and more. The following launchpad setting descriptions guide you to create a launchpad with settings that correspond to your specific business requirements.
General tab
Enter general settings for your launchpad.
General section
You can enter relevant names and descriptions, and assign a relevant development package for the launchpad.
General settings table
| Setting name | Setting description |
|---|---|
ID |
Technical ID automatically assigned to the launchpad after creation |
Name |
A meaningful name that refers to the launchpad artifact name within the system and is displayed in the URL path of the launchpad. |
Package |
Selection of development packages that you assign to the launchpad |
Launchpad Application |
Defines the standard underlying framework application |
Title |
The display title of the launchpad displayed to users on the user’s browser on runtime. The launchpad title is displayed to end users on the launchpad login screen, when enabled. |
Description |
The display description of the launchpad. The launchpad description is displayed to end users on the launchpad login screen, when enabled. |
UI5 section
You can use the UI5 section to load the relevant underlying OpenUI5 or SAPUI5 framework for the launchpad.
UI5 settings table
| Field | Purpose | Available Options/Examples | Notes/Constraints |
|---|---|---|---|
Version |
Determines which version of the OpenUI5 framework to load. |
|
For continuous compatibility, Neptune always recommends the most recent, long-term maintenance OpenUI5 framework version. |
SAP UI5 Module Path |
Allows specifying a custom path to an external SAPUI5 library. |
If your launchpad includes tiles running applications from an SAP system, those
apps might need SAP-specific UI5 libraries. Provide the path to the SAPUI5 library’s
resource file in the field. The path must point directly to the |
Cookies section
You can enable a cookie confirmation dialog with relevant title and messaging for the use of cookies on the launchpad.
Cookies settings table
| Setting name | Description |
|---|---|
Show Cookies Dialog |
Enables the display of a cookies dialog for the launchpad |
Title |
Specifies the cookies dialog message title that appears when the cookies setting is enabled |
Message |
Specifies the cookies dialog message body that appears when the cookies setting is enabled |
Blackout section
You can block the launchpad and enable the display of a blackout message informing the user that the launchpad is blocked.
Blackout settings table
| Setting name | Description |
|---|---|
Enable Blackout |
Enables the blackout setting for a launchpad |
Title |
Specifies the blackout message title that appears to the user when a user tries to access the launchpad when the blackout setting is enabled |
Message |
Specifies the blackout message body that appears to the user when a user tries to access the launchpad when the blackout setting is enabled |
Single App Launchpad section
You can choose to display only one application on your launchpad. All other applications and tiles that might have been selected are hidden when a setting in this section is selected.
Single App Launchpad settings table
| Setting name | Description |
|---|---|
Start Application |
Selection of defined UI5-based applications made in the App Designer in the system |
Start Web Application |
Selection of defined web applications in the system |
Launchpad Footer section
You can incorporate a custom footer for the launchpad that can include interactive buttons and other required controls defined as an application artifact in the App Designer.
Launchpad Footer settings table
| Setting name | Description |
|---|---|
Launchpad Footer |
Selection of defined custom footers made in the App Designer using the custom
|
Customization tab
You can customize the display of individual display elements and settings of the launchpad.
Accessibility section
You can enable accessibility settings so that users that require enhanced accesibility also can access and navigate the launchpad.
Accessibility table
| Setting name | Description | Default |
|---|---|---|
Show Focus Indicator |
For enhanced visibility, when a user selects Tab on a keyboard of an active launchpad in the user’s browser, an outline renders to highlight around the active tile or application of the launchpad. When a user continues to select Tab, the outline renders on the next tile or application in navigation. When a user selects Spacebar, the active tile or application opens. 
|
Yes |
Settings section
Settings table
| Setting name | Description |
|---|---|
Disable Splitview |
Disables the Splitview setting, and hides it from display in the settings pane of the launchpad. |
Disable Customizations |
Disables application-specific sizing and screen management on the main menu, hiding the following settings from display when right-clicking a tile/tile group/application:
|
Configure customizations for each individual device, e.g. mobile, tablet and desktop separately |
When enabled, Neptune DXP - Open Edition retrieves layout and formatting information for the launchpad on the basis of browser settings and form factor, for example, to influence dimension display on a desktop, tablet, or mobile phone respectively |
Disable redirecting user to home screen when hash navigation fails during navigation |
Does not redirect the user to the launchpad home screen when a user goes to an invalid URL when navigating in the launchpad |
Client Request Timeout (in seconds) |
Defines the time in seconds to be reached when a client request is terminated and a process is still not completed |
Enable Launchpad and Tile Trace |
Enables the launchpad and tile trace option to analyze launchpad and tile usage in the Launchpad Trace tool |
Enable Push Notifications |
Enables push notifications for the launchpad when Firebase is enabled so that the launchpad prompts the user to accept notifications. Enables Project ID and App ID for further configuration. |
Project ID |
Defines the project ID you produce when you enable Firebase (learn more about the project ID in Firebase) |
App ID |
Defines the application ID you produce when you enable Firebase (learn more about the application ID in Firebase) |
Launchpad Header section
Launchpad Header settings table
| Setting name | Description | ||
|---|---|---|---|
Hide Launchpad Header |
Hides the header toolbar of the launchpad |
||
Hide the Launchpad Header Back Button |
Hides the back button of the header toolbar of the launchpad |
||
Show Launchpad Title in Launchpad Header |
Displays the title of the launchpad in the header toolbar menu next to the inserted launchpad logo and/or back button |
||
Show Active App Title in Launchpad Header |
Displays the active application title of the launchpad in the header toolbar menu next to the inserted launchpad logo and/or back button |
||
Hide Launchpad Search |
Hides the launchpad search bar
|
Main Menu Display section
In the Main Menu Display section, you can choose whether the main menu of the launchpad is displayed in the header.
Main menu display settings table
| Setting name | Description | Default |
|---|---|---|
Show Main Menu in Header Toolbar |
Displays main menu items in the header toolbar of the launchpad |
Yes |
One-Line Top Menu |
Displays all header toolbar elements, for example, a company logo and further shell bar button names, on one line |
No |
Do Not Display Submenus on Hover |
Disables the display of individual main menu items in the header toolbar of the launchpad when a user hovers over them |
Yes |
Pin Main Menu to Left Side Bar |
Pins the main menu to the left side navigation of the launchpad. On small screens, the main menu slides out to view |
No |
Active Apps Display for Desktop section
Active apps display settings table
| Setting name | Description |
|---|---|
Pin Active Apps to Left Side Navigation |
Pins active apps to the left side navigation of the launchpad for easy access |
Show Active Apps in Header Toolbar |
Displays the active app in the header toolbar of the launchpad |
HTML Header tab
You can add scripts, stylesheets and other relevant content, that should be included in the launchpad HTML header area.
| Do not add launchpad-specific CSS to the HTML Header tab. Instead, use the dedicated Global Style tab and the Global Style tool. CSS that you add in Global Style is automatically added to the bottom below all SAPUI5 library code. |
Header content dependent of OpenUI5
SAPUI5 files are loaded asynchronously. The OpenUI5 framework adds content dynamically to the end of the HTML Header tab.
Start with an attachInit event handler to start the process when you have uploaded
all UI5 library files. Get the header tag and add your files to the header. Your
files appear below the UI5 files and the content is loaded after the UI5 content.
<script>
sap.ui.getCore().attachInit(function() {
var head = document.getElementsByTagName("head")[0];
var script = document.createElement("script");
script.type = "text/javascript";
script.src = "https://unpkg.com/axios/dist/axios.min.js";
head.appendChild(script);
});
</script>Stylesheet example:
<script>
sap.ui.getCore().attachInit(function() {
var head = document.getElementsByTagName("head")[0];
var link = document.createElement("link");
link.rel = "stylesheet";
link.type = "text/css";
link.href = "/neptune/public/application/neptune_launchpad_standard/css/app.css";
head.appendChild(link);
});
</script>Authentication tab
You can manage access to the launchpad according to company-specific authentication protocols, and customize the login screen of the launchpad for end users.
Login section
You can configure the display of a login screen through which a user must authenticate themselves according to the relevant authentication identity provider to access the launchpad.
Login settings table
| Setting name | Description | ||||
|---|---|---|---|---|---|
Default Provider |
Defines the default identity provider for the login screen for the user to authenticate themselves. The options you can select from are based on the authentication configurations created in the System Settings tool. |
||||
Custom Login Title |
Defines the custom title displayed on the login screen of the launchpad |
||||
Custom Login Subtitle |
Defines the custom subtitle displayed on the login screen of the launchpad |
||||
Custom Login App |
Defines the custom login application from the system to use as the login screen functionality for the launchpad. Neptune DXP - Open Edition provides a standard login application that is used by default. |
||||
Password Reset Email |
Selection of email templates in the system that can contain password reset instructions in the email body for the user to sign in to the launchpad |
||||
Hide Login Selection |
If you have created multiple authentication configurations in the System Settings tool for login to the launchpad, this option hides the dropdown menu for the login selection so that only the authentication configuration selected from Default Provider is displayed to select. |
||||
Hide Local Login Selection |
If you have created multiple authentication configurations in the System Settings tool for login to the launchpad, this option hides the local login selection from the dropdown menu |
||||
Enable Anonymous Access to Launchpad |
Enables anonymous access for a launchpad and its related applications. When you enable anonymous login for users, the provider of the launchpad generates a new user object for the session.
|
External Users section
Administrators can restrict self-registration to selected host domains. Users with an email address of a specified domain can request an activation code to sign in to the launchpad. See Enable self-registration in a launchpad.
External users settings table
| Setting name | Description | ||
|---|---|---|---|
Allow Self-Registration of Users |
Enables self-registration in the launchpad for users |
||
Email pattern |
Defines which host domains are allowed for self-registration, for example, |
||
Assign Roles |
Selection of roles in the system to assign to new users |
||
Assign Security Groups |
Selection of security groups in the system to assign to new users
|
||
Activation Code Email |
Selection of email templates in the system that can contain the activation code to sign in to the launchpad in the email body |
Language tab
Language section
You can customize language settings of the launchpad according to multilingual requirements.
Language settings table
| Setting name | Description |
|---|---|
Default Language |
Defines the language in which the login screen appears when the user access the launchpad. If you do not select any option, the launchpad applies the default language of the browser. When the user is signed in, the language set in the user profile is used. If the user’s language is not among the supported languages set in Users Can Select These Languages, the default language set in Default Language is used. |
Fallback Language |
Defines which fallback language to use, if the default language of the browser is not one of the supported languages from Default Language. When the user is signed in, the language set in the user profile is used. If the user’s language is not among the supported languages set in Users Can Select these Languages, the selected fallback language is used. |
Users Can Select These Languages |
Defines which languages the launchpad supports. If no languages are selected, all available languages from selection are supported by default. When the user is signed in, the language set in the user profile is used. If the user’s language is not among the selected languages, the language set in Default Language is used. |
PWA tab
Progressive Web App section
You can specify if the launchpad can serve as a progressive web application (PWA).
Progressive web app settings table
| Setting name | Description |
|---|---|
Enable PWA |
Specifies that the launchpad is a PWA. Enables the sections Autolock, PIN, and Progressive Web App for further configuration. Shows that the launchpad is a PWA in the Enable PWA column in the list of available launchpads in the Launchpad tool. |
Autolock section
You can enable an autolock function for the PWA if a user is inactive.
Autolock settings table
| Setting name | Description |
|---|---|
Enable |
Enable autolock setting for the PWA. |
Autolock on Idle in Seconds |
Number in seconds that must be reached on idle for the launchpad to return to the sign-in screen. |
PIN section
You can enable a PIN for the PWA. When a user signs in to the PWA, the PWA prompts the user to create and enter a PIN to access the launchpad of the PWA.
PIN settings table
| Setting name | Description | Default | ||||
|---|---|---|---|---|---|---|
Enable PIN |
Enables the PIN setting for the launchpad. Enables the fields PIN Length, PIN Tries, PIN Key Iterations, and Enable Passwordless Login with Public Key Authentication for further configuration. |
No |
||||
PIN Length |
Defines the number length of the PIN that the user can create when the user wants to access the launchpad. Contains the following options for selection:
|
4 numbers |
||||
PIN Tries |
Defines the maximum number of tries that a user can enter the PIN for before automatic signout. Number selection range between 1 and 10. |
5 tries |
||||
PIN Key Iterations |
Defines the number of PIN key iterations used to encrypt the PIN according to
the
|
40,000 PIN key iterations |
||||
Enable Passwordless Login with Public Key Authentication |
If a user’s device supports passwordless login with public key authentication, like, for example, authentication via biometric fingerprints or Face ID, enabling this setting allows users to log in to the launchpad securely without needing to enter a password. Instead, they can authenticate with a device, fingerprint, or security key, making accounts safer and easier to access. This modern approach protects against hacking and phishing. |
No |
Progressive Web App section
You can select display options for your PWA, including display mode, display icons or screenshots from the Media Library for different end devices, and influence the color scheme.
Progressive web app settings table
| Setting name | Description |
|---|---|
Display Mode |
Defines the display for the PWA for the end device of the user. Applies a meta tag to the display mode descriptor in the Web App Manifest. You have the following options:
|
Icon for All iOS devices |
Display icon for PWA with a recommended image size of 540px x 540px for all iOS devices |
Small Icon fo Android devices |
Display icon for PWA with a recommended image size of 192px x 192px for Android devices |
Large Icon for Android devices |
Display icon for PWA with a recommended image size of 512px x 512px for Android devices |
Desktop Vertical Screenshot Image |
Display screenshot for PWA with a recommended image size of 720px x 540px wide resolution for desktop |
Desktop Horizontal Screenshot Image |
Display screenshot for PWA with a recommended image size of 720px x 540px narrow resolution for desktop |
Theme Color |
Lets you select a custom color from the color picker for the theme of the PWA |
Background Color |
Lets you select a custom color from the color picker for the background of the PWA |
Global Style tab
Global Style settings table
| Setting name | Description |
|---|---|
Global Style |
Selection of defined custom CSS styling artifacts from the Global Style tool to apply to the launchpad. |
Layout tab
You can select launchpad layouts to control the appearance of the launchpad, for example, for a light and/or dark appearance.
Tile Group tab
You can select one or more tile groups to display in the launchpad.
Role tab
You can select a user role from the Role tool to the launchpad.
Enhancement tab
You can implement enhancement spots to use in launchpads and mobile clients. Enhancement spots are used to modify the standard Neptune DXP - Open Edition code to fit your specific requirements. Launchpad enhancement spots are grouped into the following categories:
-
Authentication: Authentication event-based enhancement spots
-
Common: Common event-based enhancement spots
-
Events: Tiles and launchpad event-based enhancement spots
-
Mobile/PWA: Enhancement spots only applicable for mobile
-
Push Notifications: Notification event-based enhancement spots
Chatbot tab
You can enable a chatbot in the launchpad. When enabled, the chat appears in the bottom right of the launchpad. You can choose either a chatbot from SAP (SAP Conversational AI) or IBM (IBM Watsonx Assistant).
| You must have a corresponding account to connect to the chatbot. |
SAP Conversational AI settings table
| Setting name | Description | Example |
|---|---|---|
Channel ID |
Defines the |
|
Token |
Defines the |
|
IBM watsonx Assistant settings table
| Setting name | Description | Example |
|---|---|---|
Integration ID |
Defines the configuration options object parameter |
|
Service Instance ID |
Defines the configuration options object parameter |
|
Region |
Defines the data center where you create your integration |
|