Dropbox is a popular cloud storage service that allows you to store screenshots, change logs, HTML archives, and complete task backups. Unlike image-only services, Dropbox can handle all types of files. This guide will help you configure Dropbox for your tracking tasks.
About Dropbox
Dropbox is perfect for comprehensive file backups from your tracking tasks. Uploaded files automatically get shareable links for easy access and sharing with your team.
Prerequisites
Before setting up Dropbox integration, ensure you have:
- Dropbox account: Free or paid account
- Dropbox app: Created at dropbox.com/developers/apps
- Access token: Generated from your app
Step 1: Create Dropbox App
- Visit dropbox.com/developers/apps
- Click "Create app"
- Choose API type: "Scoped access"
- Choose access type: "Full Dropbox" (to upload anywhere)
- App name: "Tracker Upload Service" (or any unique name)
- Click "Create app"
Step 2: Configure App Permissions
- In your app settings, go to the "Permissions" tab
- Enable these permissions:
- files.metadata.write – Create, edit, and delete file and folder metadata
- files.content.write – Create, edit, and delete file contents
- sharing.write – Create and modify shared links
- Click "Submit" to save permissions
Step 3: Generate Access Token
- Go to the "Settings" tab of your app
- Under "OAuth 2", click "Generate access token"
- Copy the generated access token – you will need this for configuration
Security note
This access token provides full access to your Dropbox account. Keep it secure and never share it publicly.
Step 4: Configure Dropbox in Tracker
- In your Tracker dashboard, go to Upload Channels
- Click "Add New Channel"
- Select "Dropbox" as the channel type
- Fill in the configuration:
- Channel Name: Give it a descriptive name like "My Dropbox Storage"
- Access Token: Paste your Dropbox access token
- Folder Path: Path where files will be uploaded (e.g. /tracker_uploads)
- File Naming Pattern: (Optional) How to name your files
- Click "Test Connection" to verify your settings
- Click "Save" to create the channel
What gets uploaded
Unlike image hosting services, Dropbox can store comprehensive task data:
Screenshots
High-quality PNG/JPG screenshots of detected changes.
Change logs
JSON files containing detailed change information and metadata.
HTML archives
Complete HTML page snapshots for future reference.
Full backups
ZIP archives containing all task data for comprehensive backup.
File organization
Files are organized in your Dropbox according to your configured folder path:
/tracker_uploads/
├── screenshots/
│ ├── task_name_2025-01-15_14-30-25.png
│ └── another_task_2025-01-15_15-45-10.jpg
├── change_logs/
│ ├── task_name_changes_2025-01-15.json
│ └── another_task_changes_2025-01-15.json
└── archives/
├── task_name_full_backup_2025-01-15.zip
└── html_snapshots/
Uploaded files automatically get shareable links for easy access and sharing with your team.
Troubleshooting
Connection test fails
- Verify your access token is correct and not expired
- Check that your app has the required permissions enabled
- Ensure your Dropbox app is not suspended
Upload fails with permission error
- Check that files.content.write permission is enabled in your app
- Verify the folder path exists or can be created
- Make sure you have sufficient Dropbox storage space
Files uploading to wrong location
- Double-check your folder path configuration
- Folder paths should start with / (e.g. /tracker_uploads)
- Verify your app has "Full Dropbox" access, not "App folder" access
Tokens cost
Dropbox uploads cost 5 additional tokens per upload. This includes file storage and shareable link generation. Different file types may have varying costs based on size and processing requirements.
Set up Dropbox uploads
Configure Dropbox integration to store screenshots and task data from your tracking tasks.
Add upload channel
