> ## Documentation Index
> Fetch the complete documentation index at: https://docs.covver.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Widgets

> Add games, a photo carousel or your own interactive block to a page, and test them with Interactive mode.

Widgets are ready-made interactive blocks. Readers play or browse them right on the page.

## Add a widget

**1. Open the Widgets panel**

Click **Widgets** in the left rail.

**2. Pick one**

On the **Widgets** tab, click a card to add it to the current page.

**3. Set it up**

Select the widget on the page and adjust its settings in the right sidebar.

## Built-in widgets

> [accordion] Hangman
>
> Readers guess a word letter by letter. It is added at full page size.
>
> Under **Hangman settings** you can set:
>
> * **Words**: one word per line, letters A to Z, 2 to 15 characters each.
> * **Max wrong guesses**: from 3 to 10.

> [accordion] Tic-Tac-Toe
>
> The classic grid game for two players sharing the same screen. It is added at full page size and has no settings.

> [accordion] Photo carousel
>
> A slideshow that plays on its own.
>
> * **Photos**: up to 10. Drop photos from the **Library** panel onto the carousel to add them, and remove one with the button on its thumbnail.
> * **Seconds per photo**: from 1.5 to 15.
> * **Transition**: **Fade** or **Slide**.
> * **Position dots**: show or hide the dots that mark the current photo.

> [!NOTE]
>
> Your account may show additional widgets that Covver has enabled for you.

## Your own widgets

A custom widget is a block of HTML, CSS and JavaScript that you provide: a poll, a quote of the day, a small game, anything you can code.

**1. Create it**

In the **Widgets** panel, open the **My widgets** tab and click **New widget**.

**2. Add the code**

Give it a **Name**, an optional **Description**, and paste your code. The **Preview** on the right shows the result. Click the refresh button to reload it.

**3. Save**

Click **Save** to keep it in your list, or **Save & add to page** to place it right away.

Not a coder? Click **Ask the AI to write it** and describe what you want. See [AI overview](https://docs.covver.com/ai/overview.md).

From the menu on each widget in **My widgets** you can **Add to page**, **Edit**, **Duplicate** or **Delete** it.

### Things to know

* The code can be up to 200 KB. The counter above the code box shows how much you have used.
* A custom widget runs isolated from the rest of the magazine. It can load images, fonts and scripts from other sites over `https`, but it has no access to the page around it, to cookies or to the reader's session. It can't remember anything between visits.
* A widget placed on a page is a copy. Editing or deleting it in **My widgets** does not change pages where you already used it. Add it again to pick up your changes.

## Test with Interactive mode

While you design, a click on a widget selects it so you can move and resize it. To play it:

1. Find the controls next to the page and click **Interactive mode** (the game controller icon).
2. Play the game, flip through the carousel, or try your custom widget.
3. Click **Interactive mode** again to go back to designing.

Interactive mode also wakes up everything else on the page: [links](https://docs.covver.com/builder/links.md), [embeds](https://docs.covver.com/builder/embeds.md), [video and audio](https://docs.covver.com/builder/media.md) and [page locks](https://docs.covver.com/builder/page-lock.md).

## What readers see

Widgets work the same in the published magazine as they do in Interactive mode. Each reader gets their own game: nothing is shared between readers.

Widgets are interactive, so they are replaced by a placeholder when you export to an image or PDF. See [Export](https://docs.covver.com/builder/export.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.