Skip to content

Widgets

6 min read Updated November 17, 2026
Open in Studio
On this page

A widget is a small, live piece of your tournament website that you paste into another website: a club site, a sponsor's page, a news article. It updates by itself, so the page you pasted it into never goes out of date.

You build a widget in the dashboard, copy a bit of code and paste it where you want it to appear.

How a widget behaves#

  • It stays current. While a match is live, it refreshes every 30 seconds. Otherwise it refreshes every 5 minutes. Once you mark the tournament finished, it stops refreshing.
  • It tracks nobody. Nothing is stored about visitors: no cookies, no tracking.
  • It shows what your website shows. If a page (for example Results or Matches) is switched off in the Website Editor, the matching widgets say it is not published yet, and the builder tells you which setting to turn on.

The widgets#

  • Standings: the table of one group at a time. With several groups it shows tabs. You can highlight one team's row. In narrow places it shows fewer columns.
  • Matches: live matches first, then the next matches, then results, grouped by day. You can pick a division or a team, choose Live, next and results, Live and next or Results only, and show 3, 5, 10 or 20 matches. With Live, next and results you get that many next matches and that many results.
  • Team card: one team with its live or next match, its last results and its table position. In individual sports it is called Participant card.
  • Tournament card: before the tournament, a countdown and a Register button when registration is open. During it, how many matches are live and a Live results button. After it, the champion, once the tournament summary is published.
  • Live now: what is being played right now, optionally for one venue. When nothing is live, it shows the next match.
  • Top scorers: the top of the scorers list, optionally for one division.
  • Bracket: the knockout rounds. In narrow places it scrolls sideways.
  • Sponsors: the sponsor logos your website shows. This needs the Premium plan and sponsors switched on for your website.

Build a widget#

Go to Website > Widgets. You need permission to manage the website settings.

  1. Pick a widget on the left.
  2. Set it up on the right: division, group, team, venue, what to show, how many, Look, Transparent background, Show the tournament name and Language.
  3. Watch the live preview in the middle. Switch it between Phone, Sidebar and Wide width, and between a Light, Dark and Grey site, to see how it will sit on the page where you paste it.
  4. Choose your platform under Where is your website? and copy the code.

Look#

  • Tournament theme: the default. It uses your website's colours.
  • Light or Dark: a fixed look.
  • Match the visitor's device: follows the visitor's light or dark setting.

Transparent background only works with Light or Dark, so the text always stays readable.

Language#

The widget speaks your website's language by default. You can pick any of the 16 website languages instead.

Where is your website?#

Choose your platform and the builder gives you the right code and the steps for it.

  • WordPress: edit the page and add a "Custom HTML" block, paste the code, then update the page. It is script code and sizes itself.
  • Wix: click Add, then "Embed code", then "Embed a site". Paste the address into "Website address" and drag the box to the height shown in the builder. Wix takes an address, not code.
  • Squarespace: add a "Code block", paste the code and save. Squarespace allows code blocks on its Business plan and up. This code is a fixed-height frame: the builder measures the height from the preview and adds 10%.
  • Joomla: open the article and switch the editor to code view. Paste the code where the widget should appear, then save. It is script code.
  • Webflow: drag an "Embed" element onto the page, paste the code and publish. It is script code.
  • Google Sites: click Insert, then "Embed", then "By URL". Paste the address and resize the box to the height shown. Google Sites takes an address, not code.
  • Other / HTML: paste the script code. If the site can't run scripts, use the fixed frame shown below it.

Press Copy code (the gold button) to copy the code.

Tip. Press Copy message for the club to copy a ready message for a participating club. It contains the code, the steps for the platform you chose and a link to this guide, so you can paste it straight into an email.

Changing a widget#

Nothing is saved in MyCup: the code is the widget. To change a widget, build it again and replace the code on your site.

Next season#

If your tournament is part of a series, widgets made from it follow the series into its next season automatically, once the new season's website is public.

  • A division is found again by its name.
  • A team is found through the season library, so a renamed team is still found.
  • If something can't be found, the widget shows the whole tournament. A team card says instead that the team isn't in this season yet.

Check a code#

Paste any widget code into Check a code to see what it shows today, and whether its division or team got lost after a season change. Press Fix this code to load it into the builder, then copy a corrected code.

Common questions#

Will it slow my site? No. A widget loads lazily, in its own frame.

Does it work on mobile? Yes. It fits the space it is given.

Can I change the colours? Choose a Look. Tournament theme uses your website's colours.

Why does my widget say "not available"? Either the code is wrong, or the tournament or its website isn't public.

Is there a WordPress plugin? Not yet. Use the "Custom HTML" block.