Internal Image key/value pair group | NAGRAVISION Documentation Portal

Overview

An Internal Image key/value pair group indicates to the client this is a group containing information for an image accessed via the platform’s internal ImageService.

Example extendedAttributes block

For a rail or custom component that has a Internal Image key/value pair group instance attached to it, the extendedAttributes block will look like this:

JSON

...
"extendedAttributes": [
  {
    "reference": "87900d25-e4b3-4625-a804-07d41edaaf81",
    "instance": "Amazon Prime Image",
    "alt_text": "prime video",
    "type": "internal_image",
    "blueprintId": "7d603624-f11b-4e2c-b235-dacf14931612",
    "image_type": "logo"
  }
],
...

Fields

The fields for the Internal Image key/value group are as follows:

Keys	Type	Values	Description
`reference`	string		The reference to an internal image stored within the platform’s image service. This is the default image for the `image_type`.
`instance`	String	N/A	The name of the instance of the KVP group
`alt_text`	string		The `alt_text` field provides alternative text for the logo, intended to describe the logo for users who rely on screen readers, such as TalkBack. This ensures accessibility for visually impaired users by providing a meaningful description of the logo's content or purpose. The text should be clear, concise, and relevant to the brand or application, allowing users to understand what the logo represents. For localisation, use the format `"i18n.alt_text.{locale}"` in the `client_context` field to define translations for each locale. The `client_context` array should include entries like `"i18n.alt_text.en_GB": "Spotify logo"` and `"i18n.alt_text.ja_JP": "スポティファイロゴ"`, ensuring the alt text is appropriately localised across regions and languages.
`type`	static	`internal_image`	The `type` field defines the category of KVP group. The `internal_image` value indicates to the client this is a group containing information for images accessed via the platform’s internal image service.
`blueprintId`	String	N/A	The blueprint ID for the KVP group that this is an instance of
`image_type`	enum	`logo,` `banner,` `background`	The `image_type` field specifies the category of image being defined within the group. This helps differentiate between various visual elements used within the UI. logo – represents a logo, typically used as a small, recognisable mark placed within the rail or on content tiles. banner – represents a wider branding element, often spanning across sections of the screen rail to provide stronger brand association. background – represents a full-background image, used to set the overall visual theme behind the rail’s content.