All docs

Import links from another tool

Bring a link list from another link-in-bio tool into a Bio Page, preview what will happen first, and see what is left out.

Updated . 2 min read.

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, type and hidden; a semicolon works as separator too.
  • a JSON file with a list of links, or an object with a links list, 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 position column 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.