Marketing Guide — Sports Library

Back to Hub

This guide explains how to use the Entain Sports Library and how to configure the Bannerflow widget to pull these images into your creatives.

1. The Asset Hub

URL: https://entain.koodestudio.com.br

This is the central page with every sports asset available, organized by sport and category.

What you'll find

Sport	Categories
⚽ Football	Team Shirts, 2D Players, Team Logos
🏈 American Football	Helmets 3D, Helmets 2D, Helmets SI, Team Logos
🏀 Basketball	Jerseys
🏒 Hockey	Logos
🌍 Global	Flags

Each card shows the asset count and the available variants (home/away, left/right, or single-variant when there is no variation).

How to copy the folder URL

Each card has a green Copy URL button at the bottom (under the "Bannerflow URL" label). Click it and the full folder URL goes to your clipboard. Paste it into the URL field of the Bannerflow widget.

Example: Copy URL on the "Team Shirts" card copies https://entain.koodestudio.com.br/football/shirts/

2. Listing page

Clicking the body of a card on the hub (anywhere except the Copy URL button at the bottom) opens the page that lists every asset in that category.

Each card shows

The asset's image
The team name (human-readable)
The actual filename on the server
Buttons: Copy Name, Delete

The "Copy Name" button

Copies the filename without the .png extension. This is exactly the value you paste into the widget's Team field.

File on the server	Copy Name copies
`aberdeen_home.png`	`aberdeen_home`
`aberdeen_away.png`	`aberdeen_away`
`corinthians.png`	`corinthians`
`pittsburgh-steelers_left.png`	`pittsburgh-steelers_left`
`germany.png`	`germany`

Uploading a new asset

Each listing page has an Upload button at the top. The filename must follow this pattern:

Multi-variant (shirts, jerseys, helmets, players-2d): slug_variant.png — e.g. chelsea_home.png, chelsea_away.png
Single-variant (logos, flags, helmets-si): slug.png — e.g. chelsea.png, brazil.png

Slug rule: lowercase, no accents, spaces become hyphens.
"São Paulo" → sao-paulo · "Borussia Dortmund" → borussia-dortmund · "FC Köln" → fc-koln

Deleting an asset

Use the Delete button on the card. You'll be asked to confirm twice to prevent accidents. Note: this deletes directly from the server — there is no recycle bin.

3. Configuring the Bannerflow widget

You need the "Sport Dynamic Widget" (already created by the technical team). If it doesn't appear in your widget list, contact design ops.

Step by step

Add the widget to your creative in Bannerflow.
In the Widget properties panel (right side), fill in:

Field	What to put	Example
Team	Paste what "Copy Name" gave you	`aberdeen_home`
URL	Paste what "Copy URL" gave you	`https://entain.koodestudio.com.br/football/shirts/`
Background Size	How the image fits	`100%` (default)
Background Position	Where the image is positioned	`Center Center` (default)

The image appears automatically in the widget. If you see a grey "Not Found" placeholder, check the steps below.

Full workflow

Open https://entain.koodestudio.com.br
Click the card for the category you want (e.g. "Team Shirts")
Find the team you need in the grid
Click Copy Name → e.g. aberdeen_home
Paste it into the widget's Team field
Go back to the main hub
On the right category card, click Copy URL
Paste it into the widget's URL field
Done — the widget renders the image

4. Common errors

"Not Found" appears in the widget

Symptom	Cause	Fix
I typed the team by hand and it doesn't work	Slug mismatch (accent, space, casing)	Use Copy Name, don't type
I put `home` in a separate field	The variant must be inside Team along with the slug	Instead of `aberdeen`, paste `aberdeen_home`
URL ends in `list.php`	The URL must point to the folder, not the listing page	Use Copy URL from the main hub, not the address bar
Works for some teams but not others	That team may have a different slug than expected	Open the hub and check the actual filename on the card

The team I need isn't in the library

Open the listing page for the category
Upload the PNG following the naming rules
It appears immediately for everyone

5. Troubleshooting: "Could not update versions"

If you see one of these errors in Bannerflow when saving a banner version:

Http failure response for https://api.bannerflow.com/studio/api/graphql: 400 OK
Could not update versions
In the browser console: [Versions] updateVersionsFailure: Default version is missing version properties

Why it happens

The widget tried to load an asset URL that doesn't exist on the hub — usually because the team slug in the widget's Team field has a typo (e.g. fluminens instead of fluminense). The image fails to load, Bannerflow's image-optimizer returns 400, and the version save fails because the widget never resolves with a valid image.

Why the error keeps appearing even after fixing the slug

Bannerflow's image-optimizer caches the 400 response for the broken URL, and that cache is tied to your browser cache (confirmed by Bannerflow support). So even after you correct the slug, the old failed requests keep replaying from cache and show up as red errors in the console.

How to fix it

Confirm the slug is correct. Open the hub, find the team, and use the Copy Name button on the card. Never type slugs manually.
Paste the correct slug into the widget's Team field, replacing whatever was there.
Hard refresh the browser: Cmd+Shift+R (Mac) or Ctrl+Shift+R (Windows). This clears both the browser cache and Bannerflow's optimizer cache for your session.
Reload Bannerflow Studio and try saving again.

How to prevent it

Always use Copy Name from the hub. Every asset there is guaranteed to exist with the exact filename shown. As long as the slug comes from the hub, this error won't happen.

6. Cheat sheet

HUB:        https://entain.koodestudio.com.br
COPY URL:   on the main hub (cards) → paste into widget "URL"
COPY NAME:  inside a listing page (cards) → paste into widget "Team"

Never type the fields manually. Always use the copy buttons.

Questions or bugs? Reach out to Mauricio Zinser or the design ops channel.

Back to Hub