Skip to main content
  1. Stashed Documentation/

Import & Export

·1174 words·6 mins· loading · loading · ·
Table of Contents
Stashed Documentation - This article is part of a series.
Part : This Article

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

  1. Go to Google Takeout
  2. Deselect all products
  3. Scroll to YouTube and YouTube Music
  4. Click “All YouTube data included”
  5. Deselect everything except Subscriptions
  6. Click “Next”
  7. Choose export frequency (one-time)
  8. Select file type (.zip recommended)
  9. Click “Create export”
  10. Wait for email (may take minutes to hours)
  11. Download the ZIP file

Step 2: Extract Subscription File

  1. Unzip the downloaded file
  2. Find subscriptions.csv or subscriptions.json
  3. Keep this file handy

Step 3: Import to Stashed

  1. Create a new stash (e.g., “YouTube Channels”)
  2. Open stash settings
  3. Look for Import options
  4. Select YouTube Subscriptions
  5. Upload your CSV or JSON file
  6. Review the preview
  7. Click Import
  8. Wait for processing to complete

Supported Formats
#

  • CSVsubscriptions.csv from Google Takeout
  • JSONsubscriptions.json from 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:

  1. Export from Browser:

    • Chrome: Bookmarks → Bookmark Manager → Export
    • Firefox: Bookmarks → Manage → Export to HTML
    • Safari: File → Export Bookmarks
    • Edge: Favorites → Manage → Export
  2. 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

  1. Go to your Profile or Settings
  2. Find Data & Privacy section
  3. 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

  1. Click Generate Export
  2. Wait for processing (may take time)
  3. Download link appears when ready
  4. 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:

  1. Export from Pocket (HTML or CSV)
  2. Convert format if needed
  3. Import to Stashed

Instapaper:

  1. Export from Instapaper (CSV)
  2. Map columns to Stashed format
  3. Import to Stashed

Pinterest:

  1. Use Pinterest export tool
  2. Convert to Stashed format
  3. Import with images

Browser Bookmarks:

  1. Export from browser (HTML)
  2. Import directly to Stashed
  3. Organize into stashes

Moving from Stashed
#

To Other Services:

  1. Export from Stashed (JSON or CSV)
  2. Convert to target format
  3. Import to new service

To Browser:

  1. Export as HTML
  2. Import to browser bookmarks
  3. Organize in bookmark folders

API Access (Advanced)
#

Programmatic Import/Export
#

For developers, Stashed may offer API access:

API Endpoints:

  • GET /api/stashes — List all stashes
  • GET /api/stashes/:id/links — Get links
  • POST /api/stashes/:id/links — Add links
  • DELETE /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
#

TaskHow To
Import YouTubeSettings → Import → YouTube → Upload CSV
Import bookmarksSettings → Import → HTML → Upload file
Export dataProfile → Settings → Export Data
Backup regularlyExport monthly, store securely
Migrate from browserExport browser HTML → Import to Stashed
API accessSettings → API Tokens → Generate
Varun Paherwar
Author
Varun Paherwar
The creator of Stashed.in who loves to make new things.
Stashed Documentation - This article is part of a series.
Part : This Article

Related