Docs

Link Blocker

Block unwanted links with exemptions and whitelisting

What is Link Blocker?

Link Blocker is a powerful moderation tool that automatically detects and blocks unwanted links in your server. You can configure exemptions for specific roles, channels, or categories, and maintain a whitelist of allowed URLs.

Key Features

Automatic Link Detection

Detects all types of URLs including http://, https://, and domain patterns

Flexible Exemptions

Exempt specific roles, channels, or entire categories from link blocking

URL Whitelisting

Maintain a whitelist of allowed domains that will never be blocked

Multiple Actions

Choose to delete messages, warn users, or apply timeouts when links are blocked

How to Set Up Link Blocker

01

Enable the Module

Go to modora.gg/dashboard and select your server. Open Modules, find Link Blocker, enable it, then click to open the settings.

Dashboard → Your Server → Modules → Link Blocker

02

Configure Action Settings

Choose what happens when a link is blocked: Delete the message, warn the user, or timeout them. For timeouts, set the duration (minimum 60 seconds).

Link Blocker → Action dropdown (Delete / Warn / Timeout)

03

Set Up Logging (Optional)

Select a channel where blocked/allowed links will be logged. Helps you track moderation actions and review decisions.

Link Blocker → Log channel dropdown

04

Configure Exemptions

Add roles, channels, or categories exempt from link blocking. Users with exempt roles or posting in exempt channels can share links freely.

Link Blocker → Exemptions section → Add roles/channels/categories

05

Add Whitelisted URLs

Add domains or full URLs to your whitelist. These will always be allowed. Examples: example.com, https://example.com, *.example.com/* (wildcards supported).

Link Blocker → Whitelist → Add URLs

06

Save Settings

Click 'Save' to apply your configuration. The module will start blocking links immediately.

Link Blocker → Save button

Wildcard Support in Whitelist

You can use wildcards (*) in your whitelist to match multiple domains or paths: *

*.example.com

Matches all subdomains: subdomain.example.com, www.example.com, api.example.com

*.example.com/*

Matches all subdomains and all paths: subdomain.example.com/any/path

example.com/*

Matches all paths on the main domain: example.com/page, example.com/any/path

*.example-store.com/*

Matches all subdomains and paths: shop.example-store.com/products, www.example-store.com/checkout

Understanding Exemptions

Role Exemptions

Users with exempt roles can post links in any channel. This is useful for staff members, trusted members, or specific role groups.

Channel Exemptions

Links are allowed in exempt channels regardless of user roles. Perfect for channels like #self-promo, #resources, or #links.

Category Exemptions

All channels within an exempt category allow links. Simply select categories from the dropdown to exempt entire sections of your server.

Action Types

Delete Message

The message containing the link is immediately deleted. The user receives no notification.

Warn User

The message is deleted and the user receives a DM explaining that their link was blocked. They can see which URL was blocked.

Timeout User

The message is deleted, the user is timed out (muted) for the specified duration, and they receive a DM explaining the action. Duration can be set from 60 seconds to 28 days.

Logging System

Info

Link Blocker maintains a comprehensive log of all link-related actions:

  • Blocked links: Shows when a link was blocked, which user posted it, and why it was blocked
  • Allowed links: Shows when a link was allowed due to exemptions or whitelisting
  • Log channel: All actions are also logged to your configured Discord channel for easy review

Best Practices

Start with Exemptions

Before enabling, set up exemptions for your staff roles and any channels where links should be allowed. This prevents accidentally blocking legitimate content.

Whitelist Trusted Domains

Add commonly used domains (like YouTube, Discord, GitHub) to your whitelist if you want to allow them while blocking others.

Use Logging

Enable logging to a dedicated mod-log channel so your team can review blocked links and adjust settings as needed.

Combine with AutoMod

Link Blocker works great alongside AutoMod. Use Link Blocker for general link control and AutoMod for more advanced spam detection.

Troubleshooting

Troubleshooting

Links are not being blocked

  • Make sure the module is enabled (toggle switch at the top)
  • Check if the user has an exempt role
  • Verify the channel is not in the exempt channels list
  • Check if the URL is in your whitelist

Too many false positives

  • Add more domains to your whitelist
  • Create exemptions for channels where links are commonly shared
  • Consider exempting specific roles that need to share links

Was this page helpful?