Help Center & Documentation

Step-by-step setup guides and documentation

Learn how to embed interactive quizzes on your website, connect with newsletter platforms like Kit, configure custom domains, and deliver engaging player experiences.

Browse GuidesIntegrator API DocsContact Support

Step-by-Step Setup Guides

Follow these structured walkthroughs to get live trivia embedded and monetized in minutes.

6 StepsBusiness Plan

Put a Quiz on Your Website

Install and verify a Quiz on your website before sending readers to that page.

Prerequisites

  • A Quiz with ready questions
  • A Business Plan or Enterprise Plan
  • Access to add embed code to a public page, or someone who can add it for you
Jump to WalkthroughOpen Full Guide
5 StepsIndividual+

Add Atrivial to Kit

Install the Atrivial Quiz block in Kit so trivia appears in your broadcasts.

Prerequisites

  • An Atrivial subscription on Individual or higher
  • A Kit account
  • Access to edit a Kit broadcast or template
Jump to WalkthroughOpen Full Guide

Ways to Publish & Share

Choose how you want your audience to experience trivia across your website, newsletter, and social channels.

Which planet is known as the Red Planet?

Website Embed

Web & CMS

Best for: Embedding quizzes directly inside articles, sidebars, or dedicated quiz pages on your site.

View Setup Guide →

Which planet is known as the Red Planet?

Interactive Email / Kit

Newsletters

Best for: Sending interactive trivia in newsletters via Kit (ConvertKit) or standard email templates.

View Setup Guide →
Live Quiz

Which planet is known as the Red Planet?

Play on Atrivial

Direct Hosted Link

Social & Sharing

Best for: Sharing quizzes directly via Twitter/X, LinkedIn, Discord, or community chat links without hosting code.

View Setup Guide →
Website & Web AppsStandalone Guide URL ↗

Put a Quiz on Your Website

Install and verify a Quiz on your website before sending readers to that page.

Prerequisites before you start:

  • A Quiz with ready questions
  • A Business Plan or Enterprise Plan
  • Access to add embed code to a public page, or someone who can add it for you

Steps to Complete

  1. 1

    Choose the page

    Create or open a dedicated public page. Place the Quiz directly below your site header, with ads, signup forms, sharing tools, and other content below it. Do not load content above the Quiz after the page opens. Copy its full URL.

    Done when: You have the page's HTTPS URL.
  2. 2

    Approve the website domain

    In Atrivial, open Account. Under Embed and Approved domains, add the page's domain without the path.

    Done when: The domain appears under Approved domains.
  3. 3

    Copy the website embed

    Open the Quiz and select Output. Below View link, expand View embed code, then use its copy button.

    Sample embed snippethtml
    <div class="atrivial-quiz" data-quiz-id="YOUR_QUIZ_ID" data-height="600">
  <iframe
    src="https://atrivial.com/quiz/YOUR_QUIZ_ID?view=iframe"
    width="100%"
    height="600"
    frameborder="0"
    allow="clipboard-write"
  ></iframe>
</div>
    Done when: The copy button reads Copied!
  4. 4

    Add and verify the embed

    Keep Atrivial-hosted selected while you add the copied code to the page's HTML, either directly or through your publishing platform's code or embed feature. Do not override the iframe height in site CSS; use the data-height value in the copied code. If someone else manages the website, send them the code and page URL.

    Done when: The published page supports one full Quiz playthrough on both desktop and mobile.
  5. 5

    Send players to your website

    Return to the Quiz in Atrivial. Select Style & Sponsors. Under Where will players play this quiz?, choose My website.

    Done when: The page URL field appears.
  6. 6

    Save the page URL

    Paste the full page URL into Your page URL where players will play this quiz, then leave the field to save it.

    Done when: The Quiz header shows Saved.
If the embed does not appear

Use the copied code unchanged. If article cards or sign-in do nothing when tapped, replace the published embed with a fresh copy from Output. If your website rejects, changes, or removes it, Atrivial Support can provide an iframe version.

Contact Atrivial Support
Newsletter & ESPStandalone Guide URL ↗

Add Atrivial to Kit

Install the Atrivial Quiz block in Kit so trivia appears in your broadcasts.

Prerequisites before you start:

  • An Atrivial subscription on Individual or higher
  • A Kit account
  • Access to edit a Kit broadcast or template

Steps to Complete

  1. 1

    Install Atrivial from Kit

    In Kit, open Apps and install Atrivial. Kit opens Atrivial in your browser.

    Done when: You see Connect Atrivial to Kit.
  2. 2

    Sign in or create an Atrivial account

    Sign in, or create an account and start the 14-day trial. Use the Atrivial account that should own the quizzes.

    Done when: You see the consent screen.
  3. 3

    Allow Atrivial in Kit

    Choose the Atrivial account if you have more than one, then select Allow. Kit then asks you to let Atrivial read your published posts so the recent-posts source can work.

    Done when: Kit finishes installing the app.
  4. 4

    Add the Atrivial Quiz block

    In a Kit broadcast or template, add the Atrivial Quiz block. Under Emails, pick Recent for a rolling lookback (with optional Auto-Update), or Specific to hand-pick one or more sent broadcasts — Specific quizzes stay fixed. You can also paste a link/text or choose a Library quiz.

    Done when: The block shows a question, a button, or a Generating placeholder.
  5. 5

    Send a test

    Send the broadcast to yourself and tap an answer. You should land on the hosted quiz with that answer selected.

    Done when: The hosted quiz opens from the email.
If latest-post asks you to reconnect

Open Atrivial from Kit again so posts access can finish. Per-broadcast click stats are not available; Kit clicks still appear in Atrivial as Kit.

Contact Atrivial Support

Frequently Asked Questions & Troubleshooting

Quick answers for common integration scenarios, domain approvals, and CMS platform setups.

For security and anti-abuse protection, external embeds verify the parent frame domain. In your Partner Portal under Account → Approved domains, enter your root domain (e.g. example.com or news.example.com) without the https:// prefix or path.

If you are testing locally, you can also add localhost to your approved domains list.

In your CMS page editor, add a Custom HTML, Embed, or Code block. Paste the full embed code from the Quiz Output tab without modifications. Do not hardcode height styles in CSS; the embed automatically manages responsive height via the data-height attribute and iframe communication.

Sample embed markuphtml
<div class="atrivial-quiz" data-quiz-id="qz_example123" data-height="600">
  <iframe
    src="https://atrivial.com/quiz/qz_example123?view=iframe"
    width="100%"
    height="600"
    frameborder="0"
    allow="clipboard-write"
  ></iframe>
</div>

When adding the Atrivial Quiz block in Kit: "Recent" automatically generates questions from your newest published broadcasts and updates over time. "Specific" lets you hand-select past broadcasts to lock in permanent trivia questions that never change.

You can also paste any custom topic, URL, or select a pre-made quiz from your Atrivial Library directly within Kit.

All players can play immediately without forced login. XP and game sessions persist in browser storage. When players choose to sign in, their earned XP and streak history automatically link to their account, displaying on partner leaderboards.

Under the "Style & Sponsors" tab in your Quiz editor, you can upload sponsor logos, set sponsor banner text and links, and select color themes (Glass, Flat, Neumorphic) that blend with your publication’s aesthetic.

Need personalized integration help?

Our engineering team is ready to assist with custom iframe embeds, newsletter template styling, or automated RSS generation.

Contact SupportPartner Portal