Skip to main content
Web reader is in beta and switched on for selected accounts.
The Appearance and Floating launcher cards on a site’s Settings tab decide how the player looks on your articles. Every change shows in the preview at the top of the card first, and reaches your site when you click Save changes. Readings and voices are on Set up a site.
The Appearance card: the player preview, Widget language, Theme set to Dark and the lime accent colourThe Appearance card: the player preview, Widget language, Theme set to Dark and the lime accent colour

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.
Theme set to Custom, with Accent colour, Background and Text fields and the contrast noteTheme set to Custom, with Accent colour, Background and Text fields and the contrast note
Theme, colours, accent, widget language and button label travel in the snippet. After saving them, copy the snippet again from Setup and replace it on your site.

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.
The Layout choices and the Player size fields: Width, Maximum width, Height, Minimum height and AlignmentThe Layout choices and the Player size fields: Width, Maximum width, Height, Minimum height and Alignment

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.
The Custom CSS field with the Glass preset applied, the four presets and Show variablesThe Custom CSS field with the Glass preset applied, the four presets and Show variables
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-radius or --wr-shadow applies in every layout.
  • Custom CSS also wins over the theme and custom colours, for example --wr-surface and --wr-text.
  • CSS set on one page with data-custom-css wins 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.
The Floating launcher card with a preview of the Listen to Article button and the Button label fieldThe Floating launcher card with a preview of the Listen to Article button and the Button label field

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.

Add the player to your site

Inline or floating, and per-page overrides.

Set up a site

Readings, voices and dictionaries.