Skip to main content

Metadata Integration

Metadata-driven artwork follows the game selected in HyperSpin. Build one layout, then test the layout against several games from your library.

Add a metadata image​

  1. Open a game-theme project with a system assigned.
  2. Select Add an image from game metadata in the bottom toolbar.
  3. Select the new layer.
  4. Choose the artwork type in Properties.
  5. Use the game picker to review available game media.
  6. Set position, size, and scale.

The toolbar shows metadata-image tools where the project type supports them.

Choose artwork​

Available image types include:

  • Boxes - 2D
  • Boxes - Back
  • Game Media - 2D
  • Logos - Game
  • Backgrounds - Game
  • Backgrounds - System
  • Marquees - Game
  • Snaps - Gameplay

The editor filters choices for the current project context. Use the visible options rather than typing an arbitrary field name.

Fit the image​

  • Stretch fills the chosen dimensions.
  • Contain preserves the artwork's proportions inside the chosen dimensions.

Set width and height, then review several games with different artwork shapes. A portrait box and a wide logo need different layouts.

Metadata images also support drop-shadow settings.

Game details and text​

HyperSpin's metadata display has its own settings in HyperHQ. Choose displayed fields and appearance under Settings > Metadata.

A normal text layer holds authored text. Typing {GameName} or {GameArt} into ordinary text does not establish a metadata binding.

Use the supported metadata layer or frontend metadata setting for the information you want to display.

Video snaps​

Use the dedicated video-snap layer for gameplay video. A metadata image is an image layer.

See Special Layers for media resolution and playback behavior.

Test the finished theme​

  1. Preview with a game containing the selected artwork.
  2. Compare a game with different artwork proportions.
  3. Check a game missing the selected media.
  4. Publish the theme.
  5. Test selection changes in HyperSpin.

HyperSpin resolves installed media and overrides. Missing artwork needs a media check in HyperHQ.

Common fixes​

The image stays empty​

Check the selected game, artwork type, and installed media. Review Media Audit.

The tool is missing​

Check the project type and system assignment. Metadata tools depend on project context.

Artwork looks distorted​

Choose Contain or revise the layer's dimensions.