Skip to main content
Skip table of contents

App Customization profiles (UI)

Configuring the App Customization profile

There are two pre-defined themes you can use for the App Customization screens:

  • Blue Cedar default: Includes the Blue Cedar logo and color scheme. This is the default theme provided when you create a new App Customization profile.
  • Device default: Uses the default color scheme for the device (usually black and white or gray) and no logos. To get this theme, you can either apply no App Customization policy, or you can create an App Customization profile (which starts with the Blue Cedar default), then clear all the color values and choose None for the images.

Use an App Customization profile to set these options with the App Customization policy. (See Policy profiles for general information about managing policy profiles.)

Click Apps, then Android or iOS, then the app you want to secure. The App details screen appears.

Click the settings gear on the App Customization panel. The Policy details page appears, where you can create a new profile or edit an existing profile. 

On the Policy details page, click + App Customization Profile to create a new profile, or click the pencil icon next to an existing profile to edit it.

On the App Customization profile page, enter the Profile name and description, then select the desired options. (Note that there may be variations on different devices.)

Policy optionDescription
Background Options

To customize the background of the Blue Cedar screens, choose Background Color, Background Image, or both:

  • Background Color: To change the color of the background on the Blue Cedar screens, choose a color from the background color menu or enter the hex color value in the background color box.
  • Background Image: To apply an image to the background on the Blue Cedar screens, choose one of these options:
    • Default: Use the Blue Cedar default background image or color.
    • None: Use the default device color scheme (or the background color, if one is defined) with no image.
    • Custom: Click Choose File to select the image file (PNG or JPEG). The background image must be at least 1024 px in one dimension. It will be scaled to fit the device screen. If the image you choose has a transparent background, the background uses the color specified in Background Color. (If the image is not transparent, the image appears on top of the background color.)
Logo Image

To select a logo to appear on the Blue Cedar screens, choose one of these options:

  • Default: Use the Blue Cedar logo.
  • None: Clear any logo images.
  • Custom: Click Choose File to select the image file (PNG or JPEG). The logo image must have either a horizontal or vertical dimension of 512 px. The logo never has its aspect ratio changed.
Font Color

To change the color of the font on the Blue Cedar screens, choose a specific color from the Font Color menu or enter the hex color value in the Font Color box.

Primary Button ColorTo change the color of the primary button on the Blue Cedar screens (for example, the OK button), choose a specific color from the Primary Button Color menu or enter the hex color value in the Primary Button Color box.
Secondary Button ColorTo change the color of the secondary button on the Blue Cedar screens (for example, Reset), choose a specific color from the Secondary Button Color menu or enter the hex color value in the Secondary Button Color box.
Translation StringsTo translate or customize the strings that are displayed to mobile app users, you can upload a JSON file containing strings to replace default Blue Cedar strings. Select "Use custom translation strings" to enable customization. See Custom translation strings for details.
MiscellaneousTo display a "Secured by Blue Cedar" banner at the top of the Blue Cedar screens, check Display 'Secured by' Bar.

Applying the App Customization policy

Click Apps, then Android or iOS, then the app you want to secure. The App details screen appears.

Under Policies to apply, click the triangle to expand the App Customization panel. 

Select "Enable App Customization policy."

Choose the App Customization profile from the menu.

Click Apply Policies.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.