UserVoice Destination

Segment makes it easy to send your data to UserVoice (and lots of other destinations). Once you've tracked your data through our open source libraries we'll translate and route your data to UserVoice in the format they understand. Learn more about how to use UserVoice with Segment.

Our User Voice destination code is open-source on GitHub if you want to check it out.

Getting Started

When you toggle on UserVoice in Segment, this is what happens:

  • Our CDN is updated within 5-10 minutes. Then our snippet will start asynchronously loading UserVoice’s javascript onto your page. This means you should remove UserVoice’s snippet from your page.
  • The UserVoice widget will appear on your page.

Identify

When you call identify the userId and traits included in the call will be set to the current user in UserVoice.

Group

When you call group the traits included in the call will be set to the current user’s Account in UserVoice.


Supported Sources and Connection Modes

WebMobileServer
📱 Device-based
☁️ Cloud-based

To learn more about about Connection Modes and what dictates which we support, see here.

Settings

Segment lets you change these destination settings via your Segment dashboard without having to touch any code.

Trigger Foreground Color

This will change the color of the text on the trigger, including the question mark.

Mode (Classic)

Select Mode

Primary Widget Color (Classic)

The primaryColor setting defaults to “#cc6d00”.

Show the UserVoice Widget on Page Load

Show the UserVoice Widget on Page Load

Invert the Tab's Colors (Classic)

The tabInverted setting defaults to false.

Custom Trigger Selector

If you want to have your own custom UserVoice trigger, add the CSS selector for the trigger here. It might look like: #uservoice-trigger.

Tab Position (Classic)

The tabPosition setting defaults to “middle-right”.

Custom Ticket Fields

This will allow you to set field value pairs for ticket custom fields (set via your admin console).

Trigger Position

The triggerPosition setting defaults to bottom-right

Mode

The mode setting defaults to “full”.

Enable Screenshots

This will allow users to submit a screenshot of the current window when submitting a message with the contact form.

Enable SmartVote

Enable SmartVote

Tab Color (Classic)

The tabColor setting defaults to “#cc6d00”.

Tab Label (Classic)

The tabLabel setting defaults to “Feedback & Support”.

Accent Color

Accent Color

Use the Classic Widget

If you want to use the classic version of the UserVoice widget make sure to enable this setting, and customize it using the any of the classic options below.

Forum ID (Classic)

Your Forum ID appears in the JavaScript code snippet as forum_id: YOUR_FORUM_ID.

The linkColor setting defaults to “#007dbf”.

Javascript API Key

Your API Key appears in the javascript snippet URL as widget.uservoice.com/APIKEY.js. This setting is required.

Trigger Background Color

This will change the background color of the trigger. It defaults to a translucent gray.


If you have any questions or see anywhere we can improve our documentation, please let us know or kick off a conversation in the Segment Community!