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:

• Apps@Work custom branding assets
• Apps@Work custom icon requirements
• Apps@Work custom app color requirements
• Relationship of Apps@Work branding with iOS or macOS web clip configuration
• Ivanti EPMM upgrade impact to Apps@Work branding
• Configuring Apps@Work branding
• Android OS limitations to updating the Apps@Work home page icon

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 4.   Apps@Work branding assets usage

Asset	Android use	iOS use
App Icon	As the home page icon In the splash screen	As the home page icon In the splash screen 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	Below the home page icon Below the splash screen icon In the main menu of Ivanti Mobile@Work In the navigation bar at the top of the display	Below the home page icon Below the splash screen icon
Text color	Splash screen Navigation bar Home, Categories, and Updates tabs (lighter shade of selected color) Buttons Selectable text Search and review text field borders Carousel pagination dots	Splash screen Various button text, such as install, download, and update Top and bottom borders (lighter shade of selected color)

Apps@Work custom icon requirements

The following table gives the requirements for the custom-branding of Apps@Work app icons.

Table 1. 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 

1. In the Ivanti EPMM Admin Portal, go to Apps > Apps@Work Settings.
2. In the App Storefront Branding section, select Custom Branding.
3. Select the Integrated App Catalog tab.

4. 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.

5. Select the Standalone App Catalog tab. In the Icon section, click Replace Icon.
6. Navigate to and select your custom image for the app icon and then click Upload.
   
7. 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.
8. Click Save.

Related topics 

• Apps@Work custom icon requirements
• Apps@Work custom app color requirements

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 6.   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 

1. Manually remove the existing home page icon (shortcut) for Apps@Work.
2. Launch Ivanti Mobile@Work.
3. Tap the menu icon.
4. Tap Settings > Check for Updates.