Import & Export#
Stashed provides tools to import your existing bookmarks and export your data for backup or migration.
Import Features#
YouTube Subscription Import#
Import all your YouTube subscriptions into a stash automatically.
What Gets Imported#
- All channels you’re subscribed to
- Channel names as link titles
- Channel URLs as links
- Auto-generated descriptions
- Channel thumbnails as preview images
How to Import YouTube Subscriptions#
Step 1: Export from Google Takeout
- Go to Google Takeout
- Deselect all products
- Scroll to YouTube and YouTube Music
- Click “All YouTube data included”
- Deselect everything except Subscriptions
- Click “Next”
- Choose export frequency (one-time)
- Select file type (.zip recommended)
- Click “Create export”
- Wait for email (may take minutes to hours)
- Download the ZIP file
Step 2: Extract Subscription File
- Unzip the downloaded file
- Find
subscriptions.csvorsubscriptions.json - Keep this file handy
Step 3: Import to Stashed
- Create a new stash (e.g., “YouTube Channels”)
- Open stash settings
- Look for Import options
- Select YouTube Subscriptions
- Upload your CSV or JSON file
- Review the preview
- Click Import
- Wait for processing to complete
Supported Formats#
- CSV —
subscriptions.csvfrom Google Takeout - JSON —
subscriptions.jsonfrom Google Takeout - OPML — Standard podcast/subscription format
Import Limits#
- Maximum channels per import: 1000
- File size limit: 10MB
- Rate limited to prevent abuse
Bookmark Import (General)#
Import bookmarks from other services or browsers.
Supported Formats#
HTML Bookmark Files
- Export from browsers (Chrome, Firefox, Safari, Edge)
- Standard Netscape bookmark format
- Preserves folder structure (may create multiple stashes)
CSV Files
- Custom CSV with columns:
url,title,description,tags - Import from spreadsheets
- Bulk edit before import
OPML Files
- Standard feed subscription format
- Import from RSS readers
- Podcast app exports
How to Import Bookmarks#
From Browser HTML:
Export from Browser:
- Chrome: Bookmarks → Bookmark Manager → Export
- Firefox: Bookmarks → Manage → Export to HTML
- Safari: File → Export Bookmarks
- Edge: Favorites → Manage → Export
Import to Stashed:
- Create a new stash
- Open import feature
- Select HTML Bookmarks
- Upload your bookmark file
- Choose import options (see below)
- Click Import
Import Options:
- Create separate stashes — One stash per folder
- Import to current stash — All links in one place
- Skip duplicates — Don’t import existing URLs
- Import tags — Preserve browser tags (if available)
Import Best Practices#
Before Importing#
Clean Your Data:
- Remove dead links
- Delete duplicates
- Organize into folders
- Update titles if needed
Plan Your Structure:
- Decide: one big stash or many small?
- Consider tagging strategy
- Think about naming conventions
Backup First:
- Export your current Stashed data
- Keep original import file
- Test with small batch first
During Import#
Monitor Progress:
- Watch for errors
- Check import count matches
- Verify links are accessible
Don’t Close Browser:
- Let import complete fully
- Large imports may take time
- Interrupted imports may duplicate
After Import#
Review Results:
- Check a sample of links
- Verify images loaded
- Confirm tags imported
- Fix any formatting issues
Organize:
- Add missing tags
- Update descriptions
- Remove unwanted links
- Reorganize if needed
Export Features#
Export Your Data#
Download all your Stashed data for backup or migration.
What Gets Exported#
Full Export includes:
- All stashes you own
- All links in each stash
- Tags on each link
- Descriptions and titles
- Creation dates
- Metadata (images, favicons)
Export does NOT include:
- Passwords (for security)
- Other users’ data
- Deleted items
- Draft/unsaved changes
Export Formats#
JSON (Recommended)
- Complete data structure
- Easy to re-import
- Machine-readable
- Includes all metadata
CSV
- Spreadsheet-compatible
- One row per link
- Easy to analyze
- May lose some structure
HTML
- Browser bookmark format
- Can import to browsers
- Human-readable
- Loses tags and metadata
How to Export#
Step 1: Access Export
- Go to your Profile or Settings
- Find Data & Privacy section
- Click Export Data
Step 2: Choose Options
- Select export format (JSON/CSV/HTML)
- Choose which stashes (all or specific)
- Include or exclude metadata
- Set date range (optional)
Step 3: Generate Export
- Click Generate Export
- Wait for processing (may take time)
- Download link appears when ready
- Click to download file
Step 4: Store Securely
- Save to backup location
- Consider encryption for sensitive data
- Note the export date
- Keep multiple copies
Export Use Cases#
Personal Backup#
Why: Protect against data loss How often: Monthly or after major changes Format: JSON (complete backup)
Migration to Another Service#
Why: Switching platforms Format: Check what the new service accepts Tip: Test with small export first
Sharing Your Collections#
Why: Share curated links publicly Format: HTML or CSV Tip: Remove personal notes first
Data Analysis#
Why: Understand your habits Format: CSV (for spreadsheets) Tip: Use pivot tables and charts
Import/Export Troubleshooting#
Import Fails#
Common Issues:
File Too Large:
- Split into smaller files
- Remove some links
- Compress images first
Invalid Format:
- Check file format matches selection
- Verify file isn’t corrupted
- Try re-exporting from source
Duplicate Errors:
- Enable “skip duplicates” option
- Clean source file first
- Import to new stash instead
Timeout:
- Large imports may take time
- Don’t refresh during import
- Try smaller batches
Export Fails#
Common Issues:
Download Doesn’t Start:
- Check browser pop-up blocker
- Try different browser
- Clear browser cache
Export Incomplete:
- Check for error messages
- Try exporting fewer stashes
- Contact support if persists
File Corrupted:
- Re-download the export
- Check file size matches expected
- Try different format
Data Portability#
Moving to Stashed#
From Other Services:
Pocket:
- Export from Pocket (HTML or CSV)
- Convert format if needed
- Import to Stashed
Instapaper:
- Export from Instapaper (CSV)
- Map columns to Stashed format
- Import to Stashed
Pinterest:
- Use Pinterest export tool
- Convert to Stashed format
- Import with images
Browser Bookmarks:
- Export from browser (HTML)
- Import directly to Stashed
- Organize into stashes
Moving from Stashed#
To Other Services:
- Export from Stashed (JSON or CSV)
- Convert to target format
- Import to new service
To Browser:
- Export as HTML
- Import to browser bookmarks
- Organize in bookmark folders
API Access (Advanced)#
Programmatic Import/Export#
For developers, Stashed may offer API access:
API Endpoints:
GET /api/stashes— List all stashesGET /api/stashes/:id/links— Get linksPOST /api/stashes/:id/links— Add linksDELETE /api/links/:id— Remove links
Authentication:
- Generate API token in settings
- Include token in request headers
- Keep tokens secure
- Rotate tokens periodically
Rate Limits:
- Requests per minute: 60
- Imports per day: 10
- Exports per day: 5
Privacy & Security#
Import Security#
What’s Safe:
- Files processed securely
- Not stored permanently
- Deleted after processing
- Encrypted in transit
What to Watch:
- Don’t import sensitive data
- Review before making public
- Check for personal info in titles
- Remove private notes
Export Security#
Protect Your Data:
- Store exports securely
- Encrypt sensitive backups
- Don’t share exports publicly
- Delete old exports
Password Protection:
- Passwords never exported
- Protected stashes need manual handling
- Share passwords separately if needed
Next Steps#
Related documentation:
Quick Reference#
| Task | How To |
|---|---|
| Import YouTube | Settings → Import → YouTube → Upload CSV |
| Import bookmarks | Settings → Import → HTML → Upload file |
| Export data | Profile → Settings → Export Data |
| Backup regularly | Export monthly, store securely |
| Migrate from browser | Export browser HTML → Import to Stashed |
| API access | Settings → API Tokens → Generate |


