TL;DR:
- Most common: missing
https://prefix in metadata, rel="me" back-link missing for verification, or instance-specific issue. - Fix: add prefix, verify rel="me" link is on website, switch instance if persistent.
Diagnose
| Symptom | Cause |
|---|---|
| URL plain text in metadata | Missing https:// prefix |
| Green checkmark missing | rel="me" back-link missing/inaccessible |
| Link clickable but destination broken | Destination 404 / DNS issue |
| Issue only on certain instances | Instance-specific bug or moderation |
Quick Fixes
- Add
https://prefix to metadata URL. - Save profile.
- If verification missing: ensure rel="me" link is on your website + accessible publicly (no login wall).
- Re-save metadata in Mastodon ??” triggers re-verification.
- Test on web (mastodon.social/@yourname) from logged-out browser.
- If destination broken: fix or replace URL.
rel="me" Verification Issues
If green checkmark is missing despite adding rel="me" link:
- Check link is accessible publicly (no auth required).
- Verify link is in HTML
<head>or visible on page. - Confirm link points to exactly your Mastodon URL (full URL, not relative).
- Some instances cache verification ??” wait 24h.
- Re-save metadata to trigger recheck.
Federation Issues
Bio fields should sync across federation. If users on other instances see different data:
- Wait 24-48h for federation sync.
- Some instances may cache profiles longer.
- Tell users to refresh / re-fetch profile.
Instance-Level Moderation
Some instances may filter URLs to certain destinations. If your URL is blocked on certain instances:
- Check destination domain isn't on that instance's blocklist.
- Switch destinations to a clean parent domain (your own,
unil.ink). - Each instance has its own moderation rules.
FAQ
Why is my Mastodon URL not clickable?
Missing https:// prefix. Add it.
Why is verification (green checkmark) missing?
rel="me" back-link missing or inaccessible. Add link on your website pointing to Mastodon profile.
Will Mastodon tell me why verification fails?
Sometimes shows error in profile editor. Check Mastodon's logs for your instance.
Can my Mastodon link be blocked?
Per-instance moderation. Some instances filter certain destinations.
Why does federation cache old data?
Performance ??” each instance caches profile data. Refreshes within 24-48h typically.
Key Takeaways
- Always include
https://prefix. - Verify via rel="me" back-link from your accessible website.
- Federation cache: changes take 24-48h to fully propagate.
- Instance moderation may block certain URLs.
Trusted bio link for Mastodon
UniLink: unil.ink/yourname ??” never flagged on any instance.
Try UniLink free ?†’