Tutorials
Siteho for AI agents
For an AI agent building a website on Siteho for a person, through the browser: where each thing is, the order to work in, the limits Siteho keeps, what to ask the person first and how to check the result.
Ground rules
- Act for one person
- Work only in the workspaces they are in, with their role there. Siteho refuses the rest.
- Labels are stable
- Buttons and fields are named in these docs exactly as on screen; look for them by their text.
- Their secrets stay theirs
- Never type the person's own password or codes; ask them to sign in and pass the security check themselves.
- Errors carry a code
- A refusal comes with a sentence and a code such as WebsiteEmail.DnsNotReady: read the sentence, fix the cause, retry once.
- Buttons aren't hidden by role
- A Builder sees Publish too; Siteho refuses it. Tell the person which role it needs.
Where everything is
| Place | Address |
|---|---|
| Account | /register, /login, /verify-email, /forgot-password, /profile, /security, /sessions |
| Your own pages | /dashboard (Overview), /workspaces, /invitations, /templates (website templates) |
| A workspace | /w/{workspaceId}/dashboard, /websites, /members, /media, /svgs, /templates, /ai, /settings |
| A website | /w/{workspaceId}/websites/{websiteId} (Analytics), then /forms, /members, /user-groups, /collections, /member-variables, /registration-form, /domains, /email, /settings |
| A form | /w/{workspaceId}/websites/{websiteId}/forms/{formId}/builder and /submissions |
| The builder | /w/{workspaceId}/builder/{websiteId} |
The order to work in
- Agree the goal with the person: the kind of site, its pages, whether visitors sign in, the domain, the email addresses.
- Start from the closest website template (New Website in Websites & Pages). It brings every page and status screen, and every page is live at the siteho.app address at once.
- Set the theme in the Theme Studio before any page, so every element follows it.
- Change the pages' words and pictures, add pages in the Page Manager, and collections for lists of posts, products or events.
- Add forms; then member variables, user groups and page access if the site has accounts.
- Check every page at desktop, tablet and phone widths, in light and dark mode, with Preview.
- Ask, then publish; then the domain; then email (it needs the domain).
Limits Siteho keeps
- Storage
- 1 GB per person until June 2027, counting every workspace they are in; one media file up to 50 MB.
- Form uploads
- Images up to 5 MB, other files up to 15 MB, at most 20 files per response.
- User groups
- Up to 100 per website.
- Invitations
- Up to 50 a day per person; each lasts a week; a resend waits 5 minutes.
- Collections
- Up to 50 fields; entry addresses of lower-case letters, digits and hyphens, up to 120 characters.
- Set up only on a domain that shows Active in Custom Domains. Up to 10 addresses per domain, once its MX, SPF and DKIM records check out. Passwords 8 to 128 characters.
What the person's role allows
If Siteho answers that something isn't allowed, tell the person which role it needs instead of trying another way.
- Builder
- Builds and saves pages, forms, collections, user groups and media; sees email addresses and domains.
- Admin or owner
- Also publishes, schedules, runs A/B tests, adds domains, sets up email and makes and deletes addresses, removes members and changes workspace settings.
- Owner, or whoever made the address
- Opens its webmail and gives it a new password; no other admin can.
Ask the person before
- Publishing
- Publish, Publish later, ending an A/B test (Keep A and end, Keep B and end).
- Live parts
- The header, footer, overlays, theme and website settings are live as soon as they are saved.
- Deleting
- A website, a page, a form or its responses, a member, an email address (its mail goes with it).
- Their DNS
- Records go in at their domain provider: show them the records Siteho gives, with the copy buttons.
- Passwords for addresses
- Generate one, show it to the person once, and never keep it anywhere else.
Checking your work
- Open the website at its siteho.app address in a fresh, signed-out window and click every link.
- Look at each page at phone width: nothing should run off the side or overlap.
- Send each form once and find the response in its submissions.
- For a domain, wait for Active in Custom Domains; for email, press Check now until the domain reads Ready, then make an address and press Open webmail.
Siteho's own assistant
With a provider connected in the workspace's AI Assistant (or Siteho's free requests), the builder's assistant can make most changes from a sentence, checks contrast, phone layouts and links itself, and asks before deleting, publishing or changing live parts. See The AI assistant.