The Swordfish Knowledge Base

The Swordfish File Upload tool makes it easy to enrich a list of contacts in bulk. The available features and data sources depend on your plan type, with each offering different capabilities for file enrichment.

Plan Availability & Features

Unlimited Teams Plans (Annual Billing)

File Upload – Enrich Spreadsheets with:

• Standard mapping fields for common data points
• Enrich large lists efficiently
• Usage counts toward your team's expanded fair use policy

Note: File upload is only available on Unlimited Teams plans (billed annually), not on Unlimited Solo plans.

Legacy Plans (Pre-July 2025)

Advanced File Upload with:

• Extended mapping fields for more data point options
• Can enrich files using name, company, location data
• Different data sources: Access to alternative data sources for file enrichment
• Credit-based billing: Charged per successful match

Important: Since legacy file upload pulls from extended data sources that are separate from our unlimited plan infrastructure, this feature operates on a credit-based system even for customers who might otherwise have unlimited plans. This ensures access to the specialized data sources required for advanced file processing.

What Kind of Data Can I Upload?

Unlimited Teams Plans

Your file should ideally contain:

• LinkedIn URL (public profiles only)
• Facebook URL
• Twitter URL
• Social profile URLs for best match rates

You can also include:

• First & Last Name + Company
• Email addresses
• Phone numbers

Legacy Plans

You can upload files containing any combination of:

• LinkedIn URL (public profiles only)
• Facebook URL
• Twitter URL
• First & Last Name + Company
• First & Last Name + Job Title
• First & Last Name + Location
• Any Email Address
• Any Phone Number
• Physical addresses
• Other data points available through extended mapping fields

The more specific your data, the better your match rate will be.

How to Use File Upload

For Unlimited Teams Plans

1. Navigate to the File Upload section in your dashboard
2. Upload your spreadsheet (CSV, Excel formats supported)
3. Map your columns to available Swordfish fields
4. Select what data you want to enrich (emails, phone numbers, social profiles)
5. Submit for processing

For Legacy Plans

1. Navigate to the File Upload section in your dashboard
2. Upload your spreadsheet (CSV, Excel formats supported)
3. Choose from extended mapping field options
4. Customize your upload preferences:
   • Set "Must-Have" Data: Only enrich contacts if specific data types are available
   • Limit credit usage: Set a cap on the number of rows to process
5. Submit for processing

Customizing Your Upload (Legacy Plans)

Legacy plans offer additional customization options:

• Set "Must-Have" Data: For example, only enrich contacts if a personal email or mobile number is available
• Limit Credit Usage: Don't want to process your entire file at once? You can set a cap on the number of rows Swordfish should enrich

Example: If your file has 1,000 contacts but you only want data for the first 50 matches, just set your cap to 50.

What to Expect

For Unlimited Teams Plans

• Processing time: Files are processed efficiently with bulk capabilities
• Fair use applies: Large file uploads count toward your team's fair use policy
• Social URL optimization: Best results when your data includes social profile URLs

For Legacy Plans

• 1 credit per successful match: You're only charged when we find and add data
• Extended processing options: More flexibility with data types and matching criteria
• Alternative data sources: May find different results than unlimited plans

What Happens After You Upload?

Once you submit your file:

1. Swordfish will process the file line by line, enriching each row with contact data we can match
2. When the results are ready, you'll receive a notification by email
3. You'll get back your original file—with added Swordfish columns for:
   • Name
   • Emails
   • Mobile Numbers
   • Landlines
   • Social Profile URLs (when found)

No need to monitor the upload or wait around—just send it off and we'll take care of the rest.

Which Plan is Right for File Uploads?

Choose Unlimited Teams (Annual) if:

• You have social URLs in your data
• You need to process large volumes regularly
• You want unlimited usage within fair use guidelines
• You're on a team plan with annual billing

Choose Legacy Plans if:

• Your files don't contain social URLs
• You need extended mapping field options
• You want credit-based billing with pay-per-match pricing
• You need access to different data sources
• You're on an Unlimited Solo plan (since file upload isn't available on Solo plans)

Note: Unlimited Solo plans do not include file upload functionality. Solo users who need file enrichment should consider either upgrading to Unlimited Teams or using a Legacy plan for file upload capabilities.