a bio link that looks like you.
every link-in-bio service hands you the same page as everyone else, with their logo at the bottom and their name in your url.
the alternative used to be building it yourself, which is an afternoon of html and a hosting decision for what is, honestly, a list of links.
now you describe it — colors, order, the one thing at the top you actually want clicked — an agent writes the page, and htmlshare gives it a url. changing it later is another sentence, not another afternoon.
one page, your design, your url.
01 / what it isa bio link is a short page: who you are, the handful of things you want people to click, and a way to reach you. the work is never the html — it is that every service which builds it for you builds everyone else the same one.
here the page is written to your description, and you keep the html. nothing is pre-built, which is the trade: the agent writes it each time rather than picking a theme for you.
- what goes on it
- a bio, the links you care about, anything you want featured, contact
- where it lives
- one url you choose under your account prefix
- changing it later
- describe the change and republish to the same url — the link you shared keeps working
- what it stores
- nothing. there is no form, no account, no visitor data
see one in action.
02 / examplethere’s no template, no preset layout, no handful of themes to choose from. describe the page you want and your agent builds it. yours can look nothing like the example — that’s the point.
copy this, then make it yours.
03 / starting prompta starting point, not a template — the point of an agent is that the result is yours. change the sections to match what you want, and remove anything you don’t need.
Create a polished, custom link-in-bio page for me that will be published with HTMLShare.
Do not start building immediately. First, ask me a short set of questions so you have the information and creative direction you need.
DISCOVERY
Ask me about:
- Whether I already have a design, mockup, or concept from another tool that you should recreate or build from.
- Whether I have screenshots, websites, or other visual references that show styles I like.
- Who I am and how I want to be described.
- Who is likely to visit this page and what I want those visitors to do.
- The links I want to include and their priority.
- Whether there is anything I especially want visitors to notice, visit, buy, watch, read, or sign up for.
- How people should contact me, if applicable.
- Any photos, logos, icons, illustrations, or other assets I have available.
- Any additional visual preferences such as colors, typography, mood, personality, or things I specifically want to avoid.
- Where I plan to share this link, such as Instagram, TikTok, X, YouTube, LinkedIn, or multiple platforms, so tracking can be configured appropriately.
Keep the interview concise and conversational.
Ask only questions that will materially affect the finished page. If one of my answers makes another question unnecessary, skip it. If you need clarification about something important, ask rather than making an assumption.
Do not make me fill out a template or replace placeholder values.
If I provide an existing design or mockup, treat it as the primary visual direction unless I tell you otherwise.
If I provide screenshots, websites, or other references as inspiration, determine what qualities I like about them and use those qualities to create an original design rather than blindly copying them.
If I provide no visual direction, make appropriate design decisions based on what you learn about me, my audience, and my content.
DESIGN
Do not start from a predetermined link-in-bio template.
There is no required layout, set of blocks, button style, featured card, or visual structure.
Design the page specifically around my content and goals.
It does not need to look like a traditional stack of link buttons. Choose the hierarchy, typography, layout, imagery, components, and interactions that make the most sense.
Give more visual importance to the things I most want visitors to do instead of treating every link equally.
Design mobile-first. Assume most visitors will arrive from a social profile on their phone, while still making the page look polished on larger screens.
Make it:
- responsive
- accessible
- fast
- visually polished
- easy to scan
- easy to use with a thumb
- appropriate for the personality or brand I describe
Use semantic HTML, sufficient color contrast, visible keyboard focus states, appropriate alt text, large touch targets, and respect reduced-motion preferences.
Avoid unnecessary frameworks, dependencies, scripts, and heavy assets.
PAGE DETAILS
Treat this as a real public webpage, not a visual mockup.
Include the details expected from a polished production page, including where appropriate:
- descriptive page title
- meta description
- canonical URL
- Open Graph title
- Open Graph description
- Open Graph image
- Open Graph URL
- Open Graph type
- appropriate Twitter/X card metadata
- favicon
- relevant icon metadata
- theme color
- appropriate structured data when it genuinely applies
If you have the ability to create a custom favicon or social sharing / Open Graph image that fits the design, do so.
If an asset is needed that you cannot create, tell me what is needed rather than silently omitting it or substituting something inappropriate.
Do not invent identity details, URLs, claims, follower counts, testimonials, projects, credentials, images, or other facts I have not provided.
LINKS & TRACKING
Make sure every link works and goes to the intended destination.
Use clean destination URLs.
Based on where I tell you the page will be shared, determine whether UTM tracking would be useful.
If tracking would be useful, explain the proposed tracking convention briefly and confirm it with me before adding it.
Use meaningful and consistent UTM parameters rather than arbitrary values.
If the same HTMLShare page will be shared across several platforms, do not incorrectly attribute all traffic to a single platform. Recommend an appropriate approach based on how I intend to distribute the page.
Do not add tracking parameters where they are unnecessary or where they could interfere with the destination.
Use appropriate attributes for external links.
Before delivery, check for broken links, placeholder URLs, and malformed tracking parameters.
QUALITY CHECK
Before considering the page finished:
- Review it at common mobile and desktop sizes.
- Check that the visual hierarchy reflects my priorities.
- Check accessibility basics.
- Check metadata and social sharing tags.
- Check favicon and icon setup.
- Check every link.
- Check any UTM parameters.
- Check for placeholder or invented content.
- Check that images have appropriate dimensions and alt text.
- Check that the page does not require a build step or server.
- Check that there are no unnecessary dependencies.
- Remove unused or unnecessary code.
- Make sure the final result feels finished enough to use as my real public link-in-bio page.
DELIVERY
Produce the page as one self-contained HTML file wherever practical, with its CSS and JavaScript included.
Do not require a framework, build step, database, or server.
If something cannot reasonably be embedded in the HTML file, keep additional assets to a minimum and clearly identify them.
After publishing, use the final HTMLShare URL for canonical and Open Graph URL metadata wherever appropriate. If necessary and supported, update the published artifact after the final URL is known so this metadata is correct.
The finished result should feel like a custom personal website that happens to serve the purpose of a link-in-bio page — not a generic link-in-bio template.
PUBLISHING
Publish the finished page to HTMLShare and give me the link.
Use exactly one of the two paths below, preferring the first. Make the call
directly. Do not route it through a code sandbox, container, or computer-use
session — that is where the request gets blocked, and it is never necessary.
1. An HTMLShare integration or connector, if you have one configured.
The page is permanent and owned by my account. Report the url and the
siteId. There is no claimUrl or manageToken on this path — do not go
looking for one, and do not switch paths in order to produce one.
2. Otherwise, publish anonymously over REST. No account, key, or signup is
needed:
POST https://api.htmlshare.net/v1/publish
content-type: application/json
{"html": "<!doctype html> ... "}
The reference is https://htmlshare.net/docs and, for the full schema,
https://api.htmlshare.net/openapi.json
Report these from the response, in your reply and never inside the page:
url the public page
claimUrl a private link that is mine alone. opening it is how I keep
the page past its 24-hour expiry, or set an email reminder
before it goes. it carries the manage token, so it must
never appear in the published HTML or anywhere a visitor
could see it.
manageToken the only thing that can edit or delete this page later. it is
returned once and never again, so tell me what it is.
Tell me which of the two you used. If the path you reach for first is
unavailable in your environment, say so and tell me what you are switching to
before you publish — a permanent page on my account and a 24-hour anonymous
page are different things, and which one I get is my decision, not a detail.
If I ask for a change afterwards, update the existing page instead of
publishing again, so the URL I have already shared keeps working — through the
same integration on path 1, or with the manage token as an X-Manage-Token
header on path 2.give it a url.
04 / publishing ithow you publish depends on how you’re working.
- with an integration
- if your assistant has htmlshare through mcp or another supported integration, ask it to publish the finished page and hand back the url. ask for an update to that same page rather than a new one when you change something.
- from a coding agent
- keep the html file where you work. your agent edits it when you want a link added and publishes the latest version with an api key.
- manually
- no integration needed. have your assistant produce the html file, drop it on the htmlshare home page, and you have a url.
- what matters
- not how it gets published — that the page has one address you can put in every profile and never have to change.
a bio link is the one page that cannot expire.
05 / keeping it aroundfine for seeing what the agent builds. an anonymous page stops serving after 24 hours, and is recoverable by its creator for 7 days after that — which makes it worse than useless as a link in a profile.
this is the use where the free tier genuinely does not suffice. publish from your account and the page is permanent, the slug is yours, and the url survives every change you make to what is on it.
- custom url
- your prefix and page slug give you a url that’s actually yours — something you can comfortably put in every profile, post, email signature, or qr code.
- keep it around
- anonymous shares expire after 24 hours. your bio link shouldn’t. publishing from your account gives this page a permanent home.
- stable updates
- the page can change without the url changing. add a project, swap a link, change the design, or rewrite the whole thing — the link you already shared stays put.
questions.
06 / questionshow is this different from linktree or bio.link?
they give you a hosted page inside their product, with their branding and their url shape, edited through their form. this is a page you own the html of, on a url you choose, changed by describing the change. the trade is that nothing is pre-built for you — the agent writes it each time.
can i use my own domain?
not yet. pages live under htmlshare.net, and with an account you choose the path. custom domains are on the roadmap and not built.
how do i change a link later?
ask the agent for the change and republish to the same url with the manage token. the page updates in place; anywhere you pasted the link keeps working.
will it work on a phone?
that is most of what the prompt asks for — thumb-sized tap targets, real contrast, no heavy assets. check it at 375px before you publish it.