---
title: RevFlicker
description: A guide to setting up and modifying RevFlicker widgets
---

[Skip to content](https://help.revcontent.com/knowledge/revflicker#main-content)

[![rc\_help\_center\_logo\_color](https://help.revcontent.com/hs-fs/hubfs/rc_help_center_logo_color.png?width=275&height=66&name=rc_help_center_logo_color.png)](https://help.revcontent.com/knowledge?hsLang=en)

Open main navigation

Close main navigation

- [Go to RevContent.com](https://www.revcontent.com/)

[Go to RevContent.com](https://www.revcontent.com/)

 Got questions? Find the answers here.

- There are no suggestions because the search field is empty.

1. [Help Center](https://help.revcontent.com/knowledge?hsLang=en)
2. [Publishers](https://help.revcontent.com/knowledge/publishers?hsLang=en)
3. [Labs Widgets](https://help.revcontent.com/knowledge/publishers?hsLang=en#labs-widgets)

# RevFlicker

## A guide to setting up and modifying RevFlicker widgets

![rev\_flicker](https://help.revcontent.com/hs-fs/hubfs/rev_flicker.gif?width=688&name=rev_flicker.gif)

RevFlicker is a touch enabled content carousel widget.

### Sample RevFlicker Code:

(bold values are to be replaced with your widget's unique values)

```
<div id="rev-flicker"></div><script src="https://labs-cdn.revcontent.com/build/revflicker.min.js"></script><script>new RevFlicker({id: 'rev-flicker',api_key: 'api_key',pub_id: 000,widget_id: 000,domain: 'your_site.com'});</script>
```

### Required Parameters:

**api\_key**

*Your account's API key*

```
api_key: 'hf3948hf9384hf938hf3hf0'
```

 

**domain**

*Site this widget will be implemented on*

```
domain: 'example.com'
```

 

**pub\_id**

*Your account ID*

```
pub_id: 1234
```

 

**widget\_id**

*Your widget ID*

```
widget_id: 123456
```

 

 

---

### Optional Parameters:

**id** (required if element is not used)

Matches a div id on the page. For example to target \<div id="my-flicker"\>\</div\> you'd use:

```
id: 'my-flicker'
```

 

**element** (required if an "id" is not used)

A jQuery wrapped element, will be used instead of "id" option

```
element: false
```

 

**ad\_border**

Set to "true" to display a border around each ad. Defaults to "false"

```
ad_border: true
```

 

**square\_border**

Set to "true" to display square borders. Defaults to "false"

```
square_border: false
```

 

**ad\_overlay**

Key value ad overlay config object where the key is the content type and the value is the icon to use. For example to use the video\_rectangle icon for video content use video: 'video\_rectangle'. The icon will be appended to the .rev-ad element

```
ad_overlay: false
```

 

**ad\_overlay\_position**

The position of the ad overlay icon. Available options include center, top\_left, top\_right, bottom\_right and bottom\_left

```
ad_overlay_position: 'bottom_right'
```

 

**css**

Additional custom CSS to append

```
css: ''
```

 

**devices**

Devices the widget will appear on. Options include phone, tablet and desktop

```
devices: [    'phone',     'tablet',     'desktop']
```

 

**dots**

Set to "true" to show pagination dots, or "false" to hide them

```
dots: false
```

 

**header**

The heading text displayed above the widget. Wrapped inside \<h2 class="rev-header"\>

```
header: 'Trending Now'
```

 

**headline\_size**

Number of lines that the headline can take up. Ignored if max\_headline is set to "true"

```
headline_size: 2
```

 

**hide\_provider**

Display the content's provider name

```
hide_provider: false
```

 

**image\_ratio**

Ratio of the images. Available options include wide\_rectangle, rectangle, square

```
image_ratio: (revDetect.mobile() ? 'wide_rectangle' : 'rectangle')
```

 

**hide\_header**

Set to "true" if you'd like to hide the widget's heading

```
hide_header: true
```

 

**image\_overlay**

Key value image overlay object config where the key is the content type and the value is the icon to use. For example to use the video\_rectangle icon for video content use video: 'video\_rectangle'. The icon will be appended to the .rev-image element

```
image_overlay: false
```

 

**image\_overlay\_position**

The position of the image overlay icon. Available options include center, top\_left, top\_right, bottom\_right and bottom\_left

```
image_overlay_position: 'center'
```

 

**internal**

Number of internal ads to display. sponsored option is ignored and only internal ads are shown

```
internal: false
```

 

**max\_headline**

Show entire headlines for all content, with no ellipsis. This option overrides headline\_size

```
max_headline: false
```

 

**multipliers**

Adjust sizing relative to the ad size. Can be negative values

```
{    line_height: 0,    font_size: 0,    margin: 0,    padding: 0}
```

 

**next\_effect**

Allows the next/halved ad to have a slight transition

```
next_effect: true
```

 

**next\_width**

A fixed number of pixels for the next/halved ad. If set will override next\_width\_percentage

```
next_width: false
```

 

**next\_width\_percentage**

By default the next/halved ad will be 20% of the regular ad width. All ads will be resized after setting the next/halved ad width

```
next_width_percentage: 5
```

 

**overlay\_icons**

Pass in custom icons where the key is the icon name and the value is the svg icon. For example {article\_square: '\<svg\>\</svg\>'}. Default icons include video\_rectangle, video\_square, video\_circle1, video\_circle2 and video\_triangle

```
overlay_icons: false
```

 

**per\_row**

Object or single value. Pass a single number to be used for every breakpoint or provide a value for each breakpoint

```
per_row: {    xxs: 1,    xs: 1,    sm: 3,    md: 4,    lg: 5,    xl: 6,    xxl: 7}
```

 

**query\_params**

Key value object for query params to send to server. Can be multidimensional

```
query_params: false
```

The example below demonstrates how to pass subid values. The resulting query parameters will be ?revsub\[key\]=value

```
query_params: {    revsub: {        key: 'value'    }}
```

 

**rev\_position**

Position of the disclosure text if hide\_disclosure is not enabled. Options include: 'bottom\_right', 'top\_right', 'bottom\_left'

```
rev_position: (revDetect.mobile() ? 'bottom_right' : 'top_right')
```

 

**show\_arrows**

Show paging arrows for mobile devices or desktop

```
{    mobile: false,    desktop: true}
```

 

**size**

Set fixed size for various measurements.

```
{    margin: false,    image_height: false,    headline_line_height: false,    headline_margin_top: false,    provider_line_height: false,    provider_margin_top: false,    provider_margin_bottom: false,    inner_margin: false}
```

 

**sponsored**

Number of sponsored ads to show. Internal option overrides this value to only show internal.

```
sponsored: 10
```

 

**text\_overlay**

Content headline text will overlay the image rather than be position below it if set to "true". Defaults to "false"

```
text_overlay: false
```

 

**text\_top**

Content headline text will be positioned above the image if set to "true". Defaults to "false"

```
text_top: false
```

 

**text\_right**

Content headline text will be positioned to the right of the image if set to "true". Defaults to "false"

```
text_right: false
```

 

**text\_right\_height**

Value in pixels of the ad image if text\_right is enabled

```
text_right_height: 100
```

 

**url**

Use an alternate API url

```
url: 'https://trends.revcontent.com/api/v1/'
```

 

**user\_agent**

Pass user\_agent param to API

```
user_agent: false
```

 

**user\_ip**

Pass user\_ip to API

```
user_ip: false
```

 

**arrow\_style**

Next/Previous arrow style. Options are "circle" or "square"

```
arrow_style: 'circle'
```

 

**arrow\_opacity**

Next/Previous arrow opacity. Can be 0.1 - 1

```
arrow_style: 1
```

 

**trending**

Set to "true" to display a trending number count. Defaults to "false"

```
trending: false
```

 

**window\_width\_devices**

Devices to enable the full viewport/window width feature where the widget will stretch the entire viewport width

```
window_width_devices: [    'phone', 'tablet']
```

 

- [General Information](https://help.revcontent.com/knowledge/general-information?hsLang=en)
- [Compliance Policies](https://help.revcontent.com/knowledge/compliance-policies?hsLang=en#main-content)

    - [Campaign Guidelines](https://help.revcontent.com/knowledge/compliance-policies?hsLang=en#campaign-guidelines)
    - [Site Guidelines](https://help.revcontent.com/knowledge/compliance-policies?hsLang=en#site-guidelines)
    - [Resources](https://help.revcontent.com/knowledge/compliance-policies?hsLang=en#resources)
- [Native API](https://help.revcontent.com/knowledge/native-api?hsLang=en)
- [Advertisers](https://help.revcontent.com/knowledge/advertisers?hsLang=en#main-content)

    - [RevContent Best Practices](https://help.revcontent.com/knowledge/advertisers?hsLang=en#revcontent-best-practices)
    - [Campaign Options](https://help.revcontent.com/knowledge/advertisers?hsLang=en#campaign-options)
    - [Optimization Tips and Tools](https://help.revcontent.com/knowledge/advertisers?hsLang=en#optimization-tips-and-tools)
    - [Troubleshooting](https://help.revcontent.com/knowledge/advertisers?hsLang=en#troubleshooting)
    - [Advertiser Tracking](https://help.revcontent.com/knowledge/advertisers?hsLang=en#advertiser-tracking)
    - [Advertiser API](https://help.revcontent.com/knowledge/advertisers?hsLang=en#advertiser-api)
    - [Accounting & Billing](https://help.revcontent.com/knowledge/advertisers?hsLang=en#accounting-billing)
    - [Demand-side Platforms](https://help.revcontent.com/knowledge/advertisers?hsLang=en#demand-side-platforms)
- [Publishers](https://help.revcontent.com/knowledge/publishers?hsLang=en#main-content)

    - [Publisher Account](https://help.revcontent.com/knowledge/publishers?hsLang=en#publisher-account)
    - [Widget Settings & Options](https://help.revcontent.com/knowledge/publishers?hsLang=en#widget-settings-options)
    - [Labs Widgets](https://help.revcontent.com/knowledge/publishers?hsLang=en#labs-widgets)
    - [Publisher Reporting](https://help.revcontent.com/knowledge/publishers?hsLang=en#publisher-reporting)
    - [Publisher Compliance](https://help.revcontent.com/knowledge/publishers?hsLang=en#publisher-compliance)
    - [Publisher Payments](https://help.revcontent.com/knowledge/publishers?hsLang=en#publisher-payments)
    - [Email](https://help.revcontent.com/knowledge/publishers?hsLang=en#email)
    - [Supply-side Platforms](https://help.revcontent.com/knowledge/publishers?hsLang=en#supply-side-platforms)
- [Email Monetization](https://help.revcontent.com/knowledge/email-monetization?hsLang=en)
- [Terms & Agreements](https://help.revcontent.com/knowledge/terms-agreements?hsLang=en)

[![Chill listening crop-3](https://help.revcontent.com/hs-fs/hubfs/revcontent-mark-BK-1.png?width=30&height=28&name=revcontent-mark-BK-1.png "Chill listening crop-3")](https://revcontent.com/)

© 2026, RevContent, LLC. All Rights Reserved.

[Copyright](https://www.revcontent.com/policy/copyright) [Cookie Policy](https://www.revcontent.com/policy/cookie-policy) [Privacy Policies](https://www.revcontent.com/policy/privacy-policy) [Opt Out](https://www.revcontent.com/legal/optout/?hsCtaTracking=5306afdf-6769-4bd9-87ab-280b36dd7363%7C39c8c8b7-a7b1-4c60-9381-2624d1633c34)