If you already keep a list of links somewhere else, you can import it instead of retyping it. Only import a list that is yours, or that you are allowed to use.
Prepare the file
Use either:
- a CSV file with a header row. Recognised columns are
title,url,position,image,alt,description,typeandhidden; a semicolon works as separator too. - a JSON file with a list of links, or an object with a
linkslist, using the same field names.
A file can be up to 1 MB and 200 entries.
Preview, then import
Open your page, choose the Import tab, choose a file or paste the content, and select Preview import. Nothing is saved yet. Each entry shows whether it is ready, ready with a note, or left out, with the reason.
- The order of the file is kept. A
positioncolumn takes priority. - Titles, addresses, descriptions, images and image descriptions are carried over. Images are copied to your own storage; an image without a description is flagged, never given an invented one.
- Embeds, widgets and block types that cannot be recreated faithfully are listed as left out. Formspring does not guess at them, so add them by hand.
- Entries that were hidden in the export are imported switched off.
- Addresses that are not http or https, point to private networks or are on a blocked domain are left out.
- Repeated addresses are flagged.
Confirm that the list is yours and choose Import. The links are added after the blocks you already have; nothing existing is changed.
From the API and assistants
POST /api/v1/bio-pages/{id}/import/preview previews (needs bio:read) and POST /api/v1/bio-pages/{id}/import imports (needs bio:write, and authorized set to true). The preview_bio_import and import_bio_links assistant tools do the same.
Keyboard and screen readers
The published page has a "Skip to links" link as its first stop, one main landmark, one top-level heading, a labelled list of links, and text alternatives for images. The tab bar works with the arrow keys. A full pass with a real screen reader is still recommended before you share a page widely.
