Web reader is in beta and switched on for selected accounts.


Settings and defaults
Under the colours, a contrast note says whether text on the background and text on the accent are readable (“Readable contrast (WCAG AA)”), or warns when one is below what WCAG AA asks for.


Layouts
The Floating layout is a look. Whether the player sits in the article or in a corner of the screen is decided by how the snippet is installed. See Inline or floating.


Player size
A fixed width never grows past the space the player is in.
Custom CSS
Use Custom CSS to restyle the player beyond the settings above.1
Start from a preset (optional)
Click a preset: Glass, Sharp, Outline or Compact. It replaces what is in the box.
2
Write your rules
Target
.wr-card or set the --wr-* variables. Click Show variables for the full list of variables and classes.3
Check the preview and save
The preview shows the result. Click Save changes.


You can also match the player’s state with
[data-state="ready"] (or loading, processing, error), [data-playing="true"], and [data-layout="compact"] (or any layout name).
Which rule wins
- Custom CSS always wins over the layouts: a layout only sets starting values for the same variables, so your
--wr-radiusor--wr-shadowapplies in every layout. - Custom CSS also wins over the theme and custom colours, for example
--wr-surfaceand--wr-text. - CSS set on one page with
data-custom-csswins over the CSS saved on the site. See Override on one page.
What is removed
Rules only apply inside the player. Before your CSS is used, Hamsa removes anything that loads a file or runs code:@import, @font-face, url() to anything except inline data:image images, and old script tricks. Rules that target the “Voiced by Hamsa” mark are dropped, and the mark always stays visible.
Floating launcher
When the snippet is installed with floating placement, readers first see a small button in the corner of the page. The Floating launcher card sets its Button label and shows a preview. The launcher takes its colours from the theme and accent. With inline placement there is no launcher, and this setting has no effect.

Good to know
- The Widget language and the reading are separate. An Arabic news site can offer an English reading and still show Arabic controls.
- On a page that reads right to left, the floating launcher sits in the bottom left corner instead of the bottom right.
- Readers can change speed (1x, 1.25x, 1.5x, 2x, 0.75x), mute, switch reading when you offer several, and download the audio.
Related
Add the player to your site
Inline or floating, and per-page overrides.
Set up a site
Readings, voices and dictionaries.