Or write to support@educaplay.com
How to integrate Educaplay into a website
We are committed to continuously improving your experience; some elements of the video interface may not match the current one.
What the integration does
Your Educaplay games load inside your own website, blog or CMS, without the visitor having to open another tab.
Three ways to integrate
- Iframe: you paste a block of HTML. It works on any site that accepts HTML. It's the universal option.
- Official WordPress plugin: you paste the game's link into a block and it's embedded. Without touching HTML. Free.
- HTML download: packages the game so you can host it on your own server. Available from the Academic plan.
Where to find the options
All the integration options are inside the game's Share box. You can open it from three places:
- In My games: the share icon (three connected dots) next to each published game.
- On the game's page: the same icon to the right of the title.
- Right after publishing a game: Educaplay shows a confirmation screen with the button at hand.
Option A: embed with an iframe
In the Share box, below the link, is the Embed the game on your page with the iframe code block, ready to copy and paste.
- Click the copy button to the right of the code.
- On your website or blog, open the editor of the section where you want to embed the game.
- Paste the code into a block that accepts HTML. If your editor doesn't allow pasting HTML directly, open it in code mode and paste it there.
- Save and publish.
To adjust the size, change the iframe's width and height attributes. With width="100%", the game will take up all the available width on any device.
Option B: the official WordPress plugin
If your site is a WordPress, this free plugin saves you the iframe.
- Install the Embed Activities for Educaplay plugin from the official WordPress repository.
- In the page or post editor, add the Educaplay block.
- Paste the game's link that you copied from the Share box.
- Save and publish. The game is embedded, just like the YouTube block with a video URL.
Option C: download the game's HTML
With an Academic plan or Commercial plan, the Download block appears in the Share box, with the option to download the game's HTML. It lets you host it on your own server instead of embedding it from educaplay.com.
Cases where it makes sense:
- Serving the game from your own domain.
- Including it in closed web projects or intranets with no internet access (as long as the server serves it).
- Integrating it into frameworks or systems that prefer local files over iframes.
Important limitations:
- The downloaded HTML has to be served from a web server: it won't run by opening the file directly.
- Game scores are not recorded in Educaplay's Reports when the game is served from your HTML.
- To save scores in an LMS platform's gradebook, use the SCORM download (also from the Academic plan) or the LTI credentials in the Share box.
Sharing with just a link or a QR code
If you don't need to embed the game, in the Share box you have:
- Direct link with a copy button. Useful for emails, social media or virtual classrooms.
- QR code for the link. Useful for in-person sessions: you project the QR code and players scan it with their phone.
Player identification and scores
Plays are saved in your Educaplay Reports section even if the player does not identify themselves; in that case they are recorded as Anonymous. For each play to carry the name of whoever played it, players have to identify themselves before playing. In the game editor (the Options tab → Advanced settings → Privacy) you can:
- Make Player identification required (Nickname, guest code or Educaplay account).
- Change the Visibility if you don't want the game to appear in search engines or in the Educaplay catalog.
These options require an Advanced plan, Academic plan or Commercial plan.
Pulling scores programmatically
If you embed the games on your own website and want to bring the scores into your systems, Educaplay offers a Reports API to query your players' scores programmatically. It's available on the Academic and Commercial plans, both individual and Team. It only returns plays from games served by Educaplay (iframe, plugin or link): plays from the self-hosted HTML copy (Option C) aren't synced with Educaplay, so they don't appear in the API either. You'll find the documentation at api.educaplay.com/docs/, also linked from Developers in Educaplay's footer.
Frequently asked questions
Do I need to know HTML to embed a game?
Usually not. If you paste the iframe into a visual editor it normally works; if your editor doesn't accept HTML in the direct content, you'll have to open code mode and paste it there. In WordPress you can skip the HTML with the free Embed Activities for Educaplay plugin: you paste the game's link and that's it.
How do I change the game's size on my page?
By changing the iframe's width and height attributes. With width="100%", the game will take up the full width of the section.
How does the WordPress plugin work?
It adds an Educaplay block to the editor. You paste the game's link and the plugin turns it into an embedded game, just like the YouTube block with a video URL. The plugin is called Embed Activities for Educaplay and is installed free from the official WordPress repository.
Can I download the game's HTML to host it myself?
Yes, from the Academic plan onwards. In the Share box, the Download block includes an HTML icon that packages the game so you can upload it to your own server. The HTML won't run by opening the file directly: it has to be served from a web server. And games on that copy don't sync with Educaplay's Reports.
Do players need an Educaplay account?
Not necessarily. Depending on how you've configured the game, they can identify themselves with a Nickname (just typing a name is enough), with a guest code or with their own Educaplay account. If you want every play to carry a name, the game has to ask for identification before starting; otherwise it will be saved as Anonymous.
Are scores saved when someone plays from my site?
Yes. The plays are kept in your Educaplay Reports section; those from players who do not identify themselves are recorded as Anonymous. Exception: if you've downloaded the HTML and serve it from your server, those games don't sync with Educaplay.
Can I customize the game's appearance on my site?
Not through the iframe itself, but you can customize the game itself from its editor: add a background image or hide interface elements with an Advanced plan; apply your corporate colors, logo, corporate footer and hide the Educaplay brand with a Commercial plan.
Can I bring the scores into my own website or system?
Yes. Besides viewing them in your Reports section, with an Academic or Commercial plan you can use the Reports API to fetch the scores programmatically. The documentation is at api.educaplay.com/docs/. Note that the API doesn't include plays from the self-hosted HTML copy (Option C), since those aren't synced with Educaplay.
