Bulk Import Guide
The bulk import feature allows you to quickly add many codes from a CSV file. This guide explains the format and process.
CSV File Format
Your CSV file should follow this format:
username,ignored,password
Where:
- Column 1: Xtream username (required)
- Column 2: Any value - this column is ignored (can be empty)
- Column 3: Xtream password (required)
💡 Why is the middle column ignored?
This allows compatibility with CSV exports from other systems that may include extra columns. You can put anything there or leave it empty.
Example CSV Content
john_user,"",secretpass123
mary_smith,,password456
user_xyz,"notes here",mypassword
bob_jones,anything,pass789
All of these are valid and will import correctly.
Import Process
Step 1: Prepare Your CSV
- Create a CSV file with your username/password data
- Ensure the format matches:
username,ignored,password
- Save the file with .csv or .txt extension
Step 2: Start the Import
- Go to Code Management
- Click "📥 Bulk Import"
- Select the portal for the imported codes
- Click "Select CSV/TXT File"
- Choose your file
📸 Screenshot: Bulk Import - Upload Step
Shows the portal selector and file upload button
Step 3: Preview
After uploading, you'll see a preview of the entries:
- Total entries found
- First 100 entries displayed
- Any entries with missing passwords highlighted
📸 Screenshot: Bulk Import - Preview Step
Shows the preview table with usernames and masked passwords
Step 4: Import
- Review the preview
- Click "Import X Codes"
- Wait for the process to complete
🔒 Automatic Backup: A backup is automatically created before every import. You can use this to restore if needed.
Step 5: Review Results
After import, you'll see a detailed report:
| Status |
Icon |
Meaning |
| Success |
✅ |
Code created successfully |
| Duplicate |
⚠️ |
Username already exists (skipped) |
| Error |
❌ |
Invalid data (see error message) |
📸 Screenshot: Bulk Import - Results
Shows the summary stats and detailed results table
Download Reports
After import, you can download the results:
- CSV: Spreadsheet format with all details
- TXT: Human-readable text report
Limits and Best Practices
Limits
- Maximum: 1,000 entries per import
- File types: .csv and .txt files
Best Practices
- Test with a small file first (5-10 entries)
- Check the preview carefully before importing
- Download and save the import report
- Remove duplicates from your CSV before uploading
What Gets Auto-Generated
For each successful entry, the system automatically:
- Generates a unique code: 4-6 characters (A-Z no O, 1-9 no 0)
- Sets status to Active: Codes are immediately usable
- Adds import note: "Bulk imported on YYYY-MM-DD HH:MM"
Troubleshooting
"Username is empty" errors
Check that your CSV has the correct format with username in the first column.
"Password is empty" errors
Ensure the password is in the third column. Remember, the second column is ignored.
Many duplicates
The username already exists in your database. This is a safety feature to prevent duplicate codes.