For the complete documentation index, see llms.txt. This page is also available as Markdown.

▪️Missions Lootbox Skin

With the Generic skin in the Mission Lootbox, you have the flexibility to add your own images directly from the BO. Additionally, you can customize the colors of the cards. Below is a list of the customizable images:

  • Custom section background image for desktop

  • Custom section background image for mobile

  • Image for closed box

  • Image for locked box

  • Image for opened box

Back-Office Setup

To configure the Generic skin:

  1. Go to Gamification → Custom Sections.

  2. Create or edit a section with Section type set to Missions Lootbox.

  3. Under Section setup, select Generic in the Theme dropdown.

  4. Upload your image package .zip file into the Skin images field.

  5. Add any custom style rules into the Custom CSS editor.

  6. Link your scheduled daily missions under the Missions tab.

Image Package Specifications & Required File Names

When preparing custom skin images for upload, all files must be in PNG format and saved with the following exact file names:

  • desktop-bg.png — Background image for desktop screens.

  • mobile-bg.png — Background image for mobile screens.

  • closed-mission-icon.png — Box icon displayed on available cards before they are opened.

  • locked-mission-icon.png — Box icon displayed on upcoming locked cards.

  • opened-mission-icon.png — Box icon displayed behind the reward graphic once a card is opened.

Place the files directly in the root of a .zip archive without subfolders. If any image file is missing or fails to load, the widget automatically falls back to the default generic skin asset.

Below you can find a reference package with the images:

Open

You can further customize certain elements by applying your own CSS. Below are some helpful styles to get you started:

Additional CSS Selectors for Card States and Elements

You can also target specific card states, countdown timers, and reward graphics:

Read more about the Missions Lootbox in:

Frequently Asked Questions

Q: Can I customize the completed (checkmark) and missed (X) corner status icons?

A: No. The completed checkmark and missed icons in the top-right corner of the cards are built-in platform assets and are not replaced by the skin ZIP package. However, you can adjust the corner backgrounds and card borders using Custom CSS.

Q: What happens if an image is missing from the uploaded ZIP file?

A: If any of the 5 required image files (desktop-bg.png, mobile-bg.png, closed-mission-icon.png, locked-mission-icon.png, opened-mission-icon.png) is missing from the ZIP archive or fails to load, the widget automatically falls back to the default generic skin image for that asset.

Q: Why is the CTA button not appearing on the opened card?

A: The CTA button (.cta-lootbox) only renders on opened cards when both the CTA Button Text and CTA Button Action (deep link or URL) are configured within the linked mission settings in the Back-Office.

Q: Where do the reward icons on the opened cards come from?

A: The reward image displayed in the center of an opened card is taken from the individual mission's configured image, not from the skin ZIP package.

Last updated

Was this helpful?