DocsCreator GuideIntegration Guide

Elements

The building blocks of an App are what we refer to as Elements

Elements are two-way interactive components such as Polls, Predictions or Trivia questions which have a range of configuration fields and typically have two-way behaviour that allows them to count up votes or responses from users.

Developers build ontop of "base" Elements to create their own.

Base Element Types

When building your app using App Specs, you define interactive and non-interactive content using base element types. Each element type provides different capabilities and configuration options to create engaging user experiences.

Interactive Elements

Interactive elements allow users to participate and respond to content in real-time.

Poll

Type: poll

The foundational voting element where users select from multiple answer options.

  • Features:

    • Support for both fixed and flexible duration modes

    • Multiple answer options

    • Real-time result aggregation

    • Multi-vote capabilities

    • Result reveal configuration

  • Use cases: General voting, surveys, audience feedback

  • Documentation: Elements Spec

Prediction

Type: prediction

Similar to a poll but includes the concept of a "correct" answer that can be revealed.

  • Features:

    • All poll capabilities

    • Correct option functionality

    • Manual answer revelation

    • Result accuracy tracking

  • Use cases: Sports predictions, outcome guessing, forecasting

  • Documentation: Elements Spec

Trivia

Type: trivia

Question-and-answer element where the correct answer is predetermined.

  • Features:

    • All poll capabilities

    • Pre-set correct options

    • Reveal answer mode configuration

    • Delay settings for answer revelation

    • Reveal answer on vote feature

  • Use cases: Quiz games, knowledge testing, educational content

  • Documentation: Elements Spec

Emo Poll

Type: emo

Specialised voting element with automatic vote expiry.

  • Features:

    • Limited to two options (similar to dpoll)

    • "Fade" parameter for automatic vote clearing

    • Real-time sentiment tracking

    • Temporary vote storage

  • Use cases: Live sentiment tracking, momentary reactions, real-time mood polling

Powerbar

Type: powerbar

Single-option voting element for intensity measurement.

  • Features:

    • No predefined options - single implicit target

    • "Fade" parameter for vote lifetime

    • Intensity/volume measurement

    • Continuous input capability

  • Use cases: Applause meters, energy levels, crowd noise simulation

Non-Interactive Elements

Data

Type: data

Broadcast-only element for sharing information without user interaction.

  • Features:

    • Supports custom fields

    • No voting capabilities

    • One-way communication

    • Flexible content structure

  • Use cases: Announcements, statistics display, information cards, media galleries

  • Documentation: Managing Elements

Deprecated Elements

RPoll

Type: rpoll

Deprecated: Use poll instead. This element type is maintained for backwards compatibility only.

Legacy poll element identical to poll with no additional features.

DPoll

Type: dpoll

Soft Deprecated: Limited use cases. Consider emo or poll alternatives.

Diametric (swing) poll limited to two options with special results calculation.

  • Limitations:

    • Only two visible options

    • Complex internal virtual options

    • Limited real-world applications

Choosing the Right Element Type

Goal

Recommended Type

Reason

Simple voting

poll

Most flexible and feature-rich

Quiz or knowledge test

trivia

Built-in correct answer handling

Sports/event predictions

prediction

Manual result revelation

Live sentiment tracking

emo

Auto-expiring votes

Intensity measurement

powerbar

Single-target continuous input

Information sharing

data

No interaction needed

Configuration Examples

Basic Poll Element

{
  "name": "Audience Poll",
  "content_type": "audience_poll",
  "derived_from": "poll",
  "duration": {
    "mode": "fixed",
    "default": 60
  },
  "reveal_results": {
    "modes": ["vote", "close", "manual"],
    "default": "vote"
  }
}

Advanced Features

Most interactive elements support:

  • Multi-vote capabilities: Allow users to select multiple options or vote multiple times

  • User validation: Require user authentication for participation

  • Vote Verification (also known as Certification): Enable vote security features

  • Dynamic duration: Configure how long elements remain active

Element Feeds

https://<lvis static host>/events/<first two symbols of event UUID>/<event UUID>/<feed type>.json

Feeds available:

  • all_elements. See All elements for structure.

  • all_published. Contains a list of published elements only. See All elements for structure.

Last updated

Was this helpful?