Create Lists — Tutorial

Step-by-step guide to creating X Lists, adding members, and exporting list data 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 any x.com page (for creating lists) or a specific list page (for adding members/exporting)

Quick Start

1. Open x.com (any page for list creation, or a list page for member management)
2. Press F12 to open DevTools, then click the Console tab
3. Copy the script from src/listManager.js
4. Edit the CONFIG section to enable the operations you want
5. Paste into the console and press Enter

Configuration

const CONFIG = {
  // Create a new list
  createList: {
    enabled: false,
    name: 'My List',
    description: 'Created by XActions',
    isPrivate: true,
  },
  // Add users to an existing list (navigate to list page first)
  addUsers: {
    enabled: true,
    usernames: [
      'user1',
      'user2',
    ],
  },
  // Export list members
  exportMembers: {
    enabled: false,
    maxMembers: 200,
  },
  actionDelay: 2000,
  scrollDelay: 1500,
};

Step-by-Step Guide

Creating a New List

Step 1 -- Navigate to your Lists page

Go to https://x.com/i/lists or click "Lists" in the sidebar.

Step 2 -- Configure

const CONFIG = {
  createList: {
    enabled: true,
    name: 'AI Thought Leaders',
    description: 'Top voices in artificial intelligence and machine learning',
    isPrivate: false,
  },
  addUsers: { enabled: false, usernames: [] },
  exportMembers: { enabled: false, maxMembers: 200 },
  actionDelay: 2000,
  scrollDelay: 1500,
};

Step 3 -- Run the script

The script will:

1. Click the "Create List" button
2. Fill in the name and description
3. Toggle the privacy setting if needed
4. Click "Save" to create the list

Adding Members to a List

Step 1 -- Navigate to the list page

Go to the specific list you want to add members to (e.g., https://x.com/i/lists/1234567890).

Step 2 -- Configure

const CONFIG = {
  createList: { enabled: false, name: '', description: '', isPrivate: true },
  addUsers: {
    enabled: true,
    usernames: [
      'nichxbt',
      'elonmusk',
      'sama',
      'kaborealp',
    ],
  },
  exportMembers: { enabled: false, maxMembers: 200 },
  actionDelay: 2000,
  scrollDelay: 1500,
};

Step 3 -- Run the script

The script will:

1. Click "Add Members"
2. For each username: search, find the matching user cell, and click to add them
3. Clear the search between each user

Output:

Adding 4 users to list...
Added @nichxbt
Added @elonmusk
Added @sama
Added @kaborealp

Exporting List Members

Step 1 -- Navigate to the list's members page

Go to a list page that has members visible.

Step 2 -- Configure

const CONFIG = {
  createList: { enabled: false, name: '', description: '', isPrivate: true },
  addUsers: { enabled: false, usernames: [] },
  exportMembers: {
    enabled: true,
    maxMembers: 500,
  },
  actionDelay: 2000,
  scrollDelay: 1500,
};

Step 3 -- Run the script

The script will scroll through the members, collect usernames, display names, and bios, then auto-download a JSON file.

Combining Operations

You can enable multiple operations in a single run:

const CONFIG = {
  createList: {
    enabled: true,
    name: 'Crypto Alpha',
    description: 'Best crypto accounts for alpha',
    isPrivate: true,
  },
  addUsers: {
    enabled: true,
    usernames: ['trader1', 'analyst2', 'researcher3'],
  },
  exportMembers: { enabled: false, maxMembers: 200 },
  actionDelay: 2500,
  scrollDelay: 1500,
};

This creates the list first, then adds members to it.

Tips & Tricks

• Private lists are invisible to others. Use private lists for research and competitive analysis.
• Operations run in order. Create -> Add Members -> Export. Enable only the ones you need.
• Increase delays for large batches. When adding many users, increase actionDelay to 3000-4000ms to avoid rate limits.
• Export downloads automatically. The export creates a JSON file named xactions-list-members-YYYY-MM-DD.json and triggers a download.
• Users are not notified when added to private lists. Public list additions may send notifications.

Troubleshooting

Related Scripts

• src/followList.js -- Follow, unfollow, pin, and browse lists
• src/manageCommunity.js -- Similar management features for Communities