Common configuration mistakes

Small mistakes in how you set up a link, folder, or domain can lead to “not found”, blank embeds, or verification failures. Here are the most common ones and how to fix them.

Link slug already in use

Each link’s slug must be unique within the same folder (or at the root if the link isn’t in a folder). If you get an error that the slug is already in use, pick a different slug (e.g. press-kit-2 or press-kit-2024) or put the link in another folder. The dashboard may suggest alternative slugs when this happens.

Slug format

Slugs (for links and folders) can only contain letters, numbers, and dashes. No spaces, underscores, or special characters. If you type something invalid, you’ll get a clear error; fix the slug to match (e.g. my-doc instead of my doc or my_doc).

Pasting the wrong thing for embeds

For embed links, you must paste either a valid https URL or embed code (HTML/iframe). A few pitfalls:

• http instead of https — Only https links are allowed. If your source gives you an http link, see if they have an https option or use their embed code instead.
• Share link when embed code is required — Some platforms (e.g. Untitled.stream) don’t support embedding via a normal share URL. Use the “Embed” or “Get embed code” option from the source and paste that into the embed code field.
• Empty or broken code — If you paste embed code, make sure it’s complete (e.g. a full iframe tag) and not truncated. Missing quotes or a cut-off URL can cause a blank or broken embed.

Folder slug conflicts

Two folders that share the same parent can’t have the same slug. For example, you can’t have two top-level folders both with slug downloads. Use different slugs (e.g. downloads and downloads-extra) or put one inside the other so they’re not siblings.

Custom domain: apex vs subdomain

linkembed supports subdomains (e.g. links.yourdomain.com), not the root domain (yourdomain.com) for custom domains. If you try to add the root, verification will fail. Add a subdomain like links, go, or embeds and point that with a CNAME to the target we provide.

Password protection

If you turn on password protection but leave the password field empty and save, the password may be removed (no protection). If you want the link protected, make sure to enter a password before saving. When sharing, give both the link and the password to people who should have access.