BuddyPress Member Export Import – Complete User Guide

BuddyPress Member Export Import is a powerful plugin that allows you to manage your BuddyPress community members efficiently. Whether you’re migrating sites, backing up user data, or performing bulk updates, this plugin provides all the tools you need.

• Export Members: Export all or selected members with their profile data
• Import Members: Bulk import new members or update existing ones
• Profile Fields: Full support for all xProfile field types
• Group Memberships: Export and manage group membership relationships
• Large Site Support: Optimized for sites with 50,000+ members
• Flexible Formats: Multiple export formats for different use cases

• WordPress 5.0 or higher
• BuddyPress 5.0 or higher
• PHP 7.2 or higher
• MySQL 5.6 or higher
• Minimum 256MB PHP memory limit (512MB recommended for large exports)

1. Upload Plugin

   • Navigate to Plugins > Add New in WordPress admin
   • Click “Upload Plugin” and select the plugin zip file
   • Or upload the unzipped folder to /wp-content/plugins/

2. Activate Plugin

   • Go to Plugins > Installed Plugins
   • Find “BuddyPress Member Export Import”
   • Click “Activate”

3. Access Plugin

   • Find the plugin under Users > Member Export Import
   • Or in the main menu under “WBcom Designs”

1. Check BuddyPress Components

   • Ensure BuddyPress is active
   • Verify Extended Profiles component is enabled
   • Enable Groups component if using group features

2. Configure PHP Settings (if needed)

   max_execution_time = 300
   memory_limit = 256M
   upload_max_filesize = 50M
   post_max_size = 50M
   

3. Set Permissions

   • Ensure WordPress upload directory is writable
   • Check user has ‘manage_options’ capability

1. Go to Users > Member Export Import
2. Click on the “Export Members” tab

You have three options for selecting members to export:

Option A: All Members

• Check “All BuddyPress Members”
• This exports every member in your database

Option B: Filter by Role

• Use WordPress user roles to filter
• Select one or multiple roles
• Only members with those roles will be exported

Profile Field Groups:

1. Click “Select Field Groups” dropdown
2. Available groups will appear:
   • Base (Primary)
   • Custom field groups you’ve created
3. Select the groups containing fields you want to export

Individual Fields:

1. Click “Select Profile Fields” dropdown
2. You’ll see all available fields organized by group
3. Check the fields you want to include:
   • Name (First Name, Last Name)
   • Bio/Description
   • Date fields
   • Checkboxes/Radio buttons
   • Any custom fields

Pro Tips:

• Hover over field names to see field types
• Required fields are marked with an asterisk
• Some fields may contain sensitive data – export carefully

Include WordPress Data:

• ✓ Include user email
• ✓ Include display name
• ✓ Include user role
• ✓ Include registration date
• ✓ Include last activity

Advanced Options:

• ✓ Include empty fields (keeps consistent columns)
• ✓ Include field IDs (useful for re-import)
• ✓ Include user meta data
• ✓ Export in UTF-8 with BOM (for Excel compatibility)

1. Click the blue “Export Members Data” button
2. A progress bar will appear for large exports
3. The file will automatically download when complete
4. Default filename: bp-members-export-YYYY-MM-DD.csv

Standard CSV Format:

user_id,user_login,user_email,first_name,last_name,bio,interests
1,johndoe,john@example.com,John,Doe,"Love hiking",Sports|Music|Travel

• UTF-8 with BOM encoding
• Properly escaped special characters
• Compatible with Excel 2016+

Your CSV file must include these required columns:

• user_login – Username (unique, no spaces)
• user_email – Email address (unique, valid format)

Optional but recommended columns:

• user_pass – Password (plain text or encrypted)
• first_name – First name
• last_name – Last name
• display_name – Display name
• role – WordPress user role

user_login,user_email,user_pass,first_name,last_name,role,city,interests
janedoe,jane@example.com,SecurePass123,Jane,Doe,subscriber,New York,Reading|Travel
bobsmith,bob@example.com,MyPassword456,Bob,Smith,subscriber,Los Angeles,Sports|Music

