> For the complete documentation index, see [llms.txt](https://docs.dapta.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapta.ai/dapta-forms.md). # Dapta Forms - [Dapta Forms: Overview](https://docs.dapta.ai/dapta-forms/forms.md): Dapta Forms is a free, open-source form builder at forms.dapta.ai. Build conversational forms, quizzes and lead capture flows, score answers, route people to the right ending, and send every response - [Key Concepts](https://docs.dapta.ai/dapta-forms/key-concepts.md): The vocabulary used across the Dapta Forms docs: form, question and step, Slides vs One page layout, score, outcome, partial submission, workspace, draft vs published, and the public link. - [Getting Started](https://docs.dapta.ai/dapta-forms/getting-started.md): Everything you need to go from signing in to your first published form: sign in with your Dapta account, build and publish a form in five minutes, and learn your way around the dashboard. - [Sign in with your Dapta account](https://docs.dapta.ai/dapta-forms/getting-started/sign-in.md): Sign in to Dapta Forms with your Dapta account: click Continue with Dapta, land in your workspace, find your profile and workspace in the left menu, and understand what Log out does to your shared Dap - [Quickstart: Your First Form in 5 Minutes](https://docs.dapta.ai/dapta-forms/getting-started/quickstart-first-form.md): Build, preview and publish your first Dapta Form in about five minutes: create the form, add three questions, check it on mobile, publish it and share the public link. - [Dashboard tour](https://docs.dapta.ai/dapta-forms/getting-started/dashboard-tour.md): A tour of the Dapta Forms dashboard: the Home tiles and shortcuts, the left menu (Home, Forms, Submissions, Analytics, Integrations, Dapta Agents), the profile menu, the app switcher, the workspace sw - [Building Forms](https://docs.dapta.ai/dapta-forms/builder.md): A tour of the Dapta Forms editor: the topbar with the form name, save status, Build / Logic / Connect tabs, share buttons and Publish; the contextual toolbar; the question list; the live canvas and th - [Create a form](https://docs.dapta.ai/dapta-forms/builder/create-a-form.md): Create a new Dapta Form from the Forms page: name it, choose between the Slides and One page layouts, start from scratch or from a template, and duplicate or delete forms from the list. - [Question types](https://docs.dapta.ai/dapta-forms/builder/question-types.md): The 14 question types in Dapta Forms, grouped as Contact, Choice, Text and Content: how to add a question from the gallery, search it, and switch a question's type later. - [Contact fields: Name, Email, Phone](https://docs.dapta.ai/dapta-forms/builder/question-types/contact-fields.md): The three contact question types in Dapta Forms: Name (first and last name on one screen), Email (with Require work email) and Phone (country picker, minimum digits, international format). - [Choice fields: Single, Multiple, Dropdown](https://docs.dapta.ai/dapta-forms/builder/question-types/choice-fields.md): Single choice, Multiple choice and Dropdown questions in Dapta Forms: List vs Cards layouts, the Label / Value / Points / Icon option row, the emoji, letters and image icon picker, importing options f - [Text & scale fields: Short text, Long text, Website, Slider](https://docs.dapta.ai/dapta-forms/builder/question-types/text-and-slider-fields.md): The four free-form question types in Dapta Forms: Short text, Long text, Website and Slider. Learn how placeholders work, how the Website field validates and cleans up addresses, and how to set up a s - [Content steps: Message, Reveal screen, Scheduler](https://docs.dapta.ai/dapta-forms/builder/question-types/content-steps.md): The three content steps in Dapta Forms: Message (text with no input), Reveal screen (a short timed pause with a loader) and Scheduler (a Calendly booking embedded in the form). Every setting explained - [File upload](https://docs.dapta.ai/dapta-forms/builder/question-types/file-upload.md): Collect a document or an image with the File upload question: choose which file types you accept, set a size limit, and see exactly what respondents get when they attach a file or pick the wrong one. - [Question settings](https://docs.dapta.ai/dapta-forms/builder/question-settings.md): A tour of the Question settings pane in the Dapta Forms editor: Question type, Required, Placeholder, Default answer, Field key (and what renaming it changes), Hidden question, Ends the form, Show rev - [Dynamic questions (variants)](https://docs.dapta.ai/dapta-forms/builder/dynamic-questions.md): Ask a different question title depending on an earlier answer with Dynamic question variants in Dapta Forms: Vary the question by a field, Based on field, When answer is, Ask instead, Fallback and the - [Recall answers with @](https://docs.dapta.ai/dapta-forms/builder/recall-answers.md): Personalize your Dapta Form by inserting a previous answer into a later question title, helper text, reveal screen, outcome message or ending. Type @ or \[ to open the picker, and learn what the warnin - [Hidden fields & URL prefill](https://docs.dapta.ai/dapta-forms/builder/hidden-fields-and-url-prefill.md): Prefill any Dapta Forms question from the link with ?key=value, hide a question so it is filled only from the URL, copy the ready-made example from the Prefill from URL block, and understand precedenc - [Partial submissions (lead capture point)](https://docs.dapta.ai/dapta-forms/builder/partial-submissions.md): Capture leads before they finish your Dapta Form: add a Partial submit point to the question list, learn what it stores, how partials are upgraded when the respondent completes the form, and where to - [One-page layout](https://docs.dapta.ai/dapta-forms/builder/one-page-layout.md): Show every question of your Dapta Form on a single page with one Submit button: how to switch layouts, how logic, cover, reveal and validation behave on a one-page form, and which design settings do n - [Preview on desktop, tablet and mobile](https://docs.dapta.ai/dapta-forms/builder/preview.md): Preview your Dapta Form exactly as respondents will see it, in real mobile, tablet and desktop frames, without publishing or submitting anything. Walk through the screens, restart, and check unsaved e - [Autosave, drafts & publishing](https://docs.dapta.ai/dapta-forms/builder/autosave-and-publishing.md): How Dapta Forms saves your work: the save status pill, automatic retries, recovery of unsaved changes, and the difference between the draft you edit and the published form your respondents see. - [Logic, Scoring & Outcomes](https://docs.dapta.ai/dapta-forms/logic.md): The Logic tab of the Dapta Forms editor: the interactive Logic canvas, the read-only Logic map on small screens, and the form-wide Branching, Scoring and Outcomes dialogs that turn a plain form into a - [Show & hide conditions](https://docs.dapta.ai/dapta-forms/logic/conditions.md): Show or hide a question in Dapta Forms based on an earlier answer or the score so far: Show when and Hide when, the operators for each field type, the contradiction guard, the never-shows warnings and - [Branching & jumps](https://docs.dapta.ai/dapta-forms/logic/branching.md): Route respondents through a Dapta Form with branching rules: If answer is rules that jump to a later question or skip to the end, the Always go to catch-all, first-match-wins evaluation, forward-only - [Scoring](https://docs.dapta.ai/dapta-forms/logic/scoring.md): Turn a Dapta Form into a scored quiz or lead qualifier: enable scoring, give every option a point value (negative numbers allowed), award points from a slider by value range, switch scoring on or off - [Outcomes (results by score range)](https://docs.dapta.ai/dapta-forms/logic/outcomes.md): Show a different result to each respondent based on their score: add score ranges in the Outcomes dialog, write a thank-you message per range with \[field] tokens, redirect a range to a URL after a del - [Ending screen](https://docs.dapta.ai/dapta-forms/logic/ending-screen.md): Set what every respondent sees after they submit a Dapta Form: the thank-you heading and message (with \[field] tokens), an optional redirect URL, how long to show the thank-you before redirecting, and - [Reveal screens](https://docs.dapta.ai/dapta-forms/logic/reveal-screens.md): Add a reveal screen: the short animated pause that plays between steps or right before the result. Headline, subtitle, duration, loader styles and what the respondent sees. - [Design & Branding](https://docs.dapta.ai/dapta-forms/design.md): Make a Dapta Form look like your brand from the Design panel inside Build: themes, colors, fonts, logos, cover screen and share card, with a live device preview while you edit. - [Themes, colors & background](https://docs.dapta.ai/dapta-forms/design/themes-colors-background.md): Give your Dapta Form a color scheme: start from one of nine theme presets, set Background, Text and Accent with live contrast checks, and choose a Solid, Gradient, Glow or Image background with dimmin - [Typography & controls](https://docs.dapta.ai/dapta-forms/design/typography-and-controls.md): Choose the typeface of your Dapta Form (nine built-in fonts or your own .woff2 file) and shape its controls: corner radius, button style, full-width button and the progress indicator (Bar, Dots, Count - [Logos, layout & transitions](https://docs.dapta.ai/dapta-forms/design/logos-layout-transitions.md): Add a logo to your Dapta Form (form logo on every question, cover logo on the cover screen), set logo size and position, question alignment, content width and step transition, and give the form a publ - [Cover screen & banner](https://docs.dapta.ai/dapta-forms/design/cover-screen-and-banner.md): Add an intro screen to your Dapta Form: turn on the cover, write the eyebrow, headline, subheadline, Start button text and trust badge, and add a banner strip with its own color, height and scope. - [Client logos marquee](https://docs.dapta.ai/dapta-forms/design/client-logos.md): Show a "Trusted by" marquee of client logos on your Dapta Form cover, on the reveal screen, or on both. Add up to 24 logos with a name and an image URL. - [Share card (social preview image)](https://docs.dapta.ai/dapta-forms/design/share-card.md): Control the preview image that appears when your Dapta Form link is shared in chat or on social media: a 1200×630 card generated automatically from your design, or your own image URL. - [Brand kit (workspace-wide)](https://docs.dapta.ai/dapta-forms/design/brand-kit.md): Set your workspace look once in the Dapta Forms brand kit: logo, client logos, colors, typeface and controls. New forms start with it, and you can apply it to existing forms in bulk, with a per-form U - [Connect & Integrations](https://docs.dapta.ai/dapta-forms/connect.md): Send every Dapta Forms submission where your team works: HubSpot, your own webhook endpoint, analytics pixels and email notices. Learn the two surfaces (account-level Connections and the per-form Conn - [Connections (account level)](https://docs.dapta.ai/dapta-forms/connect/connections.md): Connect your Dapta Forms account to HubSpot and Calendly once from the Connections page, check who is connected, disconnect safely, and review the account-wide inventory of webhooks across all your fo - [HubSpot](https://docs.dapta.ai/dapta-forms/connect/hubspot.md): Send every Dapta Forms submission to HubSpot as a contact. Learn what the integration syncs, how contacts are matched by email address, what reaches HubSpot on a partial submission versus a completed - [Map questions to contact properties](https://docs.dapta.ai/dapta-forms/connect/hubspot/map-questions.md): Map each question of a Dapta Form to a HubSpot contact property: use the searchable property picker, let Auto-map fill the obvious matches, add extra keys such as UTMs and hidden fields with Custom fi - [Value maps & static properties](https://docs.dapta.ai/dapta-forms/connect/hubspot/value-maps-and-static-properties.md): Translate the answers a Dapta Form collects into the exact values your HubSpot picklists expect, and stamp fixed values such as an opt-in flag or a lifecycle stage on every completed submission. - [Form elements: UTMs, score, outcome, submitted date](https://docs.dapta.ai/dapta-forms/connect/hubspot/form-elements.md): Send the metadata Dapta Forms captures on its own to HubSpot: the five UTM parameters, the lead score, the outcome heading and the submitted date. Plus the switches for inferring the company from the - [Booking sync](https://docs.dapta.ai/dapta-forms/connect/hubspot/booking-sync.md): Stamp the booking facts on the HubSpot contact when someone books from a Scheduler step: a stage value, the day they booked, the time the meeting starts, and the details Calendly collected on the book - [How the sync works & troubleshooting](https://docs.dapta.ai/dapta-forms/connect/hubspot/how-sync-works.md): How Dapta Forms matches every submission to a HubSpot contact, the states that stop the sync before it starts (no email address, HubSpot not connected, a conflicting email mapping, a second HubSpot de - [Scheduler step & Calendly](https://docs.dapta.ai/dapta-forms/connect/scheduler-and-calendly.md): Let respondents book a meeting without leaving your form. Connect Calendly once, add a Scheduler step, pick an event type, autofill the booking form from earlier answers and decide what happens after - [Webhooks](https://docs.dapta.ai/dapta-forms/connect/webhooks.md): Send every Dapta Forms submission as a JSON POST to a URL you control. Set the endpoint, an optional signing secret, choose whether partial and complete submissions trigger it, send a test, and switch - [Payload & headers reference](https://docs.dapta.ai/dapta-forms/connect/webhooks/payload-reference.md): The exact JSON body and HTTP headers Dapta Forms sends to a webhook: form, submission, data and utm objects, the partial or complete phase, the x-forms-event, x-forms-delivery, x-forms-timestamp and X - [Verify the signature](https://docs.dapta.ai/dapta-forms/connect/webhooks/verify-signature.md): Prove that a webhook request really came from Dapta Forms: recompute the HMAC-SHA256 signature over the raw body with your signing secret and compare it to the X-Forms-Signature header in constant tim - [Test & delivery history](https://docs.dapta.ai/dapta-forms/connect/webhooks/test-and-history.md): Test a Dapta Forms webhook with Send test, understand each success and error message, and read the Webhook history dialog: Delivered, In progress, Failed and Skipped rows, attempt counts, and the What - [Tracking & pixels](https://docs.dapta.ai/dapta-forms/connect/tracking-and-pixels.md): Add Google Tag Manager, Meta Pixel, PostHog or the HubSpot tracking code to a form's public page, understand when each tag fires, and see how UTM parameters are captured with every submission. - [Submission emails](https://docs.dapta.ai/dapta-forms/connect/emails.md): The two emails a form sends when someone completes it: the new submission notice and the respondent confirmation. Follow the account template or write custom copy for one form, insert variables, previ - [Delivery, retries & history](https://docs.dapta.ai/dapta-forms/connect/delivery-and-retries.md): How Dapta Forms delivers submissions to webhooks, HubSpot and email without ever blocking a respondent: the queue, the retry schedule with backoff, what Delivered, In progress, Failed and Skipped mean - [Publish, Share & Embed](https://docs.dapta.ai/dapta-forms/share.md): Every way to get a published Dapta Form in front of people: the public link, an embed on your own website, and a page at your handle that lists your forms. - [Your public link](https://docs.dapta.ai/dapta-forms/share/public-link.md): Understand the public URL of a Dapta Form: what each part of /{account code}/{handle}/{slug} means, the three places you can copy it from, how the slug is built from the form name, and why old links k - [Embed on your website](https://docs.dapta.ai/dapta-forms/share/embed.md): Put a Dapta Form inside your own website. Copy the snippet from the Embed dialog, paste it into WordPress, Webflow or plain HTML, and let the form resize itself so there is never an inner scrollbar. - [Your public page](https://docs.dapta.ai/dapta-forms/share/public-page.md): Turn on the page at your handle: a single address that shows your name, a headline, a short about paragraph and a list of every form you have published. Off until you switch it on. - [Submissions & Analytics](https://docs.dapta.ai/dapta-forms/results.md): Where the answers to your Dapta Forms land. Read individual responses under Submissions, download them as a CSV, and measure views, completion and drop-off under Analytics. - [Submissions](https://docs.dapta.ai/dapta-forms/results/submissions.md): Read every response to a Dapta Form in one table: the Submitted, Status and Score columns plus one column per question, the All, Completed and Partial filters, pagination, deleting a row and exactly w - [Uploaded files](https://docs.dapta.ai/dapta-forms/results/uploaded-files.md): Open what people uploaded without leaving the response table: which file types preview inside Dapta Forms, which ones download straight away, and why every link is minted at the moment you click it. - [Export to CSV](https://docs.dapta.ai/dapta-forms/results/export-csv.md): Download the responses to a Dapta Form as a CSV file: how the export follows the filter you have on screen, the exact column list, the status values and the timestamp format. - [Analytics](https://docs.dapta.ai/dapta-forms/results/analytics.md): Measure a Dapta Form: pick a date range, read the Views, Starts, Submissions, Completion rate, Time to complete and Partial submits cards, follow the Trends chart and find the question people abandon - [Workspaces, Team & Account](https://docs.dapta.ai/dapta-forms/account.md): Everything that is not a form lives in Account settings, behind the profile button at the bottom of the left menu: Workspaces, Brand kit, Notifications and Public page. Your workspaces are the same wo - [Workspaces](https://docs.dapta.ai/dapta-forms/account/workspaces.md): Switch between workspaces from the left menu, create a new one, and use Account settings to open or manage any workspace you belong to: rename it, read its Workspace ID and understand the Current and - [Members & roles](https://docs.dapta.ai/dapta-forms/account/members-and-roles.md): Manage who works in a workspace: read the Members table, add someone as Member or Admin, change roles, deactivate or remove a person, and understand what Owner, Admin and Member are each allowed to do - [Invitations](https://docs.dapta.ai/dapta-forms/account/invitations.md): Follow up on people who were invited to a workspace but have not accepted yet: read the Invitations tab, resend an invitation, know what accepting actually means, and retract one you no longer want. - [Notification emails (account templates)](https://docs.dapta.ai/dapta-forms/account/notifications.md): Edit the two account-wide submission emails in Dapta Forms: the new submission notice and the respondent confirmation. Turn each one on or off, rewrite the subject and body, insert variables, check th - [Public page & identity](https://docs.dapta.ai/dapta-forms/account/public-page-and-identity.md): Turn on the public page at your Dapta Forms handle, write the headline and the about paragraph, and read the identity block that shows your name, email, handle, account code and vanity slug. - [Appearance](https://docs.dapta.ai/dapta-forms/account/appearance.md): Switch the Dapta Forms admin between Dark and Light from the toggle in the left menu, and see why the theme you work in never changes what your respondents see. - [What respondents see](https://docs.dapta.ai/dapta-forms/respondent-experience.md): What a respondent sees when they open your public form: Slides vs one page, the cover, progress styles, keyboard shortcuts, the Back button, validation errors, reveal screens, booking, the ending and - [Developers](https://docs.dapta.ai/dapta-forms/developers.md): Dapta Forms is open source under the MIT license and you can run it on your own servers. This section points at the repository and covers self-hosting, the public API and the environment settings that - [Self-hosting](https://docs.dapta.ai/dapta-forms/developers/self-hosting.md): Run your own copy of Dapta Forms: the two apps, the Docker images, PostgreSQL in production, the handful of settings that matter and what changes when you leave the hosted forms.dapta.ai. - [Public API & rate limits](https://docs.dapta.ai/dapta-forms/developers/public-api.md): The unauthenticated endpoints behind every public Dapta Form: fetch a published form, record a submission, a funnel event or a booking. Plus the OpenAPI document, the per IP rate limit and the 429 res - [Feature flags & environment](https://docs.dapta.ai/dapta-forms/developers/environment-flags.md): The environment settings a self-hosted Dapta Forms deployment can change that your users actually notice: demo form seeding, premium features, the Made with Dapta Forms badge, deployment wide tracking - [Security & Privacy](https://docs.dapta.ai/dapta-forms/security-and-privacy.md): What Dapta Forms stores with a submission and what it never collects, how integration credentials are protected, how webhooks are signed, how the public form is rate limited, who in your workspace can - [FAQ](https://docs.dapta.ai/dapta-forms/faq.md): Short answers to the questions people ask most about Dapta Forms: pricing, accounts, editing a live form, custom domains, QR codes, A/B tests, Google Sheets, file uploads, payments, Spanish forms, exp - [Troubleshooting](https://docs.dapta.ai/dapta-forms/troubleshooting.md): Symptom, cause and fix for the problems that come up most in Dapta Forms: changes that are not live, a missing HubSpot contact, a failed webhook, submission emails that never arrive, a scheduler that --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.dapta.ai/dapta-forms.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.