Tilda / Webflow

Both are no-code friendly: the universal loader (/v1/widget.js) needs no CMS-specific backend. Paste the embed snippet into an HTML block.

Prerequisites

1. A project whose allowed_origins includes your published site URL.
2. Anonymous free-play needs no token. Identified play uses a backend-issued token; owner preview stays in admin.

Tilda

1. Add block -> Other -> T123 HTML.
2. Paste the embed snippet from RetentionPlay admin (Embed snippet).
3. Set data-session-token once your backend issues a token via POST /v1/server/session-token.
4. Publish.

Webflow

1. Add an Embed element.
2. Paste the same snippet.
3. In Project settings -> Custom code, ensure no CSP blocks the API origin or your site origin.
4. Publish.

Example (anonymous free-play)

<div id="playflow-widget"></div>
<script
  src="https://api.example.com/v1/widget.js"
  data-project-id="proj_demo"
  data-api-base="https://api.example.com"
  data-target="#playflow-widget"
  async
></script>

Theming and templates

Set the primary color and active template in admin — the loader and play iframe pick them up automatically, no CMS changes needed.

Troubleshooting

Issue	Fix
Blank iframe	Check console; verify allowed_origins
403 origin_forbidden	Add the exact site origin (scheme + host + port)
Anonymous only	Provide a valid data-session-token when per-user progress is required
Wrong game	Confirm the active template in admin