1. Go to Users > Member Export Import
2. Click on the “Import Members” tab

Import Limit:

• Default: 50 users per batch
• For large imports: Use 25-30 per batch
• For small imports: Can use up to 100

Password Options:

• ✓ Encrypt passwords during import (Checked by default)
  • Use when passwords are plain text
  • Uncheck if passwords are already encrypted

Update Options:

• Choose how to handle existing users:
  • Skip existing users (default)
  • Update existing user data
  • Update only empty fields

1. Click “Choose File” button
2. Select your prepared CSV file
3. Maximum file size shown (usually 50MB)
4. File preview will appear showing:
   • File name
   • File size
   • Estimated row count

After uploading, you’ll see the field mapping interface:

1. Automatic Mapping:

   • Common fields are mapped automatically
   • Review all mappings for accuracy

2. Manual Mapping:

   • Left column: Your CSV headers
   • Right column: BuddyPress fields
   • Use dropdowns to match fields correctly

3. Field Types:

   • Text fields: Direct mapping
   • Checkboxes: Use pipe (|) separated values
   • Date fields: Use YYYY-MM-DD format
   • Select boxes: Must match existing options

1. Review your mappings carefully
2. Click “Import Members Data” button
3. Progress indicator shows:
   • Current batch being processed
   • Number of users imported
   • Any errors encountered
4. Wait for completion message

Success Messages:

• “50 users imported successfully”
• Green checkmark indicates completion

Error Messages:

• “User ‘johndoe’ already exists” – Skip or update
• “Invalid email format” – Fix in CSV
• “Required field missing” – Add to CSV

Import Log:

• Check import log for detailed results
• Download error report if available
• Fix issues and re-import failed rows

Group membership exports create a relationship map between users and groups, perfect for:

• Backing up group structures
• Migrating group memberships
• Analyzing community engagement
• Bulk group management

1. Navigate to Users > Member Export Import
2. Click “Export Groups” tab

The dashboard shows:

• Total Groups: All groups in your site
• Active Groups: Groups with at least one member
• Total Memberships: All user-group relationships

All Groups:

• Check “All Groups” to export every group
• Shows total count in parentheses

Specific Groups:

• Uncheck “All Groups”
• Select individual groups
• Member count shown for each group
• Multi-select supported

Normalized Format (Recommended):

user_id,user_login,group_id,group_name,group_slug,member_role,date_joined
34,johndoe,12,Photography Club,photography-club,member,2024-01-15 10:30:00
34,johndoe,15,Book Readers,book-readers,admin,2024-02-20 14:45:00

• One row per membership
• Best for database imports
• Includes all relationship data

Grouped by User:

user_id,user_login,group_names,group_slugs,group_count
34,johndoe,"Photography Club,Book Readers","photography-club,book-readers",2

• One row per user
• Comma-separated group lists
• Easier to read in Excel

Additional Data:

• ✓ Include user details (email, display name)
• ✓ Include group details (status, description)
• ✓ Include inactive members (pending/banned)

1. Click “Export Group Memberships”
2. Large exports show progress bar
3. File downloads automatically
4. Filename: bp-groups-export-YYYY-MM-DD.csv

For sites with large member bases:

1. Export in Segments:

   • Use role filtering to export in chunks
   • Export by registration date ranges
   • Process alphabetically by username

2. Import in Batches:

   • Split large CSV files into 1000-row chunks
   • Use import limit of 25-50 per batch
   • Monitor server resources

Handle special characters properly:

• Commas: Enclose in quotes "Smith, John"
• Quotes: Escape with backslash \"quoted\"
• Newlines: Use \n in quoted strings
• Unicode: Save as UTF-8

While the plugin doesn’t have built-in scheduling, you can:

1. Use WP-CLI for Automation:

   wp bpxp export --type=members --output=daily-backup.csv

2. Cron Job Setup:

   0 2 * * * /usr/bin/wp bpxp export --type=members

3. Third-Party Schedulers:

   • WP Crontrol plugin
   • Server-level cron jobs
   • Automation plugins

