Icon, Background, and Description

To run your app on webOS TV, you must include the assets listed below in your app. These assets ensure that your app is branded correctly in the design that is consistent with the webOS TV system UI, and other 3rd party apps.

App Icons for a Regular webOS TV

Asset

Specification

Appinfo.json property

Location

SMALL APP ICON (Required)

80 x 80,

PNG

icon

  • In system notifications

  • In the launcher app tile (in webOS TV 1.0)

In webOS TV 1.0, this type of icon is displayed as 100 x 100 px.

LARGE APP ICON (Required)

130 x 130,

PNG

largeIcon

  • In the top left corner of the screen, when the user hovers over an app tile in the Launcher.

  • In the launcher app tile (in webOS TV 2.0)

In webOS TV 2.0, this type of icon is displayed as 115 x 115 px.

The icon files are required for app submission but used for app testing only. In LG Content Store, the icon file of 400x400 pixels, you upload separately at LG Seller Lounge, is used instead of this property after auto-resizing.

App Icon Design Guidelines

  • It is recommended that small and large app icons be identical to each other. This makes it easier for users to identify the apps.

  • Small and large app icons are always displayed on an app tile. The app tile color should be the same for small and large app icons.

App tile color and padding guide

Background Images

Asset

Specification

Appinfo.json property

Location

SPLASH SCREEN BACKGROUND IMAGE (Required)

1920 x 1080,

PNG

splashBackground

On the screen, when the webOS TV is loading an app

From webOS TV 2015 models, the PVR format is not available for Launcher Background Image and Splash Screen Background Image. If you already have submitted an app using PVR images to LG Seller Lounge, the app needs to be repackaged using PNG images and resubmitted.

App Splash Image Guidelines

  • Should NOT be a black screen.

  • Use minimal text inside the image to avoid localization problems. 

Good and bad examples of the app splash image

App Colors

Asset

Specification

Appinfo.json property

Location

APP TILE COLOR (Required)

HEX VALUE

iconColor

The background color of the app tile. The app tiles are displayed in the Home, Launcher, and Recent screens.

App Information Description

Asset

Specification

Appinfo.json property

Location

APP NAME (Required)

<= 20 characters

title

  • In the top left corner of the screen, to the right of the app icon, when the user hovers over an app tile in the Launcher

  • In system Notifications

  • In the Recent screen's Current Card Info tile

APP SECONDARY DESCRIPTION (Optional)

<= 60 characters

appDescription

In the top left corner of the screen, below the app name, when the user hovers over an app tile in the Launcher

VIEW TITLE

<= 60 characters

The View Title is dynamically provided by the app. There is no appinfo.json property for View Title. If the app does not provide a View Title, it is left blank.

  • In the Recent cards to the right of the app name. 

  • In the top left corner of the Home screen.

  • In the top left corner of the Recent screen.

App Description VS. View Title

  • The app description provides brief information about the app; think of it as a tagline for the app. For example, the app description for Netflix could be Watch millions of movies and TV shows anytime, anywhere.

  • The view title provides information about the user's current action or the on-screen content of the app. For example, the view title for Netflix could be the name of a movie that the viewer is currently watching (e.g., Kung-fu Panda 2).

  • The app description and view title should NEVER be the same. 

App Metadata and Key App Assets

You must also provide information about the key app assets in the app metadata file (appinfo.json). To learn more about appinfo.json, see appinfo.json.

Navigation