How to use the Export & Import tools?
Export/Import URLs is a download/upload tool that works in two format options - CSV or XML.
- Login to your account and click Manage URLs button.
- Click Export or Import button in upper right corner of link list.
- Note* Export and Import is not available in free trials. These buttons are visible only for normal subscribers.
Export Function
- Applies globally to all URLs in the account.
- The data in exported file can include: "Long Url";"Short Url"; (and 7 other optional parameters)
- Should easily be able to download all URLs in your account.
Import Function
- There is no file size limit, but all URLs account limits apply. Contact us if you need to exceed your monthly limit using an import.
- Import operation can be relatively slow (if number of URLs > 100) and includes a timeout element. After 30s of waiting, browser may show a "Server Not Responding" message. The server is still working on import, you just need to give it more time. The number of URLs are displayed after each successful import.
Other details about the import procedure
- Supported file formats: CSV and XML (format recognized by mime-type sent by browser, not by file extension).
- Supported import fields: long URL; short URL (short URL parsed and only hash is used, other parts ignored).
- Short URLs with duplicate or invalid hash are skipped.
- Long URLs are validated according to our normal validation procedure. If it is not valid, the URL is skipped.
- Requires semicolon delimiter instead of comma.
- If using quotation marks around URLs, a misplaced mark can trigger an error. Quotations are not mandatory, but highly recommended if URLs contain unusual symbols or spaces.
- Import looks for long URL then short URL. Required column order: "long URL";"short URL"
- First line is always used for column headers.
- If you need a clean slate in preparation for a new import, a quick way to do this is Settings > Account > Account Settings > Purge URLs
Import format examples
CSV file examplesUser-space specific error messages
XML parsing error: "Error reading XML file"
XML errors: [description of syntax error]
Error messages that mean unable to recognize format
File upload error: "Unknown file type"
CSV parsing errors: "Error reading CSV file"
Data format requirements not met: "0 URLs imported"
"Empty URL"
XML error "Not well-formed (invalid token)" at line 1, column 1