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 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 Mobile@Work. Branding requires Mobile@Work 9.5.0 for Android through the most recently released version as supported by MobileIron.

On iOS and macOS devices, Apps@Work is either:

• a web clip provided by MobileIron Core
• The assets that you specify are applied to the web clip.
• the Apps@Work container app, a MobileIron 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 Admin Portal are applied. The app icon you specify in the 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
• Core 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 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 1. 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 NOTE: 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 Apps@Work Container for iOS.
App Name	• Below the home page icon • Below the splash screen icon • In the main menu of 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 2. 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

On the Admin Portal, in Policies & Configs > Configurations, MobileIron Core 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.

Core upgrade impact to Apps@Work branding

The following table shows how the more limited Apps@Work branding support in MobileIron Core versions prior to 9.5.0.0 are impacted after upgrading to this version of MobileIron Core:

 

Table 3. Core upgrade impact to branding

Feature prior to Core 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 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.

NOTE:

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 macOS, iOS, and Android devices with your own enterprise app store branding. The changes made affects the client Home screen, Splash screen, and App Home Screen.

Procedure 

1. In the Admin Portal, go to Apps > Apps@Work Settings.
2. In the App Storefront Branding section, select Custom Branding.
3. In the Customize App Storefront > App Icon section, click Replace Icon.
4. Navigate to and select your custom image for the app icon and then click Upload.
   

5. In the App Name section, enter your custom app name.

   NOTE:

   The app catalog name you enter applies to Android, iOS, and macOS.

6. 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.
7. 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 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 4. Is Home page icon and name automatically updated?

	Prior to Android 5.0	Android 5.0 - 6.0	Android 7.0 through the most recently released version as supported by MobileIron
non-Samsung devices	Yes, update is automatic.	No	No
Samsung devices	Yes, update is automatic.	Yes, update is automatic.	No

NOTE:

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 Mobile@Work.
3. Tap the menu icon.
4. Tap Settings > Check for Updates.