Embedding Content

Getting Started

1. Allow your website

Your content only shows on websites listed in NXT. Add your domain first: see Allowed Domains.

2. Copy the embed code

Publish the article, quiz, poll, story or form in NXT, then open Embed in its editor and choose Copy code. The embed code looks like this:

<script type="module" src="https://<tenant>.apps.tickaroo.com/nxt/embed/nxt1.js"></script>
<nxt1-artifact organization-id="o…" artifact-id="A0…"></nxt1-artifact>

Always copy the code from NXT: it contains the right script address for your account and the right ids. The embed code stays the same when you publish the content again later.

3. Paste it into your page

Paste the code where the content should appear. Updates you publish later load automatically.

The script tag must keep type="module". Without it the browser cannot run the script, and the element stays empty.

Several pieces of content on one page

Include the script once per page. Add one <nxt1-artifact> element for every piece of content:

<script type="module" src="https://<tenant>.apps.tickaroo.com/nxt/embed/nxt1.js"></script>

<nxt1-artifact organization-id="o…" artifact-id="A0…"></nxt1-artifact>
…
<nxt1-artifact organization-id="o…" artifact-id="A0…"></nxt1-artifact>

Each element names the Organization its content belongs to in organization-id, and the content itself in artifact-id. If your account has several Organizations, one page can show content of each of them: give each element its own organization-id. Everything an element shows, including the quizzes and polls inside an article, comes from that element’s Organization.

What readers see

Content On your page
Article Title, byline, authors, date, abstract, main image and the article’s blocks. Quizzes, polls and forms placed in the article work as they do on their own.
Quiz The questions one after another, then the result. If the quiz has a form, it is shown before the result.
Poll The question and answers. After voting, the reader sees the results. If the poll has a form, it is shown before the results.
Story A story player that fits the width of its container (no taller than 85 % of the screen). Readers can open it full screen. It plays only while it is visible, and polls, quizzes and forms work on its slides.
Form The form’s fields, its privacy note and a link to your privacy policy, if you set one in NXT. A form can accept one response per reader.

When content doesn’t show

What you see Why
Nothing at all The script tag is missing, is included without type="module", artifact-id is missing, or the browser is not supported.
“This embed code is missing its organization-id” or “This embed code has an invalid organization-id” The organization-id attribute is missing or was changed. Copy the embed code again from NXT.
“Content not available” The content isn’t published, was unpublished, artifact-id is wrong, or organization-id names an Organization that doesn’t exist.
“This content is not enabled for this website” Your website’s domain is not in the allowed embed domains. See Allowed Domains.

Once the script runs, each of these problems also writes a message starting with [nxt1] to the browser console.

Next Steps