This feature is available with some paid plans
Errors with bulk link uploads are often caused by one or more issues with the CSV file used.
Before trying the troubleshooting steps on this page, first confirm that you're using the CSV bulk shortening template, not the Campaigns template.
Here are the templates for download:
Troubleshooting upload errors
You can check the status of all of your bulk uploads in your account settings. There are three possible status messages:
- Upload complete
- Submission error
- Error
Submission error
The "Submission error" status means that there was an issue with the spreadsheet. This means that either there's no content in the file or that the column headers don't match our template.
The column headers in your upload file need to match the template. Editing these columns results in an upload error.
Link errors
The "Error" status means that there were issues with one or more links in the upload. You can download a file with the specific issues for any link that we were unable to shorten.
We have a guide to all of the error codes that you might see in that file.
Here are some common issues:
- Make sure that the number of links in your file is within the limit for your plan. The number of links you can upload in each file is limited by your subscription plan (and not all plans include bulk link shortening). Check our pricing page for details.
- Each back-half must be unique and unused for each domain. For example, if you shorten your links using the bit.ly domain, it's very likely that a common back-half isn't available.
- Links need to start with https:// or http:// to be shortened. Links missing that prefix don't upload successfully.
If you haven't received your confirmation email
When the links in your bulk upload have been imported into Bitly, we send an email confirming the upload is complete.
If you haven't received that email, check your primary email address in your profile settings. This is the email address that will receive the confirmation email.
Be aware that, depending on the size of your file, it could take from minutes to hours to process your links.
If the bulk upload still results in an error
If you've checked for these issues and still experience an error when you upload your CSV, let us know so that we can help identify and fix the problem.