Developers

Embed your questionnaire

Put a Tapback form on your own website, booking confirmation or help centre. Visitors swipe through the same cards they would on a phone, and their answers land in your dashboard next to every other link and QR code.

Quick start

Open the form in your dashboard. Its ID is the long code in the address bar after /business/, for example 58359508-393d-476e-93a7-3a9919414a04.
Paste this where the form should appear and replace YOUR_FORM_ID:

HTML

<iframe
  src="https://www.tapback.ee/embed/YOUR_FORM_ID"
  title="Feedback"
  allow="microphone"
  loading="lazy"
  style="width:100%;max-width:480px;height:720px;border:0;border-radius:16px"
></iframe>

That's it. No script, API key or account is needed on your side. Anyone who can see your page can answer the form.

Live example

This is our demo form, embedded with the snippet above.

Options

Setting	What it does
`height` (style)	The form fills the frame. 640–760px suits most pages; below 560px the cards get cramped.
`allow="microphone"`	Lets visitors answer by voice. Leave it out and they type instead.
`?theme=light` or `?theme=dark`	Matches your page. Without it the form follows the visitor's device setting.

Dark theme URL

https://www.tapback.ee/embed/YOUR_FORM_ID?theme=dark

Wording, colours, logo, languages and rewards come from the form itself. Change them in the dashboard and every embed updates.

Events

The form tells your page when it is ready and when answers are saved, so you can close a pop-up, show your own thank-you or count completions in your analytics. Messages contain the form ID only, never answers or anything about the visitor.

JavaScript

window.addEventListener("message", (event) => {
  if (event.origin !== "https://www.tapback.ee") return; // only trust Tapback
  if (event.data?.type === "tapback:ready") {
    // the form has loaded
  }
  if (event.data?.type === "tapback:submitted") {
    // answers saved; event.data.edited is true when someone changed earlier answers
    console.log("Feedback received for form", event.data.form);
  }
});

type	Fields	When
`tapback:ready`	`form`	The form has loaded.
`tapback:submitted`	`form`, `edited`	Answers were saved (again, when edited is true).

How answers are counted

Embedded answers appear in the form's results, charts and AI summaries like any other. Visits show as direct visits.
Each page view is one anonymous visitor. The form doesn't rely on cookies inside your page and doesn't follow people across sites.
Rewards still work: winners see their code on screen and can email it to themselves.
Paused forms show a short “paused” note. Hidden or deleted forms show nothing.

Good to know

A/B comparisons, placement links (NFC, QR per table) and seminar programmes keep their own links. The embed always shows the form itself.
You collect this feedback as the controller of the data, so mention it in your own privacy notice. Tapback's part is described in our privacy policy.
Only the /embed/ address can be placed in a frame. Other Tapback pages refuse to load inside other websites.