Importing links via CSV | Help Center
Importing links via CSV
Import backlinks in bulk with Linkody’s CSV feature. Supports multiple formats and flexible settings for efficient link management.
June 3, 2025
Step 1: Select the format
You can import CSV files in one of the following formats:
- Linkody’s own format
- Google Search Console (GSC)
- Ahrefs
- Moz
Choose the correct format depending on the source of your data.
If you're using Linkody’s format, you can download a sample file to ensure proper structure.
Step 2: Configure import options
Before uploading your file, you can adjust several settings:
- Update existing links – If enabled, Linkody will update any matching links with the new data.
- Max links per referring domain – Set a limit on how many links from the same referring domain should be imported.
- Apply max to file only – If checked, the max link per referring domain limit applies only to links in the uploaded file, not existing ones already in Linkody.
- Report status changes – Enabled by default. Uncheck this if you don’t want email alerts for these links.
Linkody CSV format details
If using Linkody’s own format, each line should include:
| Field | Required | Description |
| Referring page URL | Yes | URL of the webpage linking to your site |
| Tags | No | Comma-separated list of tags |
| Notes | No | Text field; email addresses and URLs become clickable |
| Expected landing page URL | No | The page on your site the link should point to |
| Expected to follow (yes/no) | No | Use 'yes' if the link must have rel=follow |
| Expected anchor text | No | The anchor text the link should have |
| Date added | No | When the link was added |
| Date expires | No | When the link expires (format YYYY-MM-DD) |
| Cost | No | Cost of the link (format 999999.99) |
Only the first column (URL) is required. The other fields can be left blank or omitted entirely if not needed.
Here’s an example of the format:
URL FROM,TAGS,NOTES,EXPECTED LANDING PAGE URL,EXPECTED FOLLOW,EXPECTED ANCHOR,ADDED,EXPIRES,COST
http://site1.com/somepage,directory,free,,/page1,yes,,,
http://site2.com,,something to remember,,yes,,2016-08-01,2017-08-01,50
http://site3.com/otherpage,guest,blog,http://mywebsite/page2,,some anchor text,,, http://site4.com/page,,,,,,,,
Summary
CSV import is ideal for bulk link additions from tools like Ahrefs, Moz, or GSC, or when migrating from spreadsheets. With flexible field mapping and optional controls, it’s the most powerful way to scale link tracking in Linkody.