If you have a ballot that uses voter codes (whether generated or uploaded), you can include the code in the URL. This is particularly useful if you have a mixed election where you will distribute codes on paper to in-person attendees and distribute the urls with included codes by mail merge to remote attendees. To use this feature, add ?vc=VOTER-CODE to the end of the ballot URL, where ?vc= is literal text and you replace VOTER-CODE with each voter’s code.
If you are embedding your ballot or results in your website, you can style them to match your site. To do this append ?embed=true&style=STYLE-SPEC to the end of the URL, where ?embed=true&style= is literal text and you replace STYLE-SPEC with a style specification as described below.
The style specification consists of a series of attribute name-value pairs specifying the specific style values. Each pair consists of an attribute name followed by a value in brackets.
mode | Specifies if you want light mode (the default) or dark mode (light text on a dark background). Can be either mode[dark] or mode[light]. |
color | Theme color used for buttons and titles as a six-digit hexadecimal RGB value. |
bg | Page background color in RGB. |
font | Font to use or a list of fonts. This can be a generic CSS name like font[monospace] or the name of a specific font like font[Courier] or both mode[Courier,monospace]. RCV123 will check if the first listed font is on Google Fonts, and if it is, your ballot will link to it. If you use a named font, it’s recommended you include serif or sans-serif as a fallback in case your named font is not available. Note that Google Fonts treats font names as case sensitive. |
radius | Border radius for buttons as an integer number of pixels. border[0] will use square button and border[100] will use capsule-shaped buttons. |
The default color values are chosen based on your selected mode. If you specify colors, they should correspond with your selected mode. That is, the background should be close to black in dark mode and close to white in light mode. The theme color should contrast with the background color. The text color of buttons is automatically set to white for light mode, black for dark mode. If your color values are incompatible (you specify dark mode with a white background), they are ignored.
As an example, the default is style=mode[light]color[006AD5]background[ffffff]font[sans-serif]radius[8].