If you need to add a large number of links at once, the CSV import feature is the most efficient method. Linkody supports different formats and offers flexible import options.
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 |
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.