---
title: Managing Handlers and Topics
description: Learn how to create, edit, and delete handlers and topics.
documentId: managing-handlers
locale: en-US
---

On the **Handlers** screen, you can [create](#creating-a-handler-and-topics) new handlers, as well as modify existing ones by either [editing](#editing-a-handler-and-topics) their settings or [deleting](#deleting-a-handler-and-topics) the handler entirely.

During the process of creating or editing handlers, topics are created to complete the event publishing URL, which is used by publishers to send requests to the Events Hub.

## Creating a handler and topics

You can create a new handler by clicking the floating **[+]** button.

The configuration process consists of four steps, described below: **OVERVIEW**, **TOPICS**, **POLICY**, and **REVIEW**.

### Overview

![Overview](https://creative-ball-51b3fc85c0.media.strapiapp.com/handlers_create_overview_5c9cfea94d.png)

The first screen contains the basic information fields for the handler:

- **Name**: the name of the handler.

- **Version**: the version of the handler being created.

- **Description**: an optional field to describe the handler.

- **Base Path**: a required field to specify the path related to the handler; it will be part of the publishing URL ([learn more about this here](/docs/events-hub/handlers#event-publishing-url)).

<Callout type="NOTE" title="NOTE">
The handler's base path must be unique; you cannot register more than one handler with the same base path.
</Callout>

### Topics

The second step in creating handlers is dedicated to creating the topics that will be grouped under it. 
Topics are the final part of the publishing URL for sending events to the Events Hub.

![Topics](https://creative-ball-51b3fc85c0.media.strapiapp.com/handlers_create_topics_71c876f244.png)

To create a new topic, click **ADD TOPIC**. This will open a screen to enter the name (which will be concatenated to the publishing URL) and an optional description:

![Add Topic](https://creative-ball-51b3fc85c0.media.strapiapp.com/handlers_create_topics1_a98e2b86d0.png)

You can add as many topics as you want, and they will be listed as shown below:

![Topic List](https://creative-ball-51b3fc85c0.media.strapiapp.com/handlers_create_topics2_3e096314b3.png)

You can edit the topic's name or description by clicking the pencil icon and delete the topic by clicking the trash icon.

Clicking the ![Expand](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_expand_62b33f1187.png) icon allows you to view the registered contexts and enable each topic in the desired contexts (via the **AVAILABLE** column button):

![Contexts](https://creative-ball-51b3fc85c0.media.strapiapp.com/handlers_create_topics3_91f2127103.png)

<Callout type="WARNING" title="WARNING">
Topics can be linked to contexts later through editing. 
If a topic is **not** linked to a context, it will not be possible to send events to it.
</Callout>

### Policy

In the **POLICY** step, you can apply a security policy and automatic retry settings to your handler:

![Policy](https://creative-ball-51b3fc85c0.media.strapiapp.com/handlers_create_policy_5d11f920c4.png)

Security is defined by authorization validation interceptors that must be applied for a publisher's request to be accepted by the Events Hub.

Retry settings define the number of automatic attempts to be made if the initial publishing attempt to subscribers fails. They also specify the status codes that should trigger a retry and the maximum request timeout.

<Callout type="TIP" title="TIP">
Learn more about policy configurations [here](/docs/events-hub/policies).
</Callout>

You can choose an existing policy from the **Policies** page (by selecting a policy from the list) or create a new one (using the **CREATE NEW POLICY** button). 
The creation process is the same in both cases ([see details here](/docs/events-hub/policies#creating-a-policy)).

Clicking the ![Expand](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_expand_62b33f1187.png) icon will display the retry settings and applied security interceptors:

![Policy Settings](https://creative-ball-51b3fc85c0.media.strapiapp.com/handlers_create_policy1_f021d868f8.png)

<Callout type="NOTE" title="NOTE">
You can only choose one policy per handler.
</Callout>

### Review

The final step displays a summary of the created handler, listing the topics grouped under it and the applied policy:

![Summary](https://creative-ball-51b3fc85c0.media.strapiapp.com/handlers_create_review_bb9e8ee8e1.png)

As in the **TOPICS** step, clicking the ![Expand](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_expand_62b33f1187.png) icon on a topic's row allows you to view the registered contexts and enable each topic in the desired contexts. 
Similarly, in the **POLICY** step, clicking the ![Expand](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_expand_62b33f1187.png) icon on the selected policy's row displays the retry settings and applied security interceptors.

## Editing a handler and topics

A handler can be edited from the Overview screen (as shown below) by clicking the **EDIT HANDLER** button.

![Edit Handler](https://creative-ball-51b3fc85c0.media.strapiapp.com/handlers_overview_topics_abf39dc0b1.png)

The Overview screen is accessed by clicking on a handler card (when the **Handlers** screen is in card view) or the ![Overview](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_overview_da2c2d81e5.png) icon in the handlers table (when the handlers screen is in list view).

Using the **EDIT HANDLER** button, you can edit a handler's basic information (name, description, and base path).

Topics can be edited via the pencil icon in the **TOPICS** tab.

The selected policy can be replaced with another. To do this, click the ![Change](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_change_ecb856f34b.png) icon in the **POLICY** tab and select another policy from the list. 
To remove the selected policy, click the same ![Change](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_change_ecb856f34b.png) icon and then ![Remove](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_remove_04475aafe4.png):

![Remove Policy](https://creative-ball-51b3fc85c0.media.strapiapp.com/handlers_rmv_policy_9240f8c3ae.png)

You can also edit the policy by clicking its name in the **POLICY** tab and then the pencil icon.

## Deleting a handler and topics

You can delete a handler entirely by clicking the trash icon in the handler's row in the list view of the handlers screen or, alternatively, by clicking the same icon within the handler's Overview screen. 

The Overview screen is accessed by clicking on a handler card (when the **Handlers** screen is in card view) or the ![Overview](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_overview_da2c2d81e5.png) icon in the handlers table (when the **Handlers** screen is in list view).

If a handler is deleted, all topics grouped under it will also be deleted. 
Individual topics can be deleted in the **TOPICS** tab of the Overview screen by clicking the trash icon in the topic's row.