1. Backup Your Database

   • Always backup before major exports
   • Use WordPress backup plugins
   • Test restore process

2. Clean Your Data

   • Remove spam accounts
   • Update outdated information
   • Standardize field formats

3. Plan Export Strategy

   • Identify required fields
   • Document field mappings
   • Test with small sample

1. Start Small

   • Test with 5-10 users first
   • Verify field mappings
   • Check imported data

2. Monitor Performance

   • Watch server resources
   • Check error logs
   • Adjust batch sizes

3. Validate Data

   • Verify user creation
   • Check profile fields
   • Test user login

1. Verify Results

   • Count imported/exported users
   • Spot-check random profiles
   • Test functionality

2. Clean Up

   • Remove temporary files
   • Clear plugin cache
   • Optimize database

3. Document Process

   • Note field mappings
   • Record any issues
   • Save for future reference

Problem: Export stops before completion

Solutions:

1. Reduce number of selected users
2. Export fewer fields
3. Increase PHP timeout:

   set_time_limit(300);
   max_execution_time = 300

4. Use WP-CLI for large exports

Problem: PHP runs out of memory

Solutions:

1. Increase memory limit:

   memory_limit = 512M
2. Export in smaller batches
3. Disable other plugins temporarily
4. Contact hosting provider

Problem: Downloaded file has no data

Solutions:

1. Check user permissions
2. Verify BuddyPress is active
3. Ensure users exist in database
4. Check PHP error logs

Problem: Import completes but no users created

Solutions:

1. Verify CSV format is correct
2. Check required fields (user_login, user_email)
3. Ensure usernames/emails are unique
4. Review import log for errors

Problem: Fields don’t map correctly

Solutions:

1. Check CSV header names
2. Remove special characters from headers
3. Ensure no extra spaces in headers
4. Match field types correctly

Problem: Imported users can’t login

Solutions:

1. Check password encryption setting
2. Ensure passwords meet requirements
3. Use password reset for affected users
4. Test with known good password

Problem: Accents, symbols appear wrong

Solutions:

1. Save CSV as UTF-8
2. Use UTF-8 with BOM for Excel
3. Check database character set
4. Avoid smart quotes from Word

Problem: File upload fails

Solutions:

1. Reduce file size
2. Update server settings:

   client_max_body_size 50M;  # Nginx
   LimitRequestBody 52428800  # Apache
   
3. Split into multiple files

Problem: Server times out

Solutions:

1. Increase timeout values
2. Use smaller batch sizes
3. Optimize server performance
4. Consider using WP-CLI

• Developer Guide: DEVELOPER-GUIDE
• Hooks Reference: HOOKS-REFERENCE
• WBcom Docs: https://docs.wbcomdesigns.com

1. Plugin Support Forum

   • WordPress.org support forum
   • Community-driven help
   • Search existing topics first

2. Premium Support

   • Email: support@wbcomdesigns.com
   • Support portal: https://wbcomdesigns.com/support
   • Response within 24-48 hours

3. Bug Reports

   • GitHub issues (if available)
   • Include error messages
   • Provide steps to reproduce

When requesting support, include:

1. WordPress version
2. BuddyPress version
3. Plugin version
4. PHP version
5. Error messages (exact)
6. Steps to reproduce issue
7. Export/import settings used

• BuddyPress
• BP xProfile Fields Manager
• BuddyPress Bulk Delete
• User Role Editor

• CSV editors (LibreOffice Calc, Google Sheets)
• Text editors (Notepad++, VS Code)
• Database tools (phpMyAdmin, Adminer)
• File splitters for large CSVs

• BuddyPress Codex
• WordPress Developer Handbook
• CSV format specification
• UTF-8 encoding guide

BuddyPress Member Export Import is a powerful tool for managing your community. With proper understanding and careful use, you can:

• Safely backup member data
• Migrate between sites
• Perform bulk updates
• Analyze your community

Remember to always:

• Test with small samples
• Backup before major operations
• Follow best practices
• Seek help when needed

Thank you for using BuddyPress Member Export Import!