CSV Bulk Upload

The CSV bulk upload feature enables efficient import of redirect configurations for large-scale projects.

When to Use Bulk Upload

Use Cases

  • Site Migrations: Managing redirects during domain transitions
  • URL Restructuring: Bulk updates for URL pattern changes
  • Content Management: Handling multiple redirect updates simultaneously
  • Backup & Restoration: Exporting and importing redirect configurations

Benefits

  • Efficiency: Process multiple redirects in a single operation
  • Accuracy: Standardized data format reduces manual entry errors
  • Scalability: Handle large redirect sets efficiently
  • Data Management: Export functionality for backup and analysis

CSV File Format

Column Reference

ColumnFormatRequiredExample
pathurl pathYesold-blog-post
locationfull urlYeshttps://newsite.com/blog/new-post
validUntilUrlfull urlNohttps://promo.com/sale
validUntildatetimeNo2024-12-25 23:59:00
timezoneIANA timezoneNoAmerica/New_York

Basic Example

path,location
about-us,https://newsite.com/company/about
contact,https://newsite.com/support/contact
blog,https://newsite.com/news

Temporary Redirects Example

Temporary redirects allow you to redirect to a different URL until a specified date/time, then automatically switch to the permanent destination.

path,location,validUntilUrl,validUntil,timezone
sale,https://store.com/products,https://store.com/black-friday,2024-11-30 23:59:00,America/New_York
holiday,https://store.com,https://store.com/holiday-promo,2024-12-25 23:59:00,
winter,https://store.com,https://store.com/winter-sale,2025-01-15 12:00:00,Europe/London

How it works:

  • validUntilUrl: The temporary destination URL (active until expiration)
  • validUntil: When the temporary redirect expires (format: YYYY-MM-DD HH:mm:ss)
  • timezone: Which timezone the datetime is in (optional)

Timezone handling:

  • If timezone column has a value → uses that timezone
  • If timezone column is empty → uses your account's default timezone
  • If timezone column is omitted entirely → uses your account's default timezone

Supported timezones include: UTC, America/New_York, America/Los_Angeles, Europe/London, Europe/Paris, Asia/Tokyo, Australia/Sydney, and more (IANA timezone format)

File Processing

The system uses UTF-8 encoding support for:

  • International characters
  • Unicode content
  • Multi-language text
  • Special URL encoding

Path Formatting Guidelines

✅ Valid Path Formats:

  • old-blog-post
  • category/subcategory
  • user-profile-settings
  • api-endpoint-path

❌ Path Requirements:

  • No leading slash (system strips automatically)
  • No domain paths (validation prevents this)
  • No empty string values

URL Requirements

✅ Valid Destinations:

  • https://newsite.com/page
  • HTTP and HTTPS protocols supported
  • Subdomain URLs accepted
  • External domain destinations supported

Upload Process

Accessing Bulk Upload

  1. Navigate to Manage Links in your dashboard
  2. Click "Add Redirects" button
  3. Select "CSV Upload" tab
  4. Upload interface opens for file processing

File Selection and Processing

  1. Choose your CSV file or drag and drop
  2. System validates file structure and format
  3. UTF-8 encoding processing for international characters
  4. Data parsing and validation occurs automatically

Import Management

  • Duplicate Detection: System identifies existing paths
  • Update Options: Choose to update existing redirects or skip duplicates
  • Progress Tracking: Real-time processing status
  • Error Reporting: Clear feedback on any processing issues

File Processing Limits

  • Maximum size: CSV files up to 10,000 rows
  • Character encoding: UTF-8 support for international content
  • Processing validation: Real-time error detection and reporting

Validation and Error Handling

Automatic Validation

The system checks for:

  • Missing required columns (path, default)
  • Invalid URL formats in destination field
  • Domain name conflicts with active domain
  • Empty or malformed path values

Error Resolution

  • Validation feedback: Specific error messages for corrected uploads
  • Duplicate handling: Options to update or skip existing paths
  • Real-time feedback: Processing status and completion summaries

Export Functionality

CSV Export Features

Download existing redirect configurations:

  1. Full Export: All active redirects in CSV format
  2. Data Structure: Path and destination columns
  3. Backup Capability: Save configurations for restoration
  4. Analysis Ready: Format compatible with spreadsheet applications

Processing Performance

Efficient Operations

  • Scalable Processing: Handles large redirect sets efficiently
  • Memory Optimization: Designed for high-volume operations
  • Background Processing: Non-blocking uploads during normal operations
  • Progress Indicators: Clear feedback on processing status

Quality Assurance

Best Practices for CSV Uploads

  • File Format: Ensure proper CSV structure with required headers
  • Data Validation: Review paths and URLs before upload
  • Encoding: Use UTF-8 encoding for international characters
  • Testing: Validate with smaller test files before large uploads

Processing Tips

  • Clean and consistent data formatting
  • No leading slashes in path column
  • Complete URL protocols in destination field
  • Verify file formatting in text editor before upload

Support and Resources

For assistance with bulk upload operations:

  • Use the interface validation feedback for error resolution
  • Export existing data as templates for new uploads
  • Monitor processing status through the dashboard interface

Integration Workflows

CSV upload serves as an efficient tool for:

  • Migration projects between platforms
  • Bulk redirect configuration updates
  • Backup and restoration procedures
  • Template generation for similar projects

Access bulk upload functionality through the Manage Links section of your dashboard.

Need Help?