Key App Assets

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 LG Smart+ 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. Instead of these icon files, the uploaded app icon image (400x400 pixels) at the seller lounge is used as both the small icon and the large icon by auto-resize at LG Content Store.

Icon color and padding guide

App Icon Design Guidelines

  • If the app icon is in the horizontal orientation, no padding is required around the app icon.

  • 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

LAUNCHER BACKGROUND IMAGE (Required)

1920 x 1080,

PNG

bgImage

On the screen, when the user hovers over an app tile in the Launcher

SPLASH SCREEN BACKGROUND IMAGE (Required)

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 the Seller Lounge, the app needs to be repackaged using PNG images and resubmitted.

Background Image Design Guidelines

  • Avoid placing an object on the TOP 200 px and BOTTOM 200 px of the image.

  • Use minimal text inside the image.

  • Use an image that represents your brand, NOT a specific piece of content.

  • Should NOT include your icon and logo.

  • Select what could entice the viewer to click and launch the app.

Good and bad examples of the background image

App Splash Image Guidelines

  • Use an image that progresses from the launcher preview into the landing page of the app if possible. For example, the splash could use elements of the UI from the first screen of the app.

  • Should NOT be a black screen.

  • Should NOT be identical to the background image.

  • 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