---
title: Mobile RevToaster
description: A guide to setting up and modifying RevToaster widgets
---
[Skip to content](https://help.revcontent.com/knowledge/mobile-revtoaster#main-content)
[](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)
# Mobile RevToaster
## A guide to setting up and modifying RevToaster widgets
RevToaster displays as the user scrolls back to the top of the page on a mobile device.
### Sample RevToaster Code:
(bold values are to be replaced with your widget's unique values)
```
```
### 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:
**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'
```
**closed\_hours**
Number of hours to remain closed, after being closed by user
```
closed_hours: 24
```
**css**
Additional custom CSS to append
```
css: ''
```
**devices**
Devices the widget will display on. Options include phone, tablet and desktop
```
devices: [ 'phone', 'tablet']
```
**header**
Heading displayed above content. Wrapped inside ''
```
header: 'Trending Now'
```
**hide\_provider**
Option to hide content provider names
```
hide_provider: false
```
**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'
```
**overlay\_icons**
Pass in custom icons where the key is the icon name and the value is the svg icon. For example {article\_square: '\\'}. Default icons include video\_rectangle, video\_square, video\_circle1, video\_circle2 and video\_triangle
```
overlay_icons: false
```
**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. Options include: 'bottom\_right', 'top\_right', 'bottom\_left'
```
rev_position: 'bottom_right'
```
**show\_visible\_selector**
Query selector for element that will trigger widget to show once visible
```
show_visible_selector: false
```
**sponsored**
Number of sponsored ads to show. Options are "1" or "2"
```
sponsored: 1
```
**testing**
Ignores closed\_hours and continues to pop with every upward scroll when set to "true"
```
testing: false
```
**user\_agent**
Pass user agent param to API
```
user_agent: false
```
**user\_ip**
Pass user's IP to API
```
user_ip: false
```
- [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)
[](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)