Embeddable Typing Test Widget

How to Embed the Typing Test Widget

Configure your preferred settings using the controls above, then click Copy embed code. Paste the iframe code into any HTML page — the typing test will run fully inside the iframe without any additional setup.

What the Widget Includes

• Full typing test engine — words, time, and quote modes
• Live WPM and accuracy display during the test
• Detailed results screen with WPM chart
• All 16 themes, selectable via URL parameter
• Difficulty and modifier controls (punctuation, numbers)
• postMessage API — get test results in your own page's JavaScript

postMessage API

When a user completes a test inside the embedded widget, a message event fires on the parent window:

window.addEventListener('message', function(e) {
  if (e.data && e.data.type === 'tt_result') {
    console.log(e.data.wpm);      // net WPM
    console.log(e.data.accuracy); // accuracy %
    console.log(e.data.mode);     // "words" | "time" | "quote"
  }
});

Customisation via URL Parameters

• theme — any theme name: dark, light, monokai, solarized, etc.
• mode — words | time | quote
• count — word count (words mode) or seconds (time mode): 10, 25, 50, 100
• modifiers — comma-separated: punctuation, numbers

Backlinks

The widget footer includes a "Powered by TypingTest.now" link. This is a lightweight backlink that helps the site stay free — please leave it in place.

• Typing Test
• All free text tools →
• 1-minute typing test
• 3-minute typing test
• 5-minute typing test
• Typing speed leaderboard
• Typing practice sessions
• Weekly typing competition

Frequently Asked Questions

How do I add a typing test to my website?

Configure the widget above, click Copy embed code, and paste the iframe snippet into your page's HTML. The typing test loads and runs entirely inside the iframe — no scripts, accounts, or API keys needed. It works in any CMS that accepts raw HTML, including WordPress, Ghost, and most site builders.

Can I get the test results in my own JavaScript?

Yes. When a visitor finishes a test, the widget posts a message event to the parent page containing the net WPM, accuracy percentage, and test mode. Add a window message listener that checks for the tt_result type and you can store scores, build custom leaderboards, or trigger your own UI.

Is the embedded typing test free to use?

Yes. The widget is free for any website, personal or commercial, with no usage caps and no registration. The only condition is keeping the small Powered by TypingTest.now link in the widget footer, which credits the service that hosts the test engine and keeps it free for everyone.