[Telegram 141] Shared Chat Folders & Invite Links: One-Click Community Hub Bundling & Member Onboarding
Managing dozens of specialized project rooms, broadcast channels, developer roundtables, or regional communities inside Telegram frequently degrades into chaotic chat list clutter. With the introduction of Shared Chat Folders (t.me/addlist/{slug}), Telegram fundamentally revolutionized group onboarding and content curation. Instead of forcing colleagues or community members to manually search, click, and join ten or twenty distinct invite links, an administrator can bundle up to 100 public and private channels into a single synchronized folder. When users click your custom link, they can preview every room and join them all simultaneously with a single tap. Furthermore, any new channels added by the curator dynamically trigger non-intrusive prompt banners, allowing existing members to keep their folder synchronized. This masterclass examines the underlying protocol, quota economics, administrator permission requirements, and dynamic membership lifecycle of Shared Chat Folders.
Core Architectural Mechanics of Shared Folders
- Atomic Multi-Chat Subscriptions: Invitees can inspect the full roster of chats inside the folder modal, deselect any unwanted groups, and subscribe to all selected rooms with a single network round-trip.
- Dynamic Channel Propagation: When an admin adds a new channel to a shared folder, existing subscribers automatically receive an in-app prompt banner: “New chats added to this folder. Tap to join.”
- Administrative Rights Prerequisites: To include a private group or channel in a shareable link, the folder creator must hold administrator rights with the “Invite Users via Link” permission enabled.
- Tier Limits: Free accounts can create up to 2 shared folders with 3 invite links each (up to 100 chats per folder). Premium subscribers can create up to 30 folders, generate up to 100 invite links per folder, and bundle up to 200 chats.
1. Technical Anatomy of the t.me/addlist Handshake
Traditional Telegram invite links (t.me/+AbCdEf... or t.me/joinchat/...) resolve to an individual group or channel peer ID. In contrast, Shared Folder links employ the t.me/addlist/{slug} URI scheme.
When an end-user navigates to an addlist link, the Telegram client executes a coordinated 4-step cryptographic and peer-resolution handshake:
chatlists.checkChatlistInvite
The client sends an MTProto RPC call query to resolve the slug. The server returns the folder title, curated emoji icon, and the serialized array of public usernames and private peer access hashes.
Membership State Validation
The local client cross-references the returned chat list against the user's existing dialog cache. Chats the user is already a member of are pre-checked and marked as “Already Joined,” preventing redundant API requests.
chatlists.joinChatlistInvite
When the user taps “Add [Folder Name]”, a single vector containing all approved peer IDs is transmitted. The Telegram server cluster processes the subscriptions atomically, avoiding aggressive spam rate-limits.
2. Free Tier vs. Telegram Premium Quota Economics
Telegram allocates substantial resources for shared chat folders, but enforces distinct tier boundaries to mitigate spam bot distribution networks:
| Operational Feature | Standard Free Account | Telegram Premium Account | Impact on Curators |
|---|---|---|---|
| Max Shared Folders Created | Up to 2 Folders | Up to 30 Folders | Critical for agencies managing multiple client ecosystems |
| Max Chats Included per Folder | 100 Chats | 200 Chats | Doubles directory capacity for extensive hub aggregators |
| Custom Invite Links per Folder | 3 Active Links | Up to 100 Links | Enables granular A/B testing and marketing attribution slugs |
| Maximum Joined Shared Folders | Up to 10 Folders | Up to 30 Folders | Allows power users to organize hundreds of topics |
| Admin Inclusion Rights Required | Yes (for private chats) | Yes (for private chats) | Prevents unauthorized harvesting of private room invite hashes |
3. Creating and Distributing a Shared Chat Folder in 4 Steps
Follow this operational sequence inside the official mobile or desktop Telegram application:
Establish or Select a Curated Chat Folder
Navigate to Settings → Chat Folders → Create New Folder. Assign a distinct name and choose an intuitive emoji icon. Under Included Chats, explicitly select the channels, groups, and bots you wish to feature. Note: Dynamic filters like “All Unread” or “Non-Contacts” cannot be converted into shared links; only explicitly selected peer lists can be shared.
Generate the Unique Share Link
Tap on the folder you just configured and select Share Folder (or right-click the folder tab on Telegram Desktop and choose Share). Telegram verifies your administrator privileges for each included private room. Tap Create an Invite Link. You can name the link (e.g., “Engineering Team Onboarding”) to track invitation analytics separately.
Distribute via Custom Slug or QR Code
Telegram generates an optimized URL formatted as https://t.me/addlist/XXXXX along with an exportable vector QR code. When published on websites, employee handbooks, or social profiles, clicking it renders the native modal in the recipient's Telegram client.
Manage Dynamic Synchronization Updates
If you subsequently add 3 new channels to your folder, edit the share link. Telegram displays a confirmation: “X users will be notified about new chats.” When you tap Update Link, existing subscribers will see an interactive prompt banner in their chat folder tab enabling them to join the newly added channels in one tap.
Interactive Lab: Shared Folder Architect & Batch Onboarding Simulator
🚀 Web3 & AI Developers Hub
You are adding this chat folder with 4 chats.
[00:00:00.005] Verified admin rights for 1 private group and 3 public channels.
[00:00:00.010] Ready to simulate batch join or modify folder parameters.
5. Shared Chat Folders Technical Architecture Blueprint
The architectural blueprint below illustrates the end-to-end data pipeline of Telegram Shared Folders: filter categorization, slug creation, the batch joining RPC handshake, dynamic member update notifications, and tier quota constraints:
6. Frequently Asked Questions (FAQ)
If a member deletes the shared folder, are they automatically removed from the chats?
When deleting a shared folder, Telegram displays a dialog asking: “Do you also want to leave the chats included in this folder?” Users can check or uncheck individual groups. If they uncheck them, the folder tab disappears from their UI, but they remain active members inside the individual channels in their main chat list.
Can I include individual 1-on-1 private user chats in a shared folder link?
No. Telegram strictly prohibits including direct private user-to-user dialogues in shareable addlist links to protect individual user privacy and prevent uninvited contact harvesting. Shared folder links support only public channels, private channels, public groups, private supergroups, and official verified bots.
What happens if the curator loses administrator rights in one of the private channels?
If the curator's administrative status is revoked in a private group, Telegram automatically disables the invite link for that specific chat within the folder bundle. Subsequent invitees clicking the link will still receive all other valid channels, but the compromised private group will be quietly omitted from the batch join vector.
![[Telegram 163] Anonymous Admin Mode: Identity Masking & Channel Signatures in Public Communities](https://tgway.com/images/guides/guide_18436.webp)
![[Telegram 162] Restrict Saving Content: DRM Protections, Forwarding Shields & Screenshot Barriers](https://tgway.com/images/guides/guide_18435.webp)
![[Telegram 161] Aggressive Anti-Spam Mode: Machine Learning Heuristics & False-Positive Triage](https://tgway.com/images/guides/guide_18434.webp)