Updated Articles

  1. Question quotas and durations

    As of June 2, 2025, several changes have been made to response quotas and question durations. First, when deploying news/pop culture questions, the user must specify a one-time quota of 1000 or fewer responses 1 or specify an end da...
  2. Introduction to the poll unit

    CivicScience's poll units (formerly called widgets) provide an entertaining experience for website visitors while allowing for maximum user data collection and, in turn, the most relevant insights once the code is integrated into the media partner...
  3. Poll unit types

    Poll units may be used in two different ways. The first instance has two subtypes. First, it may be placed in an article with a width of 500px or more. It will look something like this: Here is an example. The second type is a right-rail o...
  4. Poll unit detection bookmarklet

    The poll unit detection bookmarklet can be used to search a webpage for the presence of the poll unit. Drag and drop the link below into your browser's bookmarks tab or bar.  Note: Please disable any ad blockers you use, then reload the pag...
  5. Target customization

    The Customization tab under each target's settings has many fields. Changes here can wreak havoc upon your poll unit,  so it's best not to change them lightly. Basic customizations In-article polling In Article Polling has four...
  6. Integration

    Note:  Whenever you see "civsci-id-123456789" , it must be replaced with your div identifier. Also, wherever we use a "000" value for a data-civicscience-widget attribute, that must be replaced with your poll unit target identifier, eit...
  7. Poll unit JavaScript events

    (Updated 05/26/2022) The poll unit triggers custom events during its lifecycle. Your code may listen to these events and perform custom actions when the events occur. Example actions include logging to an analytics platform, modifying the page's ...
  8. Poll unit customization

    Detailed user research has been conducted to create a poll unit experience that will delight respondents and encourage them to answer questions. Thus, some aspects of the poll unit cannot be adjusted. This section discusses some parts of the poll ...
  9. Advanced integration

    Advanced The basic integration code is suitable for most websites. This section describes a more advanced integration method. Container Element and Placement The best placement for the poll unit is embedded in an article's content. Other po...
  10. Identifying respondents

    We use several methods for identifying and remembering respondents and combining each respondent's answers from multiple poll unit visits into one profile. Cookies Our most common identification mechanism is a cookie placed by the poll unit. Aft...