How to import and export cross-links
Advanced SEO Suite extension allows you to import and export cross-links, which might reduce manual work during store migration or can be used as backups.
Navigate to Marketing -> Cross-links and click Import/Export links button.
Import cross-links
Click Choose file button in the Import links (.csv) configuration. Then, locate the file in your local system and select it. The file must be in .csv format to be interpreted correctly and should be created using UTF-8 encoding with a comma as the field delimiter.
The keyword column is a required field. If it is not filled in, the CSV file will not be accepted.
CSV columns
| Column | Required | Description |
|---|---|---|
link_id | No | Existing record ID. If provided, the row is updated; otherwise a new record is created. |
keyword | Yes | The word or phrase that becomes a hyperlink. |
url | Conditional | Target URL. Required when link_type is url or absent. Leave empty for product and category types. |
url_title | No | Tooltip text shown on hover. |
url_target | No | Link target attribute (_self, _blank, _parent, _top). Defaults to _self. |
is_nofollow | No | 1 to add rel="nofollow", 0 otherwise. |
max_replacements | No | Maximum number of occurrences replaced on a single page (0 = unlimited). |
sort_order | No | Sort priority when multiple links share the same keyword. |
occurence | No | Direction of keyword search (1 = first, 2 = last, 3 = all). |
is_active | No | 1 to enable the link, 0 to disable. |
store_id | No | Store view ID (0 = all stores). Separate multiple IDs with /. |
link_type | No | url (default), product, or category. See link types. |
entity_id | Conditional | Product or category ID. Required when link_type is product or category. |
When the file is selected (you will see the name of the file near to the Choose file button), click Import links button to upload the file to Magento system. If uploaded successfully, the message [Quantity] records were inserted or updated appears.
Correct example of .csv file can be downloaded by clicking Example of csv file link.
CSV files exported before the link_type / entity_id columns were introduced import correctly — rows without these columns are treated as url type.
Export cross-links
Click Export links button in the Export links (.csv) configuration to write all cross-links in the file and download it. The file has the name autolink.csv and will be renamed if there is the same named file in the download directory. The exported file includes the link_type and entity_id columns, so ID-based links can be re-imported without modification.