Temporarily Disable a Channel (History Preserved)

Introduction: Need a channel to temporarily stop sending messages to contacts? In RapidPro.app, you can disable a channel without removing it. Disabling keeps the channel’s configuration and history, while preventing it from being used for new outgoing messages.

Disable a channel safely (without deleting it)

If you just need the essentials, follow this quick path:

  1. Open Workspace Settings → Channels → open the channel → Edit
  2. Uncheck Enabled → Save
  3. Confirm what changes (sending stops, inbound auto-archives, URN routing)
  4. Know what won’t change (queued Outbox messages can still send)

Disabling preserves configuration and history—use it for maintenance windows, provider incidents, or staged rollouts.

Step-by-Step Process

1
Open the channel settings

  1. Go to Workspace Settings (gear icon).
  2. In the left menu, click Channels.
  3. Click the channel you want to disable.
  4. Open the channel menu ( / ) and select Edit.

[CAPTURE: Workspace Settings → Channels list → channel page with the Edit option highlighted.]

2
Disable the channel

  1. In the Edit pop-up, find the Enabled checkbox.
  2. Uncheck Enabled.
  3. Click Save.

[CAPTURE: Edit channel window showing Enabled unchecked.]

3
Understand what changes after disabling

What happens after disabling:

  • The channel is no longer available for sending messages to contacts.
  • Incoming messages to that channel are automatically archived.
  • If a contact’s only URN is tied to that channel, message attempts may fail with: “No suitable channel found”.

[CAPTURE: Channels list showing the channel status as disabled/unavailable for sending.]

⚠️
Important: If the disabled channel is the only path to reach a contact, delivery will fail until you re-enable it or add another enabled channel/URN for that contact.

4
Know what won’t stop immediately (Outbox queue)

Disabling a channel prevents new outbound sends, but queued messages may still deliver.

⚙️
Technical Detail: Messages already queued in the Outbox can continue to send (they will not fail). This depends on provider-side queuing and timing.

[CAPTURE: Outbox/queued messages view (if available) showing pending sends.]

Common Issues & Quick Fixes

I disabled the channel, but messages are still being delivered

Problem: After disabling, you still see deliveries happening.

Fix:

  • Check the Outbox: messages already queued can still send.
  • Wait for the provider queue to clear, then re-test with a new message.
Messages fail with “No suitable channel found”

Problem: RapidPro.app can’t find an enabled channel/URN to reach the contact.

Fix:

  • Confirm the contact has another valid URN (or another enabled channel that can reach them).
  • Re-enable the channel if it’s the only path for that contact.
I can’t find the “Edit” option for the channel

Problem: The channel menu doesn’t show Edit.

Fix:

  • Make sure you opened the channel page, not just the Channels list.
  • Confirm you have the right permissions (Admin access may be required).