Design and install a WordPress football widget
Customise the football widget, register one website, verify its installation key and publish scheduled, live, results and prediction shortcodes.
Step 1: Design
Customise inside your account
Step 2: Register
One website per account
Step 3: Install
WordPress plugin and widget key
Step 4: Publish
Choose the right shortcode
Use an eligible plan and a saved design
Football widget installation is available with active Growth and Pro access, not Starter or the Starter trial. The public Widgets page explains the product, while the designer in your account saves designs and installation settings.
Customise the supplied football widget rather than building a separate iframe. Save your design before copying its ID. Preview desktop and mobile views, check your competition selection and confirm that the saved design is the one your shortcode references.
Register the exact website URL
Each account's widget licence permits one registered website. Enter the actual WordPress home URL, including its www choice or subdirectory. This installation restriction is distinct from ordinary REST API website display permissions.
Generate a widget installation key in your account. It is not your customer REST key. Keep it in WordPress server-side settings and do not paste it into a shortcode, a page's HTML or public JavaScript.
Install the plugin and verify the connection
Download the WordPress plugin from your account, install the ZIP through Plugins, activate it and open Settings → FootballAPI Widgets. The settings page provides the connection controls and shortcode helper.
Save the widget key and verify the registered website. Verification needs a publicly reachable HTTPS WordPress REST endpoint without a login wall, challenge page or redirect at that endpoint. The verification proof does not expose the installation key. If you replace or revoke the key, update WordPress and verify again.
- Only WordPress administrators with the required settings permission should edit the connection.
- A blank key field can mean the existing key is safely retained, not that it has been removed.
- Changing the website home URL invalidates the previous website binding.
Choose a default view with a separate shortcode
Replace YOUR-DESIGN-ID with the ID of a design saved in your own account. Add only the shortcode needed for each page, or use the general widget shortcode for the default view stored with the design.
These shortcodes choose the starting view; they do not create separate API subscriptions. Data visibility still depends on the active installation, saved design, selected date and actual available records.
[footballapi_widget design="YOUR-DESIGN-ID"]
[footballapi_scheduled design="YOUR-DESIGN-ID"]
[footballapi_results design="YOUR-DESIGN-ID"]
[footballapi_live design="YOUR-DESIGN-ID"]
[footballapi_predictions design="YOUR-DESIGN-ID"]Configure links and check your site caches
In the designer's Links settings, select the available bookmaker and enter your own valid outbound URL. The matching bookmaker's odds boxes can then use that link. Keep market data and link configuration separate; adding a link does not create missing prices.
The widget uses prepared football data and saved images, with brief WordPress response caches. Full-page or CDN caching can retain old initial HTML after a design change, so clear those caches when needed. Allow the plugin runtime assets and its WordPress REST delivery route through security and optimisation plugins.
Understand the one-site protection boundary
The delivery service checks the registered website, widget key, design ownership and eligible account access. Rotation invalidates the old key, and a design belonging to another account is rejected.
Website binding is not DRM: it cannot stop someone copying already displayed HTML or a determined server-side proxy. Keep WordPress and its backups secure, revoke exposed keys promptly and do not describe the installation as impossible to copy.
Related tutorials
Build a football product / 11 min
Build a fast football match centre
Combine fixtures, live states, summary events, statistics, formations, images and odds into one preloaded football match-centre model.
Build a football product / 9 min
Deliver team crests and player portraits fast
Decode supplied football images, save team crests and player portraits by ID, and serve fast public visuals without exposing customer API keys.
Account and support / 8 min
Manage plans, trials, API keys and daily usage
Understand GBP plans, Starter's seven-day trial, daily allowances, metered overages, league selection and safe account support workflows.