Whitelist
The Whitelist feature allows you to define a list of approved users, groups, or channels whose messages will be forwarded. This ensures that only content from specific sources is included in the forwarding process, helping you filter and control message flow effectively.
How It Works
When you add a user, group, or channel to the Whitelist, their messages will be forwarded.
Messages from sources not on the Whitelist will be ignored.
If no Whitelist is set up, messages from all sources are forwarded (unless other filters like Blacklist are applied).
1. Accessing the Replace Feature
On Mobile App
Open the Auto Forward mobile app.
Go to the Dashboard.
Tap on the Whitelist icon (highlighted below).

On Web Dashboard
Log in to the Auto Forward Web Dashboard.
In the left-hand menu under Features, click on Whitelist.

Next Tap on the Add New button (as shown in the image below):

2. Create Whitelist Rule

Options for Blacklist Apply To
Post:
Reply:
Options Whitelist Type
You can choose one of the following Whitelist Types:
Basic: Add simple words or phrases to the whitelist.
Regex: Use Regular Expressions (Regex) for advanced filtering.
Whitelist by User: Whitelist messages from specific users.
1. Enter a Label
Add a Label to identify your whitelist rule.
Example:
trusted_wordsorfilter_links.
2. Select Whitelist Type
Basic: Enter one or more words (separate them with commas).
Example:
hello,cat,dog.
Regex: Use a regex pattern for advanced filtering.
Example:
\bhello\b(matches the word "hello" fully).
3. Full Content (Optional)
You can paste the original content to test or match against the rule.
4. Apply to Tasks (Optional)
In the Apply For Task field, select a specific task if needed.
5. Save the Rule
Tap Create Whitelist to save and activate the rule.
4. Whitelist Type
1. Basic Whitelist
The Basic Whitelist allows you to forward messages containing specific words or phrases.
Steps to Use
Go to Whitelist → Tap Add New.
Select Basic in the Whitelist Type dropdown.
Add the words/phrases to the Content Whitelist field.
Tap Create Whitelist to save.

Example Scenarios
Forward messages containing "news" or "alert"
Content Whitelist:
news,alertExample Message:
Result: Forwarded ✅
Forward messages containing "update" or "report"
Content Whitelist:
update,reportExample Message:
Result: Forwarded ✅
2. Regex Whitelist
The Regex Whitelist is used for advanced matching. allows you to match complex patterns, not just exact words — giving you more control and flexibility when filtering.
If you’re not confident with writing regular expressions, you can ask AI platforms to help you generate them.
Recommended tools:
🧠 ChatGPT – just ask:
E.g: “Write a regex to match hashtags starting with # and ending with space.”
🔍 These tools can explain, test, and even fix your regex patterns for you.
Steps to Use
Go to Whitelist → Tap Add New.
Select Regex in the Whitelist Type dropdown.
Enter the Regex pattern in the Content Whitelist field.
Tap Create Whitelist to save.

Combine with many condition AND, OR

What are AND and OR Conditions?
AND Condition:
Ensures that all specified conditions must be met for a message to pass the Whitelist filter.
Example: A message must contain "BUY" and "SL: 13213".
OR Condition:
Ensures that any one of the specified conditions is met for a message to pass the Whitelist filter.
Example: A message must contain "BUY" or "SELL".
Add AND/OR Conditions
To Add an AND Condition:
Tap the + AND button to add another condition that must also be met.
Example: After entering
BUY, addSL: 13213.
Result: The message must include both "BUY" and "SL: 13213" to pass the filter.
To Add an OR Condition:
Tap the + OR button to add another condition where either can be met.
Example: After entering
BUY, addSELL.
Result: The message must include either "BUY" or "SELL" to pass the filter.

Checkout Example Scenarios
3. Video and document media filters
Media filters let you whitelist Telegram videos by duration or size, and documents by size. They are available for Forward and Clone connections on active Platinum and Trial Platinum plans.
Choose the right media type
Choose Video duration, Video size, or Document size from the Filter type dropdown. Video duration checks the runtime of Telegram videos in seconds (s) or minutes (m). Video size checks Telegram video file size. Document size applies to files sent as Telegram documents, including videos sent as documents. Each media rule has one condition: >, >=, <, <=, or =, with a decimal value and the unit shown in the form. Examples: ≥ 30s, > 10MB, and > 100MB. Size filters use KB, MB, or GB.

How matching works
Whitelist rules use OR: a message can pass when it matches any one whitelist rule. Separate rules such as ≥ 30s and <= 60s do not create a 30–60 second range. A matching blacklist rule takes priority.
Video duration and video size rules apply only to Telegram videos. Document size applies only to files sent as Telegram documents. If the required media metadata is unavailable, the rule does not match.
Albums are handled as a whole: every photo or video in an album must pass the filters for the album to be forwarded. The app does not split an album.

Create a media whitelist
Go to Whitelist and select Add New. Choose Video duration, Video size, or Document size from Filter type, then enter a label and one operator, decimal value, and unit. Check the rule preview, select a Forward or Clone connection if you want to apply it immediately, and choose Create Whitelist. You can also link a saved rule from the whitelist list. The media type stays fixed when editing; create a new filter to use another type. Creating or editing media filters requires an active Platinum or Trial Platinum plan.
5. Apply/Disable Replace For a Task
The Whitelist feature allows you to control which messages are forwarded based on keywords, regex patterns, or specific users. This guide explains how to apply or disable Whitelist rules for individual tasks or globally across all tasks.
Step 1: Access the Whitelist List
From the Dashboard, select the Whitelist feature.
You will see a list of all previously created Whitelist rules.

Step 2: Select a Whitelist Rule
Locate the Whitelist rule you want to manage.
Tap or click on the rule.
A popup window will appear, displaying the details of the selected Whitelist rule.

Step 3: Manage the Whitelist Rule for Tasks
In the popup window, the following options are available:
Activate/Deactivate For Task (Green Button)
Use this option to enable or disable the Whitelist rule for a specific task.
If the rule is already active, clicking this will deactivate it for the selected task.
If the rule is inactive, clicking this will activate it for the selected task.
Apply For All Tasks (Blue Button)
This option allows you to apply the Whitelist rule to all existing tasks.
Use this feature when you want the Whitelist rule to work globally across all tasks.
Edit Whitelist (Orange Button)
Tap this option to edit the Whitelist rule.
You can update the label, content keywords, regex patterns, or user-specific rules.
Delete (Red Button)
Use this option to delete the Whitelist rule permanently.
Be cautious: once deleted, the rule cannot be recovered.
6. Tips for Using Whitelist
Use Basic for simple word-based filtering.
Use Regex for more complex patterns (e.g., URLs, mentions, or exact word matches).
Be precise with Regex to avoid matching unintended content.
Test your Regex patterns on regex101.com before applying them.
Add clear and descriptive Labels for easier rule management.
Why Use Whitelist?
Ensure only relevant content is forwarded.
Filter messages based on specific words, patterns, or trusted users.
Improve control and accuracy of message forwarding.
Last updated