Customizing Your Accessibility Widget
Custom branding and badge removal are exclusive to Sienna Pro and Sienna Agency licenses. The Free tier includes standard branding. Upgrade to Pro to unlock these features.
Sienna was built to feel like a native part of your website, not a bolted-on third-party plugin. With a Pro license, you can pass custom data attributes to the script to completely re-theme the widget.
Passing Design Parameters
To customize the widget, add data- attributes directly to your Sienna <script> tag.
Here is a fully customized example:
<script src="https://cdn.jsdelivr.net/npm/sienna-accessibility/dist/sienna.min.js"
data-primary-color="#FF5733"
data-button-icon="human"
data-position="bottom-left"
data-hide-badge="true"
data-key="pro_YOUR_LICENSE_KEY_HERE"
defer>
</script>Available Customization Options
| Attribute | Default | Description |
|---|---|---|
data-primary-color | #2563eb (Blue) | Changes the main accent color of the widget button and all active toggles inside the menu. Accepts any valid HEX code. |
data-position | bottom-right | Where the trigger button appears. Options: bottom-right, bottom-left, top-right, top-left. |
data-button-icon | accessibility | Changes the trigger icon. Options: accessibility (standard universal icon), human (classic human figure), eye (eye icon), wheelchair. |
data-hide-badge | false | Set to true to remove the “Powered by Sienna” watermark at the bottom of the widget menu. |
data-key | null | Your Pro or Agency license key. Required to validate custom colors and badge removal. |
Why White-Labeling Matters
For modern brands and digital agencies, maintaining a cohesive design system is critical. A blue widget on a green-themed website creates visual friction. By matching the data-primary-color to your brand guidelines, Sienna feels like a premium, custom-built feature rather than an off-the-shelf freebie.
If you are building sites for clients, the Agency Plan allows you to use these white-labeling features across unlimited websites, ensuring every client gets a seamless, unbranded experience.