Background Color (RGB) or Image for PDF Display

Supported In:

Kiosk Pro Basic, Plus and Enterprise

Set a custom color or background image when a PDF is not specifically sized to fill the iPad's screen.

Default: 0,0,0 (black)

This setting also controls the background image shown in the multi-page PDF view accessed through the navigation bar.


The color must be set in RGB decimal format, separated by commas. This setting will not accept hexadecimal format. An extensive list of colors in RGB decimal format is available here.


Images must be locally stored in JPG or PNG format. If you are using a single image file as a background across multiple pages, you can also use the same image file for a loading background, which should significantly decrease (or possibly eliminate) any loading flicker you might otherwise see.

If the image file is smaller than the screen, the image will automatically repeat horizontally and vertically to fill the screen.

Values for Remote Settings Control & Managed App Configuration

Key pdfBackgroundImageFile
Key Type string
Default Value 0,0,0
  • 255,255,255 = white
  • photo.png = path to a local image file

Change Log

  • Added in version 6.7

Still stuck? How can we help? How can we help?