Not included in your plan? Want to learn more about the benefits? Leave us a message! If you're viewing this on our Help Center, click the Support bubble in the lower-right of this page.
Custom design lets you match your feedback portal to your brand with your own HTML, CSS and JavaScript.
Note: Custom design is a self-service feature. As we improve UserVoice, custom code may need adjusting, and keeping it up to date is your responsibility. Our support team is happy to help where we can, but we can only do limited troubleshooting on custom code.
Before You Start
UserVoice saves previous versions of your design, so you can undo a change. Before a big redesign, it's still a good idea to paste each box into a document as an extra backup.
Work in small pieces. Change one box or one section at a time, save, and check your portal before moving on. If something looks off, you'll know exactly which change caused it.
Keep in mind: Custom design changes how your portal looks, not how it works. It can’t control who sees a forum, and hidden content is still in the page’s code, emails and the Admin Console. See what custom CSS can and can’t do for details.
Turn On Custom Design
- Click the Settings icon in the bottom-left corner.
- Click Web Portal.
- Next to Appearance and Features, click Edit.
- Open the CSS/HTML/JavaScript tab.
- Tick Enable custom design.
Undo a Custom Design Change
Each time you save, UserVoice keeps a copy of the previous version.
On the CSS/HTML/JavaScript tab:
- Custom design last changed shows when your current design was saved and who saved it.
- Previous version from shows the version you can go back to.
To undo your last change:
- Click Revert last custom change.
- Click Revert to confirm. Any unsaved edits are discarded.
- To go back further, repeat these steps.
To return to the standard design, untick Enable custom design and save. Your custom code stays in place, so you can turn it back on later.
What Each Box Is For
| Box | Use it for |
|---|---|
| Custom CSS | All styling: colors, fonts, spacing |
| Head | Font links and other tags for the page's head |
| Header | Your logo, navigation and the sign-in area |
| Home Page | The layout of your portal's home page |
| Above / Below Sidebar | Extra content around the sidebar |
| Footer | Links and copyright |
| JavaScript | Scripts. This is the only box where scripts run. |
The Primary and Background colors on the General tab still style some UserVoice elements, so set them to match your brand too.
Good to Know
-
Keep
{{ render_user }}in your header. It shows the sign-in and account links. Without it, visitors can't sign in. - Scripts only run in the JavaScript box. A script pasted into an HTML box shows up as plain text on the page.
- Check your changes on the home page, a forum, an idea page, a profile and a phone screen.
Customize Specific Pages or Forums
Every page has classes on its <body> tag, so your CSS can target one page type or one forum. For example:
-
.uv-home-page,.uv-forum-pageand.uv-suggestion-pagetarget the home, forum and idea pages. -
.uv-forum-123456targets one forum and its idea pages. Find the number in the forum's address, like/forums/123456-feedback.
body.uv-forum-123456 .uvStyle-button { background: #1a5fb4; }See our CSS body classes reference for more. To change page layouts, you can also edit our HTML templates with Liquid. See Using Liquid in UserVoice and the Liquid documentation.
Using Custom JavaScript
Custom JavaScript can stop working as we improve UserVoice, and fixing it is up to you. To keep it reliable:
- Enhance your own header and footer content rather than changing how UserVoice pages behave.
- Run your code once the page has loaded, for example with jQuery's
document.ready.
Frequently Asked Questions
Can I preview changes before saving?
There's no built-in preview yet. Try CSS changes in your browser's developer tools first, or use a test portal if you have one.
Can I hide parts of my portal?
Yes, with CSS you can hide things like user names, sections of the sidebar or a forum from the forum list. Hiding only changes what's shown on screen. The content is still there: it remains in the page's code, can be reached by direct link, and still appears in emails and the Admin Console. See Advanced CSS: Custom Design with Body Classes for more.
My changes aren't showing. What should I check?
Make sure Enable custom design is ticked and saved, then refresh the page.
Can I customize the favicon?
Yes, this article walks you through it.