Exporting Your Journal
Quick Export
What’s Included in Exports
Your export file contains complete journal data in JSON format:- ✅ All journal entry text
- ✅ All attached photos (base64 encoded)
- ✅ All tags
- ✅ Sentiment analysis scores and mood labels
- ✅ Detected themes
- ✅ Word counts
- ✅ Creation and update timestamps
- ✅ Journal metadata
The export file is human-readable JSON. You can open it in any text editor to view your data, though it’s formatted for machine processing.
Backup Strategies
Recommended Schedule
Weekly
Export every Sunday evening as part of your weekly review routine
Monthly
Keep monthly snapshots in dated folders:
2024-03/, 2024-04/, etc.Before Updates
Always export before updating Reflect AI to a new version
After Major Entries
Export after writing particularly important entries
The 3-2-1 Backup Rule
For critical data like journal entries, follow this industry best practice:- 3 copies of your data
- 2 different storage types (e.g., local + cloud)
- 1 copy offsite (cloud or different physical location)
- Original: Data in Reflect AI on your computer
- Copy 1: Weekly export saved to your computer
- Copy 2: Weekly export uploaded to Google Drive
- Copy 3: Monthly export on an external hard drive
Importing Journal Data
Import from Export File
Prepare Your Import File
Locate the
.json export file you want to import. Ensure it’s a valid Reflect AI export.Import Process
Reflect AI will:
- Read the file
- Validate the data structure
- Merge entries into your current journal
- Display a success message
Import Behavior
Merging logic:- Entries from the import file are merged with existing entries
- If an entry exists for a date, the imported version overwrites the existing one
- Existing entries for dates not in the import file are preserved
- All metadata and sentiment scores are imported as-is
- 2024-03-15: “Today was good”
- 2024-03-16: “Went hiking”
- 2024-03-15: “Today was amazing” (different content)
- 2024-03-17: “Productive day”
- 2024-03-15: “Today was amazing” ← Overwritten
- 2024-03-16: “Went hiking” ← Preserved
- 2024-03-17: “Productive day” ← Added
Common Import/Export Scenarios
Transferring to a New Computer
Transfer File
Copy the
.json file to your new computer via:- USB drive
- Cloud storage
- Network transfer
Install Reflect AI
Set up Reflect AI on your new computer following the Installation guide.
Restoring from Backup
If you lose data or need to restore from a backup:Clear Current Data (Optional)
If you want a clean restore, click Clear All Data in the Actions menu first.
Merging Multiple Journals
If you have journal entries in multiple export files:Import Additional Files
Import the next file. Entries will merge, with newer imports overwriting conflicts.
Advanced: Manual Data Editing
Because exports are JSON files, you can manually edit them in a text editor.When to Edit Manually
- Batch-correcting dates or timestamps
- Removing specific entries before sharing data
- Merging journals from different sources
- Migrating from another journaling app
Editing Guidelines
Maintain Valid JSON Structure
Maintain Valid JSON Structure
Always ensure the file remains valid JSON:
- Use a JSON validator (like jsonlint.com)
- Keep all required fields
- Match data types (strings, numbers, objects)
- Don’t forget commas and brackets
Required Entry Fields
Required Entry Fields
Each entry must have:
Date Format
Date Format
Entry keys must be in
YYYY-MM-DD format:- ✅
"2024-03-15" - ✅
"2024-12-01" - ❌
"3-15-2024" - ❌
"2024/03/15"
Test After Editing
Test After Editing
- Save your edited JSON file
- Keep a backup of the original
- Try importing to a test installation first
- Verify all entries appear correctly
Data Format Reference
Valid Mood Values
| Mood | Compound Score Range |
|---|---|
very_positive | ≥ 0.5 |
positive | 0.2 to 0.5 |
neutral | -0.2 to 0.2 |
negative | -0.5 to -0.2 |
very_negative | ≤ -0.5 |
Valid Theme Values
Reflect AI automatically detects these themes:work, family, friends, health, food, learning, emotions, travel, creativity
Timestamp Format
All timestamps use ISO 8601 format:2024-03-15T14:30:00Z
Clearing All Data
When to Clear Data
- Starting completely fresh
- Removing test data
- Preparing to sell/give away your computer
- Switching to a different journaling system
How to Clear
Export First
ALWAYS export your data before clearing. Even if you think you don’t need it, create a backup.
Clearing data doesn’t delete export files you’ve saved. Those remain in your file system and can be imported later.
Troubleshooting
Export file won't download
Export file won't download
Try:
- Check browser download permissions
- Disable browser extensions temporarily
- Try a different browser
- Check available disk space
- Look in your Downloads folder (it may have downloaded without notification)
Import fails with 'Invalid file' error
Import fails with 'Invalid file' error
Causes:
- File is not valid JSON
- File is corrupted
- File is from a different journaling app
- File structure doesn’t match Reflect AI format
- Validate JSON at jsonlint.com
- Ensure the file has an
entriesobject - Try opening the file in a text editor to inspect it
Import succeeds but entries don't appear
Import succeeds but entries don't appear
Check:
- Are you looking at the correct dates in the calendar?
- Refresh the app (reload the page)
- Check if entries use valid date keys (
YYYY-MM-DD) - Look at different months/years
Photos not appearing after import
Photos not appearing after import
Possible issues:
- Photo data may be corrupted
- Base64 encoding may be invalid
- Photos may be too large (check file size)
Export file is very large
Export file is very large
Large files (>10MB) are usually due to many attached photos. This is normal.Options:
- Compress the file (use .zip)
- Split into multiple exports (export date ranges)
- Use cloud storage for large backups
- Consider removing old photos from entries
Security Best Practices
Encrypt Sensitive Exports
If your journal contains highly sensitive information, encrypt export files before uploading to cloud storage.
Use Secure Cloud Storage
Store exports in secure, password-protected cloud services like encrypted Dropbox or Google Drive with 2FA.
Don't Email Unencrypted
Avoid emailing exports unless using encrypted email. Use secure file transfer instead.
Delete Old Backups Securely
When removing old backups, use secure deletion tools rather than just moving to trash.
Next Steps
Customization
Personalize Reflect AI with custom themes and prompts
Privacy & Security
Learn more about how Reflect AI protects your data