What is Poltio?

Poltio is an interactive-content and guided-selling platform. Brands embed polls, quizzes, tests, product finders and gift finders into their websites and apps to collect zero-party data — information a customer volunteers directly — and use it to personalize product recommendations in the same session.

A typical guided-selling flow: a shopper answers a handful of questions, Poltio scores their answers against a connected product catalog, and the widget routes them to the products that match. The brand keeps the declared data behind those answers, and can act on it later through webhooks, reports or its own systems.

Who uses it

Mostly e-commerce and consumer brands, for four broad jobs:

Guided selling — product finders and gift finders that turn a browsing session into a recommendation.
Zero-party data collection — surveys and quizzes that build segments and personas from stated preferences rather than inferred behaviour.
Engagement — polls and tests published on a site, in an app, or shared as a standalone link.
Lead generation — capturing an email or phone number at the point where the customer is most interested, namely their result.

Core concepts

Name
Content
Type
poll | quiz | test | set
Description
A single piece of interactive content, addressed by a numeric content id or a UUID. Built no-code in the Poltio panel.
Name
Widget
Type
embed
Description
The renderer that displays a piece of content. Embedded with the JavaScript SDK or an iframe, and also reachable directly at https://www.poltio.com/widget/<contentId>.
Name
Voter
Type
end user
Description
The person answering. Identified by a first-party cookie, or by a publisher-supplied id (PUID) when the brand manages identity itself.
Name
Result
Type
outcome
Description
What a voter is routed to at the end of a quiz or product finder — a product, a persona, a piece of copy, or a link.
Name
Lead
Type
submission
Description
A contact form submitted against a result. Delivered by webhook, Google Sheet, or pulled from the API.
Name
DataSource
Type
XML | JSON | CSV
Description
A product or service catalog connected to Poltio so recommendations run against real inventory, stock and pricing.
Name
Pixelcode
Type
tracking
Description
A snippet fired on widget events — start, vote, result view, result click — used for conversion attribution and third-party tags.

Two things go on the page: the Poltio Tag once in the <head>, and a container wherever the widget should appear. The tag is unique to your account and is copied ready-made from the panel, under Resources → Poltio Tag.

Embed a widget

<div
  class="poltio-widget"
  data-poltio-widget-content="XXX"
></div>

<iframe
  src="https://www.poltio.com/widget/XXX"
  id="poltio-embed-XXX"
  loading="lazy"
  class="poltio-embed"
></iframe>

https://www.poltio.com/widget/XXX

Replace XXX with your content id. The SDK route also resizes the iframe to fit its content automatically. Every embed option — sizing, alignment, language, cookies, PUID, custom ids, UTM handling — is listed under Options.

Talking to the API

There are two APIs. The Widget API covers what a widget does on behalf of an end user: start a session, submit votes, fetch results, submit leads. The Platform API is authenticated and manages your account's content: create and publish content, questions, answers, results, themes and reports.

The rendered API reference is a JavaScript application, so anything that does not execute scripts will see an empty page. The OpenAPI documents are the useful artifact: widget.yaml and platform.yaml.

Where to go next