Options

All the examples below need Poltio Tag on your page. It is unique to your account, so you get it ready to use from Poltio Panel: open the sidebar and click Poltio Tag under Resources.

Poltio Tag entry under Resources in the Poltio Panel sidebar

A dialog opens with the tag already filled in with your Account ID. Copy it with the button in the top right corner of the code box and paste it into the <head> section of your page. You only need to do this once per page, then add as many widget areas as you like.

Setup Poltio Tag dialog with the ready to copy tag

By default you only need your content id for a simple callout.

Simple Callout

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

Width & Height

By default, the widget will have a 100% width of its container and have a 500px height.You can customize these params via data-poltio-widget-width="XX" and data-poltio-widget-height="YY"

Width & Height

<div
 class="poltio-widget"
 data-poltio-widget-width="400"
 data-poltio-widget-height="600"
 data-poltio-widget-content="XXX"
></div>

Alignment

By default, Poltio widgets align themselves in the middle of the area thats given to them. You can change this with data-poltio-widget-align="left"

Alignment

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

Auto Resize

By default, our sdk will adjust the height property based on the content frame and disable scrolling. You can disable this behavior by adding data-poltio-widget-resize="false"

Auto Resize

<div
 class="poltio-widget"
 data-poltio-widget-resize="false"
 data-poltio-widget-height="300"
 data-poltio-widget-content="XXX"
></div>

Language

oltio widgets supports English, Turkish, German, French, Spanish, Italian, Romanian, Portuguese, Dutch, Thai, Hebrew, Arabic, Polish, Austrian German, Algerian Arabic, Egyptian Arabic, Moroccan Arabic and Hungarian. By default, we select the locale based on browser locale. But you can adjust this manually by data-poltio-widget-lang="tr" Also Poltio widget for rtl languages does rtl itself.

Supported Languages

- en
- tr
- de
- fr
- es
- it
- pt
- nl
- ro
- th
- he
- ar
- pl
- de-at
- ar-dz
- ar-eg
- ar-ma
- hu

Language

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

Disclaimer

If you already notifying your visitors about cookie consent, you can disable cookie consent in the Poltio Widgets by: data-poltio-widget-disclaimer="off"

Disclaimer

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

By default, Poltio widget leaves cookies. If you don't want this, you can use the data-poltio-widget-cookie="off" parameter that follows.

Cookie

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

Open Links

By default, the poltio widget opens the links you add to the result in a new tab (_blank). If you want to use other target parameters ( _self, _parent, _top and none ) you need to add a parameter as follows, data-poltio-widget-openlinks="target"

_self: the current browsing context. (Default)
_blank: usually a new tab, but users can configure browsers to open a new window instead.
_parent: the parent browsing context of the current one. If no parent, behaves as _self.
_top: the topmost browsing context (the "highest" context that's an ancestor of the current one). If no ancestors, behaves as _self.

Open Links

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

Media Answers Cols

By default, Poltio uses 2 column in Media answers type questions. If you want to use 4 or 5 column you in your media answers type questions you can add medianswercols=4 or medianswercols=5

Media Answers Cols

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

New Result Cards

If you want to use new result card design you can add to resultcards=new parameter to your iframe src.

New Result Cards

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

Result Fit

By default, poltio widget smart crops the images on the result screens. You can use data-poltio-widget-resultfit="vf", data-poltio-widget-resultfit="fit" and data-poltio-widget-resultfit="off" parameters according to the size of the images you use in the results.

Default: Crop the image automatically with smart zoom if the image is larger
data-poltio-widget-resultfit="fit" We fit the image in 8:5 ratio without cropping
data-poltio-widget-resultfit="vf": Crop via height for vertical image display
data-poltio-widget-resultfit="off" Crop in the middle if the image is larger

Result Fit

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

Default (data-poltio-widget-resultfit="default" or omittted.)

Vertical Fit (data-poltio-widget-resultfit="vf" )

Fit (data-poltio-widget-resultfit="fit" )

Off (data-poltio-widget-resultfit="off" )

PUID

If you want to match poltio voters with your own users in a safe way, you can include our widget with a puid param which we store and send it back to you in webhooks or reports.

PUID

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

Custom ID

If you need a secondary identifer for the session that you want to track via webhooks or from platform, you can use custom_id like puid.

Custom ID

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

UTM Parameters

By default if your page has utm parameters (eg: utm_source, utm_medium, utm_campaign, utm_content or utm_term) we will copy these utm params in our widget url so all pixel code events that you fire inside our widgets will also use these params by default.

If you want to customize utm parameters for the widget, you can use poltio-widget-utm_XXX="xxx"

UTM Parameters

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