Data Import
Import historical analytics data from other platforms
The data import feature allows you to migrate your historical analytics data from other platforms to AddonPulse. This preserves your analytics history when switching from competitors, giving you a complete view of your data without losing valuable insights.
Data import is available on Starter and Growth plans. Free trial users will need to upgrade to access this feature.
Supported Platforms
Currently, AddonPulse supports importing data from:
- Umami
- Simple Analytics
Additional platforms may be added in the future based on user demand.
Plan Requirements
| Plan | Access | Historical Window | Monthly Event Limit |
|---|---|---|---|
| Starter | ✅ Available | 36 months | Plan limit applies |
| Growth | ✅ Available | 60 months (5 years) | Plan limit applies |
Import Limits
Historical Data Windows
The historical data window determines how far back you can import data:
- Growth plans: Import data from the past 60 months (5 years)
Events outside your plan's historical window will be automatically skipped during import.
Event Quotas
Imported events count toward your monthly event limit:
- If you're close to your monthly limit, imports may be partially skipped
- Skipped events are counted and displayed in the import history
- Consider upgrading your plan if you need to import large amounts of data
Concurrent Imports
- Maximum 1 active import per organization
- New imports are blocked until the current one completes
- Maximum 2-hour timeout per import
How to Import Data
Export Data from Source Platform
Umami:
- Navigate to Settings → Data
- Export your data as CSV
- Ensure the export includes all required fields
Simple Analytics:
- Go to your site settings
- Navigate to Export section
- Download your analytics data as CSV
Navigate to Import Settings
- Open your AddonPulse dashboard
- Navigate to Site Settings
- Click on the Import tab
Select Platform and Upload CSV
- Select your source platform from the dropdown
- Click "Choose File" and select your exported CSV
- Click the Import button
For very large imports (multiple GB), consider splitting your CSV into smaller files and importing them sequentially.
Monitor Import Progress
Your import will begin processing in the background. You can:
- View the import status in the "Import History" section
- Monitor the number of imported, skipped, and invalid events
- Continue using AddonPulse while the import runs
Large imports may take several minutes to complete. The page will automatically refresh to show updated progress.
Import History
The Import History section displays all your past and current imports.
Import Metrics
Each import shows three key metrics:
Imported Events
- Number of events successfully imported into AddonPulse
- These events are now visible in your analytics dashboard
Skipped Events
- Events that were excluded during import
- Common reasons:
- Outside your plan's historical data window
- Would exceed your monthly event quota
Invalid Events
- Events that failed validation during import
- Common reasons:
- Malformed CSV data
- Missing required fields
- Invalid date/time formats
- Data type mismatches
If you see a high number of invalid events, verify your CSV export matches the expected format for your platform.
Managing Imports
Deleting Completed Imports
- Click the trash icon next to any completed import
- Confirm the deletion in the dialog
- This will permanently remove the import record and all associated events from your analytics
- Active imports cannot be deleted
Deleting an import removes all events that were imported. This action cannot be undone. Make sure you have a backup of your original CSV file.
Troubleshooting
Events Skipped Due to Quota Limits
Cause: Importing the events would exceed your monthly event limit.
Solution:
- Wait until the next billing cycle when your quota resets
- Upgrade to a plan with a higher event limit
- Import smaller date ranges to stay within quota
Events Skipped Due to Date Range
Cause: Events are older than your plan's historical data window.
Solution:
- Upgrade to Growth plan for 60-month history (vs 36-month on Starter)
- Filter your CSV export to only include recent data
High Invalid Event Count
Cause: CSV format doesn't match the expected structure for your platform.
Solution:
- Verify you selected the correct platform
- Check that your CSV export includes all required fields
- Look for special characters or malformed data in the CSV
- Try importing a small sample file (first 100 rows) to test
Import Appears Stuck
Cause: Very large files can take time to process, or a timeout occurred.
Solution:
- Wait up to 2 hours for the import to complete
- If still stuck after 2 hours, the import will be automatically marked as complete
- Check the imported event count to see if any data was processed
- Contact support if no events were imported
Best Practices
Before You Import
- Export a complete backup from your current analytics platform
- Test with a small sample (first 1,000 rows) before importing your full dataset
- Check your event quota to ensure you have sufficient capacity
- Verify date ranges match your plan's historical window
- Review CSV format matches the required structure for your platform
During Import
- Don't close the browser tab
- Monitor the progress in the Import History section
- Check for skipped/invalid events early to catch format issues
- Wait for completion before starting another import
After Import
- Verify your data appears correctly in analytics dashboards
- Check date ranges to ensure historical data is visible
- Compare totals with your source platform to validate accuracy
- Keep the original CSV as a backup before deleting the import