Join Communities — Tutorial

Step-by-step guide to discovering and joining X Communities by keyword using XActions browser scripts.

Works on: Browser Console
Difficulty: Beginner
Time: 2-10 minutes
Requirements: Logged into x.com in your browser

Prerequisites

• Logged into x.com in your browser
• Browser DevTools console (F12 -> Console tab)
• Navigate to https://x.com/i/communities/suggested before running

Quick Start

1. Open x.com and navigate to Suggested Communities (https://x.com/i/communities/suggested)
2. Press F12 to open DevTools, then click the Console tab
3. Copy the script from src/joinCommunities.js
4. Edit CONFIG.keywords with topics you are interested in
5. Paste into the console and press Enter

Configuration

const CONFIG = {
  keywords: [
    'crypto',
    'AI',
    'javascript',
  ],
  maxJoins: 20,              // Maximum communities to join per run
  actionDelay: 3000,         // Delay between join actions (ms)
  scrollDelay: 2000,         // Delay between scrolls (ms)
  maxScrollAttempts: 15,     // Max scrolls to find communities
  dryRun: true,              // Set to false to actually join
};

Step-by-Step Guide

Joining Communities by Keyword

Step 1 -- Navigate to suggested communities

Go to https://x.com/i/communities/suggested in your browser. This page shows communities X recommends for you.

Step 2 -- Configure your keywords

const CONFIG = {
  keywords: ['web3', 'defi', 'ethereum'],
  maxJoins: 10,
  dryRun: true,
};

Step 3 -- Preview with dry run

Paste the script:

JOIN COMMUNITIES - XActions by nichxbt
DRY RUN MODE - Set CONFIG.dryRun = false to actually join
Keywords: web3, defi, ethereum
   Would join: Web3 Builders Community
   Would join: DeFi Traders Hub
   Would join: Ethereum Developers

Done! Joined 3 communities.

Step 4 -- Join for real

Set dryRun: false and paste again. The script will click the "Join" button on each matching community.

Joining All Visible Communities (No Filter)

Leave keywords empty to join every community on the page:

const CONFIG = {
  keywords: [],        // Empty = join all visible
  maxJoins: 15,
  dryRun: false,
};

Discovering More Communities

The script auto-scrolls to load more communities. Increase maxScrollAttempts to discover more:

const CONFIG = {
  keywords: ['tech'],
  maxJoins: 50,
  maxScrollAttempts: 30,   // Scroll more to find more communities
  dryRun: false,
};

Tips & Tricks

• Start with the suggested page. x.com/i/communities/suggested shows the most relevant communities for your account.
• Use broad keywords. Community names may not use the exact terms you expect. For example, search for "AI" to find communities about "artificial intelligence," "machine learning," etc.
• Keep maxJoins reasonable. Joining too many communities at once may trigger rate limits. Start with 10-20 per session.
• Keywords are case-insensitive. 'crypto' matches "Crypto Trading," "CRYPTO NEWS," and "crypto builders."
• Each community is processed once. The script tracks community IDs to avoid processing the same community twice.
• The script navigates if needed. If a join button is not directly visible on the card, the script will navigate to the community page to find it, then navigate back.

Troubleshooting

Related Scripts

• src/createCommunity.js -- Create your own community with name, description, and rules
• src/manageCommunity.js -- Manage members, roles, rules, and posting in existing communities