> For the complete documentation index, see [llms.txt](https://tg-token-gates.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tg-token-gates.gitbook.io/docs/gate-creation/create-a-token-gate.md).

# Create a Token Gate

Once your chats are ready, it’s time to define the rules to get in your chat.

### Prerequisites

Before you begin, make sure:

* You are the **owner** of the chat(s) you want to configure.
* The bot has **admin rights** in all chats
* Groups are converted to supergroups
* There are no members in the gated chat.
* You have SOL to pay for the bot. (one-time lifetime payment)

If these prerequisites are met, you’re ready for `/setup`.

***

### Step 1: DM the bot with `/setup`

1. Start a private chat with [**@tg\_token\_gates\_bot**](https://t.me/tg_token_gates_bot).
2. Send the command **`/setup`** to launch the setup process.
3. Keep this private chat open — this is where you’ll configure everything.
4. Make sure you complete all prerequisite “tasks” shown by the bot, then tap **Tasks completed** to move forward.

<div align="left"><figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2FZ0AtDYcH7lewFzo0mbqu%2Fimage.png?alt=media&amp;token=1f5235ac-ffae-4b30-a2e6-f1414176ed87" alt=""><figcaption></figcaption></figure></div>

***

### Step 2: Select your gated chat

**IF** you are gating a **"Channel & Discussion Group"** select **"Gate a Channel"** during the /setup process&#x20;

* Select **"Gate a Channel"** or **"Gate a Group"**

  <div align="left"><figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2FbwqOwFBdb0sBLNMfBKel%2Fimage.png?alt=media&amp;token=33cbcf57-482a-49ed-beab-b924be0301cd" alt=""><figcaption></figcaption></figure></div>
* Click **"Select Channel"** or **"Select Group"** then select the chat you want to **gate**.

<div align="left"><figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2FjdapKPD0sybl1WxElqBk%2Fimage.png?alt=media&amp;token=8a784a37-f3ce-4af3-a9cb-58724ae71f41" alt=""><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2FqbeUVAk9hYoGp402Kchg%2Fimage.png?alt=media&amp;token=a395c44c-2d8e-4db4-be81-56a2306fe3dc" alt=""><figcaption></figcaption></figure></div>

If you’re gating a **channel** that has a **discussion group**, the bot will detect this and show a notification that the discussion group has been recognized. Both will be treated as part of the gate.

<div align="left"><figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2FGB49kcLqi6Draro831H7%2Fimage.png?alt=media&amp;token=4f5c8980-8f58-468f-9a4f-80cf3862549a" alt=""><figcaption></figcaption></figure></div>

### Step 3: Select your "Entry Channel"

Next, choose the **Entry Channel**:

* It must be a **Telegram channel**, not a group.
* It must be **different** from your gated chat.
* You must be the **owner**, and the bot must be an **admin**.

<div align="left"><figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2FLEh6k0jfI88AJaP6KAD1%2Fimage.png?alt=media&amp;token=f73212e2-2b74-4108-89f0-685cd26120eb" alt=""><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2FCnHFZ4rDAaNKK8aI24Pq%2Fimage.png?alt=media&amp;token=c270243f-4263-47c5-a03c-bedb13bb4453" alt=""><figcaption></figcaption></figure></div>

### Step 3.5: Purchase Access

This is a one-time cost paid in $SOL. This will grant your **"Channel"** or **"Group"** full access to our features.\
\
IF your gating a **"Channel & Discussion Group"** the **"Channel"** is in control of the gate rules.

* Click **"Unlock Access Now"**

<div align="left"><figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2FZw2x5k1wYIX5eJpuHrV9%2Fimage.png?alt=media&amp;token=b604eabc-4fb8-4e6f-a441-80eb2d185f22" alt=""><figcaption></figcaption></figure></div>

* Send the required $SOL to the wallet address provided

<div align="left"><figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2FLEjMkv5Sm7LFJxiGkfN9%2Fimage.png?alt=media&amp;token=ae7fc743-70b6-4c75-9f4e-054346e436ee" alt=""><figcaption></figcaption></figure></div>

* You know have access. Continue to Step #4.

<div align="left"><figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2FjMj8ynZ6MdeERMfVPLsd%2Fimage.png?alt=media&amp;token=2e53f99d-99d3-4964-96bb-f6e0f5b0c439" alt=""><figcaption></figcaption></figure></div>

***

### Step 4: Confirm all chats

The bot will show a summary of your selected chats

* 🔒 **Protected Chat:** `<chat name>`
* 🔒 **Discussion Group:** `<discussion group>` (if you have one)
* 📢 **Entry Channel:** `<channel name>`

Carefully review this screen:

* If you’re gating a **channel** with a **discussion group**, make sure both appear here.
* Tap **Confirm** to continue, or go back if anything looks wrong.

<div align="left"><figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2FirrhtoGwE6YUMFqR06FU%2Fimage.png?alt=media&amp;token=b0353f45-7a75-49c4-a50e-09eb1fd3bd6e" alt=""><figcaption></figcaption></figure></div>

***

### Step 5: Choose gate type

Now define **how users qualify** to join.

* **Gate Types:**
  * 🔷 **Token Gate** – Users must hold a specific token to join.
  * 🪙 **Net Worth Gate** – Users must meet a minimum USD portfolio value.

For this example we will select "Token Gate"

<div align="left"><figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2FoeoE3OKtAv3g52BzXvyK%2Fimage.png?alt=media&amp;token=8d0f1002-822b-4efc-845c-8a6a2a05a8ae" alt=""><figcaption></figcaption></figure></div>

### **Step 6: Select Blockchain**

Select the blockchain associated with the token you want to use for this gate.

**NOTE**: The Multichain option is a special scenario for tokens that exist across multiple chains. To learn more [click here](/docs/multichain-metrics.md).

<div align="left"><figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2FeeWB7sXvmUpHaG8qZQdX%2Fimage.png?alt=media&amp;token=820e8fae-84f5-49dc-ba86-ca11cd85484a" alt=""><figcaption></figcaption></figure></div>

### **Step 7: Select Token Type**

* *Native Token (e.g., SOL, ETH, BNB) (Go to* [*Step: #8*](#step-8-define-threshold)*)*
* *Custom Token (Go to* [*Step: #7A*](#step-7a-custom-token)*)*
* If you selected multichain this step is skipped. (Go to [Step: #7B](#step-7b-multichain-token))

<div align="left"><figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2FmgQBJv3OBSSInnKq54mY%2Fimage.png?alt=media&amp;token=71ddcc86-6153-4ca3-b0c6-ebb1ef52d5e5" alt=""><figcaption></figcaption></figure></div>

### **Step 7A: Custom Token**

In this step you define the contract address of your custom token. The bot will find the $TICKER.

<div align="left"><figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2FGWdENoiZuFpjAJ6E1w3K%2Fimage.png?alt=media&amp;token=3f471fab-f7c6-44bb-9f26-e14bd54a6a66" alt=""><figcaption></figcaption></figure></div>

Verify it's correct then continue to Step #8

<div align="left"><figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2FL5KASzlmP8JIf8nGV2x1%2Fimage.png?alt=media&amp;token=dd39d9be-64ca-42cb-a1b8-f322658d81e4" alt=""><figcaption></figcaption></figure></div>

### **Step 7B: Multichain Token**

In this step you submit either the multichain metrics link or the parent contract address for your custom token.&#x20;

<div align="left"><figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2FVsv5OtnLaZfoptyJ9QdC%2Fimage.png?alt=media&amp;token=46ef1002-fc6a-4edf-adf3-d419c4351e85" alt=""><figcaption></figcaption></figure></div>

Verify the details are correct then click **"Continue"**

<div align="left"><figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2FKAb4xuzMcORaByPL9U9V%2Fimage.png?alt=media&amp;token=924d08c9-a290-4fe8-9ebb-945230887a26" alt=""><figcaption></figcaption></figure></div>

### **Step 8: Define Threshold**

Define how many (custom or native) tokens a user must hold to gain access.

<div align="left"><figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2F2QjrNI7ufj3vn2okwASI%2Fimage.png?alt=media&amp;token=03accac2-42ef-467e-9fff-bb895e3c4f1f" alt=""><figcaption></figcaption></figure></div>

***

### **Step 9: Create Your Entry Message!**

<div align="left"><figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2FspuvKkYSLxkpGPF5tbyl%2Fimage.png?alt=media&amp;token=be48a384-619e-41d2-aa32-8c05dd0d40cc" alt=""><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2Fp0uHOb9kVCrfbrWYPY0B%2Fimage.png?alt=media&amp;token=2a6c1dff-cf96-41c8-b57f-cbbd068e20c9" alt=""><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2FrNWUe19WjeQGwJ8KDX0H%2Fimage.png?alt=media&amp;token=74b36bd4-ddfc-41dc-a11d-a833d6210d3c" alt=""><figcaption></figcaption></figure></div>

***

### **Step 10: Create Your Gate!**

* Once everything is entered, the bot will show a **confirmation screen**.
* Tap **Create Gate**.
* 🎉 Your gate is now active!
* New users must pass through the entry portal to join your protected chat.

<div align="left"><figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2FBAZGqbwbtVEhQnKGg9Uk%2Fimage.png?alt=media&amp;token=3906c3e1-284b-4cc7-80ca-d0e7cb7626ad" alt=""><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://4091296668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgpdBpq3fWRRplh4OcmGe%2Fuploads%2FftN5UiWyC4vM6lMi5gwr%2Fimage.png?alt=media&amp;token=4d855ffd-c62a-4069-93a4-9c79ffcaf2f6" alt=""><figcaption></figcaption></figure></div>

&#x20;*If you run into issues, feel free to reach out for help.*
