---
title: "Action subscription__remove"
description: "Unsubscribes the user from one or all broadcast topics."
---

# Action `subscription__remove`

> **System ID:** `action_subscription__remove`  
> Also in scenario: `subscription__remove`  
> Alias for the same logic: [`broadcast__unsubscribe`](/en/actionjail/reference/actions/broadcast__unsubscribe.md) (`action_broadcast__unsubscribe`).

## Description

Removes the user's subscription from a broadcast topic. If `topic_id` is omitted or equals `"*"`, unsubscribes from all topics.

## Events (scenario branches)

| Event | When it occurs |
|-------|----------------|
| **success** | Unsubscribe completed |
| **error** | Unsubscribe failed (module unavailable or status error) |

## Parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `topic_id` | string | no | `*` | Topic to unsubscribe from; `*` — all topics. Supports placeholders |

## Configuration example

Unsubscribe from one topic:

```json
{
  "topic_id": "news"
}
```

From all topics:

```json
{
  "topic_id": "*"
}
```

## Related docs

- [Actions reference](/en/actionjail/reference/actions-reference.md)
- [Action broadcast__unsubscribe](/en/actionjail/reference/actions/broadcast__unsubscribe.md)
- [Action subscription__set](/en/actionjail/reference/actions/subscription__set.md)
- [Action subscription__check](/en/actionjail/reference/actions/subscription__check.md)