---
name: "up.radio"
area: "API"
kind: "module"
parent: "API reference"
url: "https://unpoly.com/api/up.radio"
---
<nav aria-label="Unpoly docs">[All docs](https://unpoly.com/index.md) · [API reference](https://unpoly.com/api.md)</nav>

# `up.radio`

Features to update fragments without a user click.

An element with [`[up-hungry]`](https://unpoly.com/api/up-hungry.md) is updated whenever a server response contains a matching element, even when the response was requested for a different target. This keeps things like unread counters current with every request. [`[up-flashes]`](https://unpoly.com/api/up-flashes.md) builds on this to show confirmations and alerts from any response, including responses rendered in an overlay. An element with [`[up-poll]`](https://unpoly.com/api/up-poll.md) reloads itself from the server periodically, and [`up:fragment:poll`](https://unpoly.com/api/up:fragment:poll.md) lets your code skip a scheduled reload.

<nav aria-label="Guides">

- [Learn: Live fragments](https://unpoly.com/learn/live-fragments.md)
- [Learn: Notification flashes](https://unpoly.com/learn/flashes.md)

</nav>

---

## Features {#features}

- ### [[up-flashes]](https://unpoly.com/api/up-flashes.md) (HTML attribute)

  Use an `[up-flashes]` element to show confirmations, alerts or warnings.

- ### [up:fragment:hungry](https://unpoly.com/api/up:fragment:hungry.md) (DOM event)

  Before an `[up-hungry]` element is added to a render pass, an event `up:fragment:hungry` is emitted on that element.

- ### [up:fragment:poll](https://unpoly.com/api/up:fragment:poll.md) (DOM event)

  This event is emitted before a polling fragment is reloaded from the server.

- ### [[up-hungry]](https://unpoly.com/api/up-hungry.md) (HTML attribute)

  Elements with an `[up-hungry]` attribute are updated whenever the server sends a matching element, even if the element is not targeted.

- ### [[up-poll]](https://unpoly.com/api/up-poll.md) (HTML attribute)

  Elements with an `[up-poll]` attribute are reloaded from the server periodically.

- ### [up.radio.config](https://unpoly.com/api/up.radio.config.md) (Configuration object)

  Configures defaults for passive updates.

- ### [up.radio.startPolling(fragment, [options])](https://unpoly.com/api/up.radio.startPolling.md) (JavaScript function)

  Starts polling the given element.

- ### [up.radio.stopPolling(fragment)](https://unpoly.com/api/up.radio.stopPolling.md) (JavaScript function)

  Stops polling the given element.