Dropbox provides one of the most reliable cloud storage solutions for WordPress backup automation. Unlike simple file sync services, integrating Dropbox with Backup Copilot Pro requires OAuth 2.0 authentication, which gives you secure, automated access to upload backups directly from your WordPress site to your Dropbox account without manual intervention.
This advanced guide walks you through the complete Dropbox setup process, from creating your Dropbox app in the developer console to configuring automatic backup uploads. You’ll learn how to obtain OAuth credentials, authorize the connection, and optimize upload settings for your specific hosting environment.
By the end of this tutorial, your WordPress backups will automatically sync to Dropbox the moment they’re created, providing bulletproof offsite protection with zero ongoing effort. Whether you’re managing a single site or multiple client projects, this cloud integration ensures your backups are always safe, accessible, and ready for restoration.
What You’ll Learn
- Creating a Dropbox app for OAuth authentication
- Configuring OAuth 2.0 credentials
- Connecting Backup Copilot Pro to Dropbox
- Setting up automatic cloud uploads
- Managing upload settings and bandwidth
- Troubleshooting connection issues
- Monitoring Dropbox storage usage
Prerequisites
What You’ll Need
Dropbox Account:
- Free or paid Dropbox account (Plus, Professional, or Business)
- Verified email address
- Access to Dropbox App Console
WordPress Requirements:
- Backup Copilot Pro (active license)
- WordPress 5.8 or higher
- PHP 7.4 or higher with cURL extension enabled
- SSL certificate installed (HTTPS required for OAuth)
Server Requirements:
- Outbound HTTPS connections allowed (port 443)
- PHP
allow_url_fopenenabled or cURL installed - Sufficient PHP
max_execution_timefor uploads (300+ seconds recommended)
Time Required:
- Initial setup: 15-20 minutes
- Configuration and testing: 10 minutes
- Total: ~30 minutes
Dropbox Account Types
Dropbox Basic (Free):
- 2 GB storage
- Good for: Personal blogs, small sites
- Limitations: Very limited space, fills quickly
Dropbox Plus ($11.99/month):
- 2 TB (2,000 GB) storage
- Good for: Business sites, multiple backups
- Features: 180-day file recovery, offline access
Dropbox Professional ($19.99/month):
- 3 TB storage
- Good for: Agencies, e-commerce sites
- Features: Advanced sharing, transfer limits up to 100 GB
Dropbox Business (Team plans):
- 5+ TB storage
- Good for: Agencies managing client backups
- Features: Team management, advanced admin controls
Recommendation: For most WordPress sites with daily backups, Dropbox Plus (2 TB) provides ample storage for years of backup history.
Storage Considerations
Calculate Your Storage Needs:
Example site: 500 MB backup size
- Daily backups, 30-day retention: 500 MB × 30 = 15 GB
- Weekly backups, 12-week retention: 500 MB × 12 = 6 GB
- Total: ~21 GB needed
Example e-commerce site: 2 GB backup size
- Daily backups, 30-day retention: 2 GB × 30 = 60 GB
- Hourly database snapshots: 50 MB × 48 = 2.4 GB
- Total: ~62 GB needed
Storage Planning Tips:
- Add 20% buffer for growth
- Monitor usage monthly
- Use retention policies to auto-delete old backups
- Consider database-only backups for high-frequency schedules
Creating Your Dropbox App
Step 1: Access Dropbox App Console
- Visit https://www.dropbox.com/developers/apps
- Log in with your Dropbox credentials
- Click Create app button in top right
- You’ll see the app creation wizard
Screenshot: Dropbox App Console homepage
Step 2: Create New App
Choose API:
- Select Scoped access (recommended)
- This uses Dropbox API v2 with granular permissions
- More secure than legacy API options
Choose Access Type:
- Select Full Dropbox access
- This allows app to access entire Dropbox folder structure
- Required for creating backup folders automatically
Name Your App:
- Enter descriptive name:
WordPress-Backups-[YourSite] - Example:
WordPress-Backups-MyBlog - Name must be unique across all Dropbox apps
- Use letters, numbers, hyphens only
Accept Terms:
- Check “I agree to Dropbox API Terms and Conditions”
- Click Create app
Screenshot: Create App form
Step 3: Configure App Settings
After creation, you’ll land on the app settings page. Configure these settings:
App Status:
- Development: Limited to your account only
- Production: Available to other users (not needed for personal use)
- Keep as Development unless you’re building for clients
Permission Type:
- Confirm: Individual scopes
- Review and adjust permissions if needed
Required Permissions (Scopes): Navigate to Permissions tab and enable:
files.metadata.write– Create folders and manage filesfiles.metadata.read– Read file informationfiles.content.write– Upload backup filesfiles.content.read– Download backups if needed
Click Submit after selecting scopes.
Screenshot: App settings page
Step 4: Get App Key and Secret
On the Settings tab:
App Key (Client ID):
- Long alphanumeric string
- Copy this to notepad
- You’ll enter this in Backup Copilot Pro
App Secret (Client Secret):
- Click Show to reveal
- Copy this secret value
- Keep confidential – treat like a password
- Never share publicly or commit to version control
Screenshot: Credentials section
Security Note: Store these credentials securely. Anyone with your App Key and Secret can access your Dropbox through this app. If compromised, regenerate the secret immediately in the Dropbox App Console.
Step 5: Set OAuth Redirect URI
The redirect URI tells Dropbox where to send users after authorization.
Find Your Redirect URI:
- In WordPress, go to Backup Copilot > Cloud Storage > Dropbox
- Look for “OAuth Redirect URI” display
- Copy the full URL (e.g.,
https://yoursite.com/wp-admin/admin.php?page=backup-copilot&tab=cloud&provider=dropbox&oauth=callback)
Add to Dropbox App:
- Return to Dropbox App Console
- Scroll to OAuth 2 section
- Find Redirect URIs field
- Paste your WordPress redirect URI
- Click Add
- Ensure URI shows in list below
Screenshot: OAuth settings
Important: URI must match EXACTLY, including https:// and all query parameters. Mismatch will cause “redirect_uri_mismatch” error.
Connecting Backup Copilot Pro to Dropbox
Step 1: Enter Credentials in Settings
- In WordPress admin, navigate to Backup Copilot > Cloud Storage
- Click Dropbox tab
- Enter your credentials:
- App Key: Paste from Dropbox App Console
- App Secret: Paste from Dropbox App Console
- Click Save Credentials
Screenshot: Backup Copilot Pro Dropbox settings
Step 2: Authorize Connection
- After saving credentials, click Connect to Dropbox button
- You’ll be redirected to Dropbox authorization page
- Dropbox shows which permissions app is requesting
- Review permissions (should match scopes you configured)
- Click Allow to authorize
Screenshot: Dropbox authorization screen
What Happens:
- Dropbox generates an access token for your site
- Token stored securely in WordPress database
- App can now upload/download files automatically
- No manual login required for future backups
Step 3: Verify Connection
After authorization:
- You’re redirected back to WordPress
- Success message appears: “Dropbox connected successfully”
- Connection status shows green checkmark
- Dropbox account email displayed
- Storage quota shown (e.g., “1.2 GB used of 2 TB”)
Screenshot: Successful connection message
Test Connection: Click Test Connection button to verify:
- Creates temporary test file in Dropbox
- Uploads file to
/Apps/[YourAppName]/test/ - Downloads file back to verify read access
- Deletes test file
- Confirms: “Connection test successful”
If test fails, check troubleshooting section below.
Configuring Upload Settings
Automatic Upload After Backup
Enable Auto-Upload:
- Toggle Automatic Cloud Sync to ON
- Every backup uploads to Dropbox immediately after creation
- Applies to manual and scheduled backups
- No manual upload button needed
Selective Upload: If auto-upload disabled:
- Upload backups manually from Manage Backups page
- Click cloud icon next to backup
- Useful for testing or selective offsite storage
Bandwidth Limiting
Why Limit Bandwidth:
- Prevent saturating server connection
- Avoid hosting provider bandwidth throttling
- Allow site to remain responsive during upload
Configuration:
- Upload Speed Limit: Set max KB/s (e.g., 1024 KB/s = 1 MB/s)
- Unlimited: Leave at 0 for maximum speed
- Recommended: 50% of server upload capacity
Finding Your Server Upload Speed: Use online tools or contact hosting provider:
- Shared hosting: 10-50 Mbps typical
- VPS: 100-1000 Mbps
- Set limit to 50% to avoid congestion
Chunk Size Configuration
What is Chunked Upload: Large files split into smaller chunks for reliable upload:
- Default: 4 MB chunks
- Dropbox API supports up to 150 MB chunks
- Smaller chunks = more reliable on slow/unstable connections
- Larger chunks = faster upload on stable connections
Recommended Chunk Sizes:
- Shared hosting (slow/unreliable): 2-4 MB
- VPS (stable connection): 8-16 MB
- Dedicated/cloud (fast connection): 32-64 MB
Configuration: Adjust in Upload Settings > Chunk Size dropdown
Retry Settings
Upload Retry Configuration:
- Max Retries: Number of retry attempts (default: 3)
- Retry Delay: Seconds between retries (default: 5)
- Exponential Backoff: Increase delay with each retry
Example:
- Attempt 1 fails → wait 5 seconds
- Attempt 2 fails → wait 10 seconds (2×)
- Attempt 3 fails → wait 20 seconds (4×)
Prevents hammering Dropbox API during temporary issues.
Default Backup Path
Folder Structure: Backups stored in: /Apps/[YourAppName]/backups/
Customization:
- Default Path:
/backups/%site%/%date%/ - Variables:
%site%= Site name/domain%date%= YYYY-MM-DD%type%= Manual, Scheduled, Safety
Example Result:
/Apps/WordPress-Backups-MyBlog/
└── backups/
└── mysite-com/
├── 2025-02-15/
│ ├── backup-abc123.zip
│ └── backup-abc123.sql
└── 2025-02-16/
├── backup-def456.zip
└── backup-def456.sql
Organization Tips:
- Use date-based folders for easy cleanup
- Include site name for multi-site management
- Keep structure consistent across cloud providers
Testing Your Dropbox Integration
Manual Upload Test
- Create test backup: Backup Copilot > Create Backup
- Select components (database is fastest for testing)
- Click Create Backup
- Watch for cloud sync status: “Uploading to Dropbox…”
- Verify success: “Uploaded to Dropbox successfully”
Screenshot: Backup with cloud upload button
Verifying Files in Dropbox
- Log into Dropbox web interface: https://www.dropbox.com
- Navigate to Apps folder
- Open your app folder (e.g.,
WordPress-Backups-MyBlog) - Browse to
backups/subfolder - Confirm backup files present (ZIP and SQL)
- Check file sizes match WordPress backup sizes
Screenshot: Dropbox folder with backups
Checking Upload Status
In WordPress Manage Backups table:
- Cloud Status column shows sync status
- ✅ Green checkmark = Uploaded successfully
- ⏱️ Clock icon = Upload in progress
- ❌ Red X = Upload failed (click for error)
Screenshot: Cloud sync status indicator
Managing Dropbox Backups
Viewing Cloud Storage Usage
In Backup Copilot Pro:
- Cloud Storage tab displays quota
- Shows: “1.2 GB used of 2 TB (0.06%)”
- Updates after each upload
In Dropbox:
- Bottom left corner shows storage bar
- Click for detailed breakdown
- Set alerts at 80% capacity
Screenshot: Storage quota display
Downloading from Dropbox
Direct from Dropbox:
- Browse to backup in Dropbox web/app
- Right-click file
- Select Download
- File downloads to your computer
From WordPress:
- Download button retrieves from cloud if local file deleted
- Useful for disaster recovery when server is down
Deleting Cloud Backups
Automatic Deletion:
- Retention policy auto-deletes from Dropbox
- Matches local retention settings
- Keeps cloud and local in sync
Manual Deletion:
- Delete from Dropbox app/web interface
- Or delete in WordPress Manage Backups (deletes from both)
Bulk Cleanup:
- Delete entire dated folders in Dropbox
- Frees space for new backups
Handling Large Files
Dropbox File Size Limits:
- Free accounts: Uploads < 2 GB per file via web
- API uploads: 350 GB per file (via chunked upload)
- Backup Copilot Pro uses API (no practical limit)
Large Backup Tips:
- Use chunked upload (automatic for files > 150 MB)
- Increase PHP
max_execution_timeto 600+ - Monitor upload progress
- Consider database-only backups for frequency
Troubleshooting Common Issues
“Authentication Failed” Error:
- Cause: Invalid App Key/Secret or token expired
- Fix: Re-enter credentials, click “Reconnect to Dropbox”
Upload Timeouts:
- Cause: PHP execution time too short for large files
- Fix: Increase
max_execution_timein php.ini to 600 seconds
Storage Quota Exceeded:
- Cause: Dropbox account full
- Fix: Delete old backups or upgrade Dropbox plan
Connection Drops During Upload:
- Cause: Unstable network or server timeout
- Fix: Reduce chunk size to 2 MB, enable retry logic
App Permissions Issues:
- Cause: Missing scopes in Dropbox App Console
- Fix: Add required scopes (files.content.write, etc.), reconnect
Security Best Practices
Protecting Your App Credentials:
- Never commit App Key/Secret to version control
- Store in WordPress database only
- Use environment variables for multi-site deployments
- Regenerate secret if compromised
Access Token Management:
- Tokens stored encrypted in WordPress database
- Refresh automatically (no expiration with Dropbox)
- Revoke access in Dropbox settings if site compromised
Revoking Access:
- Dropbox web > Settings > Connected apps
- Find your app name
- Click Remove to revoke access
- WordPress uploads will fail until reconnected
Optimizing Performance
Upload Speed Optimization:
- Schedule uploads during off-peak hours
- Use larger chunk sizes on stable connections (16-32 MB)
- Disable bandwidth limiting on high-speed hosting
- Run uploads after backup completion (not during)
Reducing API Calls:
- Batch operations when possible
- Cache file listings
- Avoid unnecessary connection tests
Monitoring:
- Check upload completion times
- Review Dropbox API quota usage (if applicable)
- Set up email alerts for failed uploads
Related Resources
- Dropbox API Documentation
- Creating a Dropbox App
- OAuth 2.0 Guide
- Dropbox API Rate Limits
- Dropbox Storage Plans
Ready for seamless cloud backups? Upgrade to Backup Copilot Pro and connect Dropbox, Google Drive, and OneDrive. Automatic sync, unlimited schedules, and peace of mind!

