2Ring Logo
2Ring Dashboards & Wallboards Layout Viewer and Editor Guide Version: 2508
Docs Portal DW Cloud Viewer Guide Editing a Layout Segments Segment Types Banner
  • Overview
  • What is new
  • Quick Start
  • AI Assistant
  • Logging in
  • Account Management
  • What is a Layout
  • What is a Widget
  • Working with the Layout List
  • Working with the Layout Editor
  • Editing a Layout
    • Creating a Segment
    • Data Sources
    • Segments
      • Segment Types
        • Banner
        • Bar/Line Chart - Grid
        • Bar/Line Chart - KPI Timeline
        • Calendar
        • Clock
        • Grid
        • Image
        • KPI
        • Label
        • Nested Layout
        • Nested Widget
        • PDF Document
        • Pie Chart
        • Sequence
        • Shape
        • Social Feed - Facebook
        • Social Feed - X (Twitter)
        • Ticker
        • Video - YouTube
        • Web Page
        • Word Cloud
      • Copying
      • Positioning and Resizing in Preview
      • Scalar-Valued Calculations
      • Table-Valued Calculations
      • Historical Intervals
      • Notifications
      • Condition
    • Publishing/Discarding Changes
    • Impersonating
    • Notifications
  • Local Notification Permissions
  • Static Content
  • Devices and Integrations
  • Troubleshooting

Quick search

Banner¶

Related Videos


The Banner displays a text, usually used as a note or a description of a part of the Layout. To create a scrolling effect, insert the Banner into a Ticker segment.

For general information about this segment, see Banner chapter.

  • Name
    An unique name, that is used to access this Banner via the API. Using this name, the Banner can be used by external applications, such as 2Ring Gadgets. The Name has to be unique across the entire Business Unit.

  • Text
    Desired text to be displayed. The text can be on multiple lines (works only when Regular Text Flow is selected). The text length is limited to 2000 characters.

  • Temporary Text
    Desired temporary text to be displayed. The temporary text overwrites the original text of the banner to the time set in the Temporary Text Expiration. The text length is limited to 2000 characters.

  • Temporary Text Expiration
    The date and time until which the temporary text will be set. After this date, the banner will revert its original text. By clicking on the calendar and the clock icon, the date and time can be set using the integrated control.

  • Appearance
    The style of a Banner

    • Enable Markdown
      Whether the text should be interpreted as Markdown. If enabled, the text can contain Markdown formatting, such as bold or italic text, links, and more. For more information about markdown, see Basic Markdown Syntax.

      To ensure your text fits well across multiple lines, you'll need to adjust the Font Size Coefficient. To calculate the ideal font size coefficient use formula:
      (1 / number of lines you want to display) * 0.7
      If markdown contains larger paddings or margins between lines, adjust the result as needed.
      Markdown syntax is not supported in TVs with Tizen 5.x OS. In this case unformatted markdown text will be displayed.
    • Text Flow
      Required
      Orientation at which the letters are arranged.

      • Regular - Text is displayed in standard way.

      • Regular Upside Down - Text is flipped upside down.

      • Clockwise Rotated - Text is rotated clockwise.

      • Counter-Clockwise Rotated - Text is rotated counter-clockwise.

      • Vertical - Letters are arranged from top to bottom, without any rotation

    • Text Wrapping
      Whether the text should be splitted into multiple lines if the text is wider than the whole segment.

    • Preserve Whitespace
      Whether whitespaces in banner should be preserved as they are, or be replaced with a single space character.

    • Text Color
      Inheritable
      For more information see Color Field section.
      Color of the text.

    • Background Color
      Inheritable
      For more information see Color Field section.
      Color of the background.

    • Text Style
      Inheritable
      For more information see Text Style section.
      Type of font to use and whether bold or italic text should be used.

    • Font Size Coefficient
      Inheritable
      The font size is calculated by multiplying available height for the text by font size coefficient.

    • Horizontal Alignment
      Inheritable
      Controls, where the text should be aligned on the horizontal axis.

      • Left - Text is aligned to the left.

      • Center - Text is aligned to the center.

      • Right - Text is aligned to the right.

    • Vertical Alignment
      Inheritable
      Controls, where the text should be aligned on the vertical axis.

      • Top - Text is aligned to the top.

      • Middle - Text is aligned to the middle.

      • Bottom - Text is aligned to the bottom.

    • Padding
      Inheritable
      The size of a padding between the banner text and banner’s border in “em” units. 1 em equals to the font size of the associated text.
      The padding is applied to the side where the text is horizontally aligned.

Segment Types
Bar/Line Chart - Grid