Skip to main content
An HTML document is a finished page: a report, a one-pager, a clickable prototype. Your agent builds it, and it opens as a designed page rather than as a document you edit. Pages can run scripts, so they can animate, switch tabs, filter a chart, or walk a client through a checkout flow.
This is not one of the six document formats. Those are views over a document you keep working on. An HTML document is a finished page.
A slide deck is also built as an HTML document, but it opens on a page of its own, with slide-by-slide controls. See Slides. Everything below is about other HTML pages.

How one gets created

Ask your agent:
“Turn the Q3 channel numbers into a one-page HTML report I can send to the board.”
“Build a clickable mock of the new checkout so the client can try both options.”
Only a connected agent can create one. There is no new-HTML-document button and no editor for them in the app. To change one, ask your agent again and it updates the page. If you already have the page open, it updates as soon as the new version is saved. Tatara checks every version as it is written and tells the agent what to fix. It also opens the page in a desktop browser and a phone-sized one and sends any errors back, so the agent can fix a broken page before you open it.

How pages run safely

Pages run on a separate domain from Tatara, and each document gets an address of its own there. That domain holds none of your Tatara credentials. A page’s scripts cannot see your account or anything else in your workspace. A page can load web fonts and the code libraries it was built with, and nothing else. It cannot send data to another site or fetch live data when it opens, so everything it shows has to be built into the page.

How it renders

An HTML document is read-only. It fills the area below the top bar edge to edge, with no title heading, no width control, and no editor. The title is the last item in the breadcrumb. Three buttons sit at the right of the top bar, after the favourites star:
  • Share creates a public link. See Sharing a page.
  • Open raw in new tab opens the page on its own. Scripts do not run there, so anything animated or clickable only works in the app or on a shared link.
  • Expand gives the page the whole window. A strip along the top names the file, with a button to close it. Escape also brings you back.
An HTML document has the details rail like any other document, so it can be filed, described, and tagged. The rail’s first card, File, shows the file name and an Open raw link.

Sharing a page

To show a page to someone outside your account, such as a client or your board, give them a public link.
1

Open the share window

Open the document and choose Share in the top bar.
2

Create the link

Choose Create public link, then Copy to copy the link it shows.
Anyone with the link can view the page without signing in. They see what you see, scripts and images included, filling their browser window, with a Shared via Tatara badge in the bottom-left corner. Nothing else in your workspace is visible to them.
  • The link always shows the current version, so changes your agent makes reach everyone holding it.
  • Each document has one public link at a time. Opening Share again shows the same link.
  • Remove public link turns the link off for good, straight away. There is no confirmation step. Sharing again creates a new address, so send people the new one. Anyone who opens the old link sees This link is no longer active.
  • Deleting the document turns its link off too. If the document is restored, the same link works again.
  • Only HTML documents can be shared this way, and only from the app. Agents cannot create public links: publishing is a decision a person makes. A slide deck is shared the same way, from its own page.
  • On an HTML page, Share is hidden while the document is locked. A link created before the lock keeps working. A deck’s page always shows Share.
To give someone outside the account read access to a whole folder instead, see Sharing a folder.

If it looks wrong

If the page looks broken or empty, ask your agent to fix it. It already has the errors Tatara found when it saved the page. If you see Couldn't load the HTML., choose Retry, which reloads the page. See Troubleshooting.