What happens when visitors click
Choose where matches, teams, competitions and players open, from a window over the widget to pages on your own site.
A widget is full of links: every match row, team name, competition and player in a lineup can be opened. The Navigation mode setting decides where each click opens. You find it in Entity navigation, in the right-hand column of the configurator. With a Match, League, Team or Player widget selected, the same section is called Match navigation, League navigation and so on.
The options at a glance
| Navigation mode | What the visitor sees | Best for |
|---|---|---|
| Modal (default) | A window opens over the widget. Closing it returns to the list. | Most sites, and any narrow column. |
| In-widget content | The widget itself shows the match, team or player, with a back arrow. | Full-width pages and club hubs. |
| Floating cards | What visitors click stays pinned in the bottom corner of the widget while they keep browsing. | Pages where people follow several live games. |
| Dynamic Pages | A normal link to a page on your own website. | A page of your own for every match, team, competition and player. |
| None (no entity links) | Nothing opens. The widget only shows information. | A single match in an article, or a sidebar. |
Plans
Choosing the mode needs a plan with advanced navigation. On other plans every click opens the modal, with its default look. The public playground opens with Floating cards so you can try them; a new configuration in the admin starts on Modal. Dynamic Pages also needs the add-on on the domain where the widget runs; see Dynamic Pages.
Modal
The modal is a window over the widget. A link inside it (for example a player in the lineup) replaces its content, and the back button in its header returns to the previous item. On phones the window is always a full-screen sheet; see On phones below.
The window takes the widget's theme, light or dark, also when your page uses the other one, and lightly dims the page behind it. For visitors whose device asks for reduced motion, it opens and closes without animation.
The window's header is the one of the item's floating card, one size larger. It keeps the header colours of your design: the match header's Color treatment for a match, and the entity header's Color treatment for a team, competition or player (with Entity color, the club or competition colour when the data provides one). Its text, buttons and focus ring switch to colours that stay readable on that background, and so does an affiliate button styled Outline, Soft or Link. With a neutral header it uses the card's surface, or the Entity surface bg colour when you set one. With the match header's Venue image on, the stadium photo sits behind it as on the match page. Its first row starts with the back button and ends with Minimize to floating card and the close button:
- Match: the minute or status (the day for an upcoming match, and the date once it is finished) and the competition. Then the teams around the score, or the kick-off time where the score will go, with the half-time score under it. Then the live stats, or the stadium. Goals and red cards follow in two rows, each team on its own side. Before or during a match with no goals or red cards yet, that space shows the teams' position and form instead.
- Team: its country, competition, position, points and coach, then the match it is playing, its last result from the past 12 hours or its next match, with its form.
- Competition: its name with the season selector, then the country, season and dates, then the current week and the leaders (for a past season, the champion).
- Player: club, position and number, country, age, height and foot on one line, then the season's matches, goals and assists.
While the item loads, a slim bar with the close button stands in for it. Pages that show a match, team, competition or player directly (a Match, League, Team or Player widget, In-widget content, or a page of your own site with Dynamic Pages) use the same header and tabs, with a few page-only extras; see Match, team, competition and player pages.
The header and the row of tabs under it are one piece, as on a floating card. Header and tabs, in the Item window settings of your design, sets how that piece sits in the window on tablets and desktops:
- Edge to edge: the header and the tabs run to the window's edges, and the header's top corners follow the window's. With the Carded layout, the sections below keep a small margin, as on a floating card.
- Card with border: the header and the tabs sit together in one rounded card with a border, with a margin around it.
- Card without border: the same card, set apart by its colour only. When your cards and the window are the same colour, it looks like Edge to edge with a margin.
- Follow layout preset (the default): the card, with your design's card border, for the Carded layout, and Edge to edge for Default and Edge.
A coloured header keeps its colour with every option, and the tabs stay on the card's neutral surface. Phones always use the full-screen sheet, edge to edge.
One frame, two sizes. The window has one frame control, Header and tabs above. Modal size (below) sets only the window's width, and Modal content inset adds space inside the frame you chose. The older Modal frame setting (Edge-to-edge or Carded) is no longer offered: it only added or removed the window's 1 px outline and unlocked the inset. A saved value keeps rendering as before.
| Setting | What it does |
|---|---|
| Modal size | Auto (2XL, sheet on mobile), from Small to 4XL, or Full screen. Applies on tablets and desktops; phones always get the full-screen sheet. |
| Modal anchor | Where windows and pop-ups (item window, search, settings, calendar) open. Inside the widget keeps them within the widget's area, scrolling with it. On the page lets them cover the whole screen. Auto (host decides) is the same as Inside the widget when you use the installation code. |
| Expand button | Expand to full screen (the default), Expand to widget or Off. Adds a button between Minimize to floating card and close; see Expand the window. Not on phones. |
| Modal header | Shows or hides the window's buttons (back, Minimize to floating card, expand and close) in the first row of the item's header. Off, the back, close and Minimize buttons float over the corners of the window, without the expand button. Phones always show their header. |
| Modal content inset | Extra space inside the window, 0 to 32 px, with any Header and tabs frame. With Edge to edge, the header and the tabs stay at the edges and only the content below them moves in. With the card frames, the header card and the content move in together. 0 keeps the frame as designed. With an inset above 0 the window drops its 1 px outline in the Default and Edge layouts. Not on phones. |
Expand the window
With advanced navigation, the window has a third button between Minimize to floating card and close. Visitors use it like the maximize button of a desktop window: the same button restores the window to its normal size.
- Expand to full screen (the default): the window fills the screen.
- Expand to widget: the window fills the visible part of the widget, never the rest of your page. While it is open it can cover a sticky header of your page that overlaps the widget. When less than 360 px of the widget is in view, the button stays but explains that there is not enough room.
- Off: no button.
The window keeps its content, scroll and focus; nothing moves on your page. It grows to its new size, and shrinks back, in under a fifth of a second. When the visitor's device asks for reduced motion, it changes size at once. The visitor's choice is remembered for that widget in their browser, and the next window of the widget opens the same way. The configurator's preview never remembers it. The button is not shown with Modal size: Full screen (the window already fills the screen), on phones (the window is already a full-screen sheet), in the sheet of pinned items on tablets, or with Modal header off.
Minimize to floating card. On tablets and desktops, with advanced navigation, every match, team, competition and player window has a Minimize to floating card button next to its close button. It pins the item to the floating area described below, so visitors can keep following it after closing the window. Phones do not have this button: there a card and a window would be the same size.
In-widget content
The widget replaces the list with the item the visitor clicked, and shows a back arrow to return. The browser's back button returns too. Nothing opens on top of your page.
Combine it with Widget height (in Global behavior) if the widget sits between other content: with a fixed height the widget scrolls inside itself, so opening an item does not make your page jump.
Floating cards
Floating cards let visitors pin what they click and keep browsing. Each pinned item follows its live score while the list stays usable.
On widgets 900 px wide or more
- A click opens the item expanded in the bottom corner of the widget: the whole match, team, competition or player in a compact form, with every tab. The header and tabs stay fixed and only the content scrolls.
- The card's header has three rows, like the window's, with the same header colours (the rest of the card keeps the card surface). A match card shows the kick-off time where the score will go, and the date once it is finished; your affiliate button sits at the end of its third row. A team card shows its country, competition and position, then the match it follows with its form. A competition card has its season selector in the first row. A player card shows the club's full name.
- Cards that fit side by side stay expanded: three when the widget is at least 1000 px wide, two between 900 and 999 px. The others become live chips in the pinned bar. Nothing is closed for lack of room.
- A chip keeps the essentials up to date: the score, the minute and the last key event. A team chip follows the team's live, last or next match, a player chip follows the match of the player's team, and a competition chip shows how many of its matches are live.
- Each card has Minimize (back to a chip), Open full view and Unpin. Clicking a chip restores it, and Escape minimizes the card that has focus.
- Hide pinned tucks the whole area away without unpinning anything, and Show pinned brings it back.
- Pinned items belong to the visit: they are cleared when the visitor reloads or leaves the page.
- A leagues column set to Right shows on the left while Floating cards is on, so the cards never cover it.
On narrower widgets and tablets
Under 900 px, pinned items sit as chips in a tray along the bottom of the widget. On a tablet, tapping a chip opens a sheet with the same compact view, buttons to move to the previous or next pinned item, Open full view and Unpin. Minimize in the full view goes back to the compact view.
On phones
On a phone (a widget 560 px wide or narrower, or up to 640 px on a touch phone) there is only one way to show an item, whatever the navigation mode:
- A match, team, competition or player opens in a full-screen sheet with the full view and a header with Close. Below it comes the same item header as in the window, without the window's buttons; the sheet header shows the item's name only while the item loads, so the name is not repeated, and takes the item header's colour so the two read as one header. Modal and Floating cards look the same.
- There is no Minimize, Minimize to floating card or Open full view: on a phone a card and a window would be the same size.
- With Floating cards, tapping an item also pins it. The sheet header adds buttons for the previous and next pinned item (swiping the header does the same) and Unpin. Close, Escape and the phone's back gesture put the item back in the tray without unpinning it.
- The tray, Hide pinned and the corner button that brings it back work as on tablets. Turning the phone sideways keeps the tray (or its corner button when the screen is short), even on large phones.
- Modal size, Modal content inset, Modal header and Header and tabs do not apply on phones.
Settings
| Setting | What it does |
|---|---|
| Open as floating card | One box per type: Matches, Teams, Leagues, Players. All are ticked by default. Unticked types open in the modal instead. At least one type must stay ticked; to open everything in a window, choose Modal. |
| Max pinned items | How many items can stay pinned at once, 1 to 10 (default 5). Pinning one more removes the least recently used chip, or the least recently used card when there is no chip. |
On tablets and desktops the modal settings above also shape the window that Open full view opens.
Check the width of your column
Expanded cards need a widget at least 900 px wide. Set the preview width in the configurator to the real width of the column where the widget will sit before choosing this mode.
None (no entity links)
Everything is still shown, but nothing can be opened: match rows, team names and players are plain text. Choose it for a widget that only needs to inform, such as one match inside an article.
Dynamic Pages
With the Dynamic Pages add-on, a click is a normal link to a page on your own
website, such as /en/matches/{match-name}/{match-id}. Your site shows the
match, team, competition or player on that page. The option appears
only for domains where the add-on is active. Without it, a saved Dynamic Pages
choice opens the modal instead.
Read Dynamic Pages to decide whether you need it and Install Dynamic Pages to set it up.
Which one should I choose?
| Your page | Suggested mode |
|---|---|
| A scores page or a homepage block | Modal, or Floating cards if the column is wide |
| A club or competition hub that fills the page | In-widget content |
| A live page where people follow several games | Floating cards |
| One match inside an article | None or Modal |
| A site with its own page for every match and team | Dynamic Pages |