Apps@Work branding
You can brand Apps@Work on iOS, macOS, and Android devices with your own enterprise app store branding. To brand Apps@Work, you specify the branding assets in the Ivanti EPMM Admin Portal in Apps > Apps@Work Settings. The assets that you specify are:
- App Icon
- App Name
- Text color
On Android devices, Apps@Work is part of Ivanti Mobile@Work. Branding requires Ivanti Mobile@Work 9.5.0 for Android or newer versions.
On iOS and macOS devices, Apps@Work is either:
- A web clip provided by Ivanti EPMM
- The assets that you specify are applied to the web clip.
- the Apps@Work container app, an Ivanti EPMM app which you rebrand and sign (iOS MDM devices only).
- For the Apps@Work container app, only the app name and app color that you specify in the Ivanti EPMM Admin Portal are applied. The app icon you specify in the Ivanti EPMM Admin Portal is not used. Instead, the app uses the app icons you provide in the Apps@Work container app package.
This section includes the following sub-sections:
Related topics
- The tech note Ivanti Apps@Work Container for iOS
Apps@Work custom branding assets
The following table describes the Apps@Work branding assets that you can provide and how they are used:
Table: Apps@Work branding assets usage
Asset | Android use | iOS use |
|---|---|---|
App Icon |
|
If you use the Apps@Work container app for iOS, rather than the provided web clip, this icon is not used. See the tech note Ivanti Apps@Work Container for iOS. |
App Name |
|
|
Text color |
|
|
Apps@Work custom icon requirements
The following table gives the requirements for the custom-branding of Apps@Work app icons.
Table: Requirements for app icons
Icon | Dimensions | Format | iOS resolution scale factor | Android densities |
|---|---|---|---|---|
App Icon | 1024 x 1024 | PNG | @1x, @2x, or @3x | mdpi, hdpi, xhdpi, xxhdpi, or xxxhdpi |
Apps@Work custom app color requirements
For Apps@Work custom branding, you can provide the app color. You can either click on a color box to select a color, or enter the color directly as a # symbol following by either three or six of the following characters:
- 0 through 9
- A through F
Six characters specify a hex color code. A hex color code contains three pairs of hexadecimal numbers, in which each pair represents the intensity of red, green, or blue (RGB). The characters 00 represent the lowest intensity of a color, and the characters FF represent the highest intensity.
For example:
- #FF0000 is red
- #00FFFF is aqua
- #FF00FF is fuchsia
Three-character color codes are shorthand for six-character codes. For example, #84D is the shorthand for both #8042D1 and #8040D0, although the six-character codes represent different shades.
IMPORTANT: Try your app color code on iOS and Android devices. Make sure you do not choose a color that is hard to see, or easily confused with typical color usage, such as gray for disabled buttons.
Relationship of Apps@Work branding with iOS or macOS web clip configuration
In the Ivanti EPMM Admin Portal, in Policies & Configs > Configurations, Ivanti EPMM provides a default web clip configuration for Apps@Work named System - iOS Enterprise AppStore. Because you provide the custom app name and app icon in Apps > Apps@Work Settings, you cannot edit the Name or Icon fields in the web clip configuration. You also cannot edit the Address/URL field.
Ivanti EPMM upgrade impact to Apps@Work branding
The following table shows how the more limited Apps@Work branding support in Ivanti EPMM versions prior to 9.5.0.0 are impacted after upgrading to this version of Ivanti EPMM:
Table 5. Ivanti EPMM upgrade impact to branding
Feature prior to Ivanti EPMM 9.5.0.0 | Impact after upgrade |
|---|---|
For iOS devices, you could upload a banner icon. | The icon displays as an App Icon in the Ivanti EPMM Admin Portal in Apps > Apps@Work Settings page. |
You could modify the Apps@Work name and app icon in the web clip configuration for Apps@Work, which is named System - iOS Enterprise AppStore | Your modifications to the name and icon display in the web clip configuration, but cannot be modified. Enter modifications in Apps > Apps@Work Settings. |
After upgrade, iOS devices continue to use existing custom branding settings, if any, until you save custom branding settings in Apps > Apps@Work Settings. Any new customization will result in updating the splash screen to white, however, the App Icon and App Text will be preserved.
Configuring Apps@Work branding
You can brand Apps@Work on devices with your own enterprise app store branding. The changes made affects the client Home screen, Splash screen, and App Home Screen. "Apps@Work" is the default name for branding.
Procedure
- In the Ivanti EPMM Admin Portal, go to Apps > Apps@Work Settings.
- In the App Storefront Branding section, select Custom Branding.
- Select the Integrated App Catalog tab.
- In the Customize App Storefront > App Name section. Enter the custom name you want to display in the App Catalog tab within Ivanti Mobile@Work. The App Name will display at the top of the screen, above the "All Apps" tab, and in the small tab at the bottom of the Ivanti Mobile@Work screen.
The App Catalog name you enter applies to iOS only.
- Select the Standalone App Catalog tab. In the Icon section, click Replace Icon.
- Navigate to and select your custom image for the app icon and then click Upload.
- In the Text Color section, click on the color box to select a color, or enter the three or six character color code for your custom app color.
- Click Save.
Related topics
Android OS limitations to updating the Apps@Work home page icon
When you change the Apps@Work app icon or app name, whether Ivanti Mobile@Work for Android can automatically update the icon and name on the home page depends on the version of Android running on the device. The following table summarizes for which Android versions the home page update is automatic.
Table: Is Home page icon and name automatically updated?
| Prior to Android 5.0 | Android 5.0 - 6.0 | Android 7.0 or newer versions |
|---|---|---|---|
non-Samsung devices | Yes, update is automatic. | No | No |
Samsung devices | Yes, update is automatic. | Yes, update is automatic. | No |
Updates to the app name, app color, and app icon inside the Apps@Work app are automatic on all versions of the Android OS.
When the update is not automatic, the device user can manually update the new home page icon and name by doing the following steps.
Procedure
- Manually remove the existing home page icon (shortcut) for Apps@Work.
- Launch Ivanti Mobile@Work.
- Tap the menu icon.
- Tap Settings > Check for Updates.