Link Preview Bot

When you paste a link into the Tickaroo editor, the Link Preview bot fetches that page and builds a rich preview — title, description, image and more — just like Facebook and other social platforms do. It adheres to the Open Graph Protocol, making it compatible with most websites out of the box. Tickaroo also supports some additional fields, as well as overriding Open Graph specifically for use in the Tickaroo editor. All fields are optional.

User-Agent: Tickaroo-LinkPreview/1.0 (+https://www.tickaroo.com/bot)

Firewall configuration

To generate previews, the Link Preview bot requests pages from your site. Tickaroo aims to be compatible with most configurations out of the box, but IT/security teams sometimes need to allowlist it.

Tickaroo bots do not evaluate robots.txt. To suppress previews of your pages, block the User-Agent or the IP ranges above.

Supported fields

A rich preview generated by the editor supports the following fields. For each field, the bot uses the first available source in the order listed.

Field: title

The main title of the target

  1. <meta property="tickaroo:title" value="">
  2. <meta property="og:title" value="">
  3. <title></title>
  4. <h1></h1>
  5. <h2></h2>
  6. Input URL

Field: description

Description text of the target

  1. <meta property="tickaroo:description" value="">
  2. <meta property="og:description" value="">
  3. <meta name="description" value="">
  4. Content from any element matching one of 'article', '.article', '.article-teaser', '.teaser', '#content', '.content', '.main', '[role=main]'

Field: kicker

Extra header above the title

  1. <meta property="tickaroo:kicker" value="">
  2. <meta property="og:kicker" value="">

Field: access

Access/subscription indicator. Creates an extra div with property data-access="VALUE". This is not visible without custom styling.

  1. <meta property="tickaroo:access" value="">
  2. <meta property="og:access" value="">

Field: image

Preview image

  1. <meta property="tickaroo:image:url" value="">
  2. <meta property="og:image:secure_url" value="">
  3. <meta property="og:image:url" value="">
  4. <meta property="og:image" value="">
  5. <meta property="twitter:image" value="">

In addition, the width and height are used if available:

  1. <meta property="tickaroo:image:width" value=""> / <meta property="tickaroo:image:height" value="">
  2. <meta property="og:image:width" value=""> / <meta property="og:image:height" value="">

Field: icon

Icon to display if a preview image is not available

  1. <link rel="apple-touch-icon-precomposed">
  2. <link rel="apple-touch-icon">
  3. <link rel="icon">
  4. <link rel="shortcut icon">
  5. Resolve /apple-touch-icon.png
  6. Resolve /favicon.ico

Field: domain

The domain name the link goes to

  1. Always derived from the input URL

Opt-out

Link previews are generated only when a user pastes a link. To prevent previews of your pages, block the Tickaroo-LinkPreview/1.0 User-Agent or the IP ranges above in your firewall.