Troubleshooting

The things that go wrong most often, and what each one actually means. If your problem is not here, the last section says where to take it.

Go to /signin. There are three ways in, and one of them almost always works.

Email and password. If it comes back with "That password didn't match. Try again, or get a sign-in link by email.", the pairing was refused. That message covers both a wrong password and an email with no account behind it, so check the address as well as the password.
Email me a sign-in link. Type your email address first, then press it. urls.bio emails you a link that signs you in without a password. If you press it with the field empty you get "Enter your email address first".
forgot password? The small button beside the password label. Same idea, but the link takes you to a page where you set a new password.

A sign-in link is good for about an hour and works once. If it has aged out you land on a page that says so plainly:

That link didn't work.

with three reasons under it: the link is more than an hour old, it was already used once, or it got rewritten in transit, usually by an email scanner. That last one is the sneaky one. Some corporate mail systems and security tools follow every link in an email to check it, which uses the link up before you ever click it. If that keeps happening, ask for a link at a personal address instead.

Nothing arriving at all is nearly always the spam folder. Check it before asking for a fourth link, because each new one invalidates the last.

"That link has expired." on the reset page means the same thing for password resets. Enter your email there and it sends a fresh one.

You keep getting bounced to the sign-in page. The dashboard, onboarding, and the admin area require a session. If your session has lapsed, urls.bio sends you to sign in and then back to where you were going.

You cannot get back into onboarding. Once your account has a name on it, onboarding is finished and /onboarding sends you to the dashboard. Everything in it lives in the Studio and in Settings afterwards.

My embed is not showing

Embeds only accept URLs from services urls.bio can render safely, and only in the shapes it can parse. Seven services work:

YouTube. A watch URL, a youtu.be link, or a Shorts link.
Vimeo. A video URL with the numeric id.
TikTok. A single video, tiktok.com/@someone/video/....
Spotify. A track, album, playlist, episode, show, or artist link.
SoundCloud. A track or a set.
Tweet. One post on x.com or twitter.com, ending in /status/....
Booking. A Calendly or a Cal.com page.

Three things account for nearly every embed that will not take:

A profile or channel URL where a single item is expected. A YouTube channel, a TikTok profile, or an X timeline is not an embed. Open the individual video or post and copy that address.
A shortened or wrapped link. Share buttons in some apps hand out a redirect rather than the real address. Open it in a browser first and copy what the address bar settles on.
A privacy-enhanced YouTube address. The youtube-nocookie.com form is not recognized. Use the plain youtube.com/watch?v= address.

While the URL is unrecognized, the field tells you so and the block stays a draft, reading "Draft · not published" in the block list, with "Not on your page yet. It publishes as soon as it has a supported URL." in the inspector. Nothing on your public page changes, and nothing is broken; there is simply nothing there yet.

The provider dropdown above the field only changes the example text and the hint wording. Picking TikTok and pasting a Spotify link still works, because the address itself decides which player gets built.

My changes are not appearing

Start with the pill in the dashboard header. It appears on your first change of the session and answers the question directly:

Saving with a spinner: the write is in flight.
Saved with a tick: it landed.
Not saved with a cloud icon: it did not.

There is no publish button and nothing to press. Text fields write half a second after you stop typing, and again the moment you click away. Switches, menus, and drags write immediately.

When a write fails, urls.bio puts the old value back rather than leaving you with something on screen that is not in the database, and tells you which one: "Could not save that change. It has been reverted.", "Could not reorder. The previous order was restored.", "Could not save your appearance changes." Nothing is retried in the background. Make the change again once your connection is back.

Cmd+Z undoes the last fifty changes, including deletes and reorders, and a message names what came back.

My block is not on my public page

Work down this list. One of them is always the answer.

It is still a draft. The block list says "Draft · not published". Fill in the field it is missing.
It is hidden. The block list says "Hidden". Turn the Visible switch back on.
It is scheduled or expired. The block list says "Scheduled" with a date, or "Expired". Clear the dates, or move them.
It is a Pro block on a Free account. Contact form, file download, and voice intro blocks stay in your editor but do not render for visitors when the plan lapses. Galleries show their first five images. See plans and billing.
A gate is in front of it. If you have Collect emails on, or any block with the 18+ switch, visitors meet that first. You are never gated out of your own page, which is exactly why it looks fine to you. Press p in the Studio, or open your page in a private window, to see what they see.
The embed has no supported URL. See above; it renders nothing rather than erroring.

My whole page shows a not-found error

Check the handle. Case does not matter, but spelling does.
Did you change your handle? The old address stops working immediately and there is no redirect. Anything already printed or pasted needs updating. See sharing.
Is it in the address bar exactly as your dashboard shows it? The sidebar menu under your name prints urls.bio/yourhandle for exactly this reason.

Uploads are refused

Avatars, thumbnails, images, galleries, and logos. JPG, PNG, GIF, or WebP, up to 5MB.
File download blocks. PDF or ZIP, up to 25MB.
Voice intro blocks. MP3, M4A, WAV, or OGG, up to 25MB.

The messages are specific: "Please upload a JPG, PNG, GIF, or WebP file", "File size must be less than 5MB", "Please upload a PDF or ZIP file", "File size must be less than 25MB". A photo straight off an iPhone is often HEIC, which is not on the list. Export it as JPEG first.

Galleries take five images on Free and twenty on Pro; logo strips take eight. At the cap the add button switches off and a line under it names the number.

Subscribers are not reaching my email tool

Email capture and the integrations that follow it are two separate things, and only the second one can fail quietly.

Check the Audience tab first. If the address is there, capture is working and the problem is downstream. Then check, in this order:

Are you on Pro? The sync is checked at the moment the address arrives. Email capture keeps working on Free; the fan-out does not.
Are both fields filled? Every provider needs its key and its list or publication id. One without the other does nothing.
Is the key still valid? A revoked or mistyped key fails silently. There is no error, no red mark, and no email.

The way to be sure is to submit a test address on your own page from a private window and watch for it on the other side. See integrations.

Visitors say the page keeps asking for their email

The confirmation is a cookie on their device, tied to your page and lasting three days. Anything that clears it starts the ask again: a private window, a different browser, a different phone, or cleared site data. The 18+ confirmation works the same way and lasts the same three days.

Confirming on one creator's page has no effect on another's. Each page asks for itself.

Something broke and I do not know what

When a page errors outright you get "Something broke on our side." and, underneath, a short code reading "Error" followed by a string of characters. That code identifies the specific failure in our logs. Write it down before you reload, because it is the single most useful thing you can hand over.

Where to take it

If none of the above resolves it:

Check the changelog. If something changed recently, it is listed there.
Reach us on social. X, Instagram, and TikTok are the accounts that get read.
Privacy, data, and legal questions go to the address in the legal pages, which is the right route for a data request or anything about how your information is handled.

When you get in touch, three things make it solvable in one exchange rather than five: your handle, what you did just before it went wrong, and the error code if there was one.