Chaos docs

How to use Chaos

Step-by-step guides for forms, quizzes, lessons and live games, plus the API, webhooks and self-hosting. Start with What is Chaos?, or search for what you need.

Start

3 articles

What is Chaos?Turn what you know into something people can use.Make your first formFrom a blank page to a link you can send, in a few minutes.Find your way aroundThe sidebar, search, and the top bar.

Create

21 articles

Make a quizA quiz is a form with Quiz mode switched on.Write a lessonA page like a document, for teaching one thing well.Build a courseLessons in a clear order, for people to take.Question typesThe 18 kinds of question, and how to add, order and change them.Logic and branchingShow a question or section only when an earlier answer calls for it.EndingsThe message people see after they submit.File uploadsLet people attach files to their answer, and what happens to those files.Quizzes and scoresHow marks work, and how to show a result.Publish a formDrafts, live forms, versions, and what each status means.Links and embeddingThe public link, your own custom link, language links and embed code.Who can respond, and limitsAccess codes, sign-in, response limits, open and close dates.What people see when they answerSaving, receipts, editing, and continuing later.Read your resultsThe summary, individual responses and how to sort through them.Unfinished responsesWhat collecting unfinished answers stores, when it saves, and what it means for privacy.ThemesPick a look, change it, and reset it.Colours, fonts and start screensEverything under Customize on the Design tab.Ways to answerAll on one page, section by section, one at a time, or swipe.SoundsOptional taps and chimes for the people answering.Collaborators and commentsInvite editors and viewers, and leave notes.Templates and importStart from something instead of a blank page.English and ArabicForms in two languages, and Chaos itself in Arabic.

Learn

3 articles

Community lessonsFind, save and report public lessons and courses.Progress and weak areasSee what you've finished and what still needs practice.Copy and remixMake your own editable copy, with the original author credited.

Play

1 article

Live gamesPlay a quiz together: questions on a big screen, answers on phones, a leaderboard after each one.

Connect

5 articles

Connect Max or another appLet an app create drafts here and read simple counts, with limits you set.MaxTurn Max pages into Chaos drafts.ClaudeUse Chaos from Claude on the web, desktop, phone and Claude Code.Notion (coming soon)A Notion connection is planned. It isn't available yet.ChatGPTUse Chaos from ChatGPT, or from Codex with the Chaos plugin.

Developers

4 articles

Integration APIFor developers: what your code can do with a connection token, and where the full contract is.MCPUse Chaos directly from compatible assistants such as ChatGPT and Claude.WebhooksLet Chaos tell your own server when a response arrives or a form opens or closes.Open source and self-hostingChaos is open source under the AGPL. Run your own copy with Docker.

Account

10 articles

PlansPersonal use is free. Business pricing is per person.Sign in and sign outYour account, your username, and leaving safely.App SettingsOne page. Each change applies straight away.Your LibrarySearch, filter, sort and group your forms and quizzes.Sidebar and pinsPin favourites, fold sections, hide or resize the sidebar.Archive and deleteArchive first. Delete for good only from the Archive.Undo and redoTake back changes in the builder and after actions.Export responsesExcel, CSV and JSON files, and a file of the form itself.Keyboard shortcutsEverything you can do without the mouse.Get helpWhere to ask a question, report a problem or check the service.

Legal

1 article

Terms, privacy and copyrightThe rules for using Chaos, and how your data and content are handled.

More

1 article

Business teams and team-only contentWork together in a team, and publish forms, quizzes, lessons, courses, flashcards and games only your team can see.