Customizing your widget

You can set options globally by pushing the set command. Note that order of operations is significant. Only widgets added afterward will be affected by global changes to options.

Setting global options one-by one:

UserVoice.push(['set', 'key', value]);
UserVoice.push(['set', 'key', value]);

Setting multiple global options at once

Pass a valid Javascript object to set multiple keys:

UserVoice.push(['set', {
  key: value,
  key: value

Local (per-widget) options

You can also override global options for a specific widget:

UserVoice.push(['addTrigger', {
  key: value,
  key: value

If creating a custom trigger or embedding a widget using HTML attributes, you can set local options using HTML attributes:

<a href="" data-uv-trigger data-uv-key="value">Leave Feedback</a>


Option key Type Default value Description
trigger_style string 'icon' What the default trigger looks like. You can also use your own custom trigger.

trigger_position string 'bottom-right' for an icon trigger

'right' for a tab trigger
Determine which position on the screen the trigger will appear.

Icon-style positions:

Additional Tab-style positions:
trigger_color string 'white' Specify the foreground color of the trigger. Any valid CSS color value is acceptable.
trigger_background_color string 'rgba(46, 49, 51, 0.6)' Specify the background-color of the trigger. Any valid CSS color value is acceptable.
trigger_prevent_default_enabled boolean true Prevents default event from occurring when the user clicks on a trigger.

Set to false to allow default events to fire in addition to the trigger click event.
target string;
DOM element
'self' (if the widget was triggered from an element on the screen)

false (if there isn’t an element that triggered the widget - appears as a toast)
If using the popover widget style, you can choose a different element to target than the trigger used to spawn the widget. Useful if your custom trigger is inside a dropdown menu and you want the popover to point to the menu’s parent.

'self' (default; popover)
false (default if there is no ‘self’ element to target; toast)
DOM element (popover)
'#elementId' (popover)
position string 'automatic' (for popovers)

'bottom-right' (for toasts)
Widget position. If a target is set, then the position determines which side of the target the widget appears on.

Popover positions:

Toast positions:
height string '325px' If embedded inline and the containing element already has a height set via CSS, the widget will automatically match that height—otherwise it defaults to 325px.
width string '100%' (when embedded inline)

'296px' (when displayed in a popover or toast)
Widget width.
accent_color string #458dd6 Customize the accent and highlight color for the widget to whatever color specified. It is best to use a color that white text can be displayed over. Any valid CSS color value is acceptable.
mode string 'post_idea' 'satisfaction'
'contact' (HelpDesk only)
locale string Your account’s default locale (set in the admin console) Specify the language various UI elements will be displayed in. This does not change the language of your content.

e.g., 'en'
forum_id int Your account’s default forum Specify which forum the toolkit uses for posting suggestions.

Note: private forums are not supported.
ticket_custom_fields object Pass in field:value pairs for ticket custom fields (set via your admin console).
menu_enabled boolean true (when opening the widget via the default trigger)

false (for custom triggers, 'autoprompt', 'show', and 'embed' methods)
Determines if the first screen on the widget includes menu items for other actions.

Set to true if you want to show the menu when creating custom triggers.
contact_enabled boolean true Set this to false to disable links to “Send us a message”.
screenshot_enabled boolean true Allow users to submit a screenshot of the current window when submitting a message with the contact form.
permalinks_enabled boolean true Disable web portal permalinks to suggestions and articles when viewing Instant Answer results.
post_suggestion_enabled boolean true Set this to false to prevent users from posting suggestions to your forum.
strings object* Advanced: Specify a series of string key/value pairs to override default widget text.

Customizing widget text (advanced):

DISCLAIMER: You should always test the widget when overriding the default text. Strings are meant to be customized within reason, and really long strings may break the layout of the widget.

To override default widget text, pass the key/value pairs of the strings you want to change via the strings object:

UserVoice.push(['set', {
  // (include other options here)
  strings: {
    key: 'value',
    key: 'value'
    // Etc.
Context Key Default value (string)
Menu items contact_menu_label Send us a message
Posting a suggestion post_suggestion_title Post an idea
post_suggestion_body When you post an idea to our feedback forum, others will be able to subscribe to it and make comments.
post_suggestion_message_placeholder Describe your idea
post_suggestion_skip_instant_answers_button Skip and post idea
post_suggestion_details_title Additional details
suggestion_title_label Idea title
suggestion_title_placeholder Summarize your suggestion
suggestion_category_label Category
post_suggestion_submit_button Post idea
post_suggestion_success_title Thank you!
post_suggestion_success_body Your feedback has been posted to our %{link:feedback forum}.
Instant Answers instant_answers_title Are any of these helpful?
instant_answers_related_suggestions_label Related ideas
suggestion_subscribe_button I want this!
post_suggestion_confirm_title Okay.
post_suggestion_confirm_body Do you still want to submit an idea?
instant_answers_success_title Thank you!
instant_answers_success_body We take your feedback to heart.
instant_answers_related_articles_label Related articles
article_pick_button This answers my question
contact_confirm_title Awesome!!!
contact_confirm_body Do you still want to send us a message?
NPS® Rating satisfaction_message_title Why did you pick that score?
satisfaction_message_placeholder Enter your feedback
satisfaction_success_title Thank you!
satisfaction_success_body We take your feedback to heart.
Contact form (HelpDesk only) contact_title Send us a message
contact_message_placeholder Give feedback or ask for help
contact_skip_instant_answers_button Skip and send message
contact_details_title Additional details
contact_submit_button Send message
contact_success_title Message sent!
contact_success_body We’ll be in touch.
Misc email_address_label Your email address
email_address_placeholder Email address

Related topics

Didn’t find what you’re looking for?

Check out the UserVoice knowledgebase for more documentation.

Explore the Knowledgebase