Controlling where Onyx responds

Controlling where Onyx responds

Onyx only responds in channels you explicitly configure. Everything else in your server is ignored.

Enabling channels

In your Onyx dashboard, go to Configuration. Under the Support Channels section, select the Discord channels where you want Onyx to be active. Onyx will only monitor and respond in the channels you add here.

Hobby plan channel limit

The free Hobby plan supports one monitored channel. If you need to monitor multiple channels simultaneously, you'll need to upgrade to a paid plan.

Per-channel settings

Each configured channel has two independent settings:

Thread creation

When thread creation is enabled, Onyx creates a new Discord thread for each conversation — keeping your main channel clean and discussions organized. When disabled, Onyx replies inline in the channel.

Trigger mode

• Always replies (default) — Onyx responds to all messages in the channel that it classifies as genuine questions.
• Mentions only — Onyx only responds when directly @mentioned. Useful for busy channels where you don't want the bot engaging on every message.

Note: once Onyx creates a thread, subsequent messages within that thread do not require a mention — even if the channel is set to "mentions only."

Ignoring specific users

You can add Discord user IDs to an ignore list from the Configuration page. Onyx will silently skip all messages from ignored users. This is available on all plans.

Ignoring roles (Starter+ only)

On Starter, Growth, and Scale plans, you can also ignore entire roles. Any user who holds an ignored role will be skipped by Onyx, regardless of which channel they're in.

AI response footer

Every response Onyx sends includes a short footer line. On the Hobby plan, this footer is a fixed watermark — -# Powered by Onyx — and cannot be changed.

On Starter, Growth, and Scale plans, you can customize or remove this footer from the Configuration page under Response Footer. The footer must be at least 10 characters if set, or left blank to disable it entirely.

Automatic filtering

Onyx automatically ignores messages from other bots, system messages, and messages it classifies as non-questions (greetings, reactions, etc.). You are not charged for any filtered or ignored messages.