How to share an HTML file as a link

The short answer

Upload the .html file to Brief and copy the link. Brief hosts the file for you and keeps it Restricted at first, so only you can open it until you invite someone or change access.

1. Save the file from Claude or Codex

If the file is already on your computer, go to the next step. If the AI showed you code but did not create a file, ask for one.

Save this as one self-contained HTML file named preview.html. Keep the CSS and JavaScript inside the file. Do not use remote assets or external data.

2. Turn the file into a link

Open Brief Artifacts →

• Select Upload.
• Choose an .html, .md, or .zip file. For a small site, select Choose folder.
• Select Upload again, then copy the short Brief link.

3. Choose who can open it

New files start Restricted. For private work, leave general access Restricted and invite reviewers by email.

• Restricted: only you and people you invite can open it. Everyone signs in.
• Workspace: anyone signed in to your Brief workspace can open it.
• Anyone with the link: no sign-in is needed. Set an expiry date and revoke the link when you are done.

Read Claude’s current artifact sharing rules →

Publish straight from Claude or Codex

Once Brief is connected to your coding agent, you can skip the manual upload. Ask the agent to publish the file for you.

Publish the file or small site at <repo-relative path> with Brief’s publish_artifact tool. Keep it Restricted and return the Brief link and artifactId.

Connect Brief to your coding agent →

When the file changes, upload a new version or ask the agent to update it. The link and access stay the same, and older versions remain in the history.

Learn about comments, review, and versions →