Skip to content

Open source website builder and Webflow alternative. Webstudio is an advanced visual builder that connects to any headless CMS, supports all CSS properties, and can be hosted anywhere, including with us.

docs: Restore screenshots in the Form guide (#6592)

Oleg Isonen74af992644a5
diff --git a/apps/builder/e2e/tests/mcp-legacy-form-query.[shard-5].e2e.ts b/apps/builder/e2e/tests/mcp-legacy-form-query.[shard-5].e2e.ts
index 6b69411dfb..de6947f049 100644
--- a/apps/builder/e2e/tests/mcp-legacy-form-query.[shard-5].e2e.ts
+++ b/apps/builder/e2e/tests/mcp-legacy-form-query.[shard-5].e2e.ts
@@ -113,7 +113,7 @@ test("MCP-edited saved deprecated Webhook Form preserves single and repeated que
selector: "#legacy-query-form",
values: [{ name: "message", value: scenario.message }],
submitter: 'button[type="submit"]',
- timeout: 10_000,
+ timeout: 30_000,
},
});
expect(submission.ok).toBe(true);
diff --git a/docs/university/core-components/form.md b/docs/university/core-components/form.md
index 196d76e8ca..841bba83d0 100644
--- a/docs/university/core-components/form.md
+++ b/docs/university/core-components/form.md
@@ -34,10 +34,12 @@ Open Preview and submit with an email address you control to try it. These defau
Add fields inside the Form from **Components > Forms**. Each field needs a **Name**, which identifies its value when the form is submitted.
-<picture>
- <source media="(prefers-color-scheme: dark)" srcset="../../.gitbook/assets/form-components-dark.jpg">
- <img src="../../.gitbook/assets/form-components-light.jpg" alt="Forms section in the Components panel, with Form (Beta), Button, Input Label, Text Input, File Input, Text Area, Select, Radio, and Checkbox." width="232">
-</picture>
+<figure>
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="../../.gitbook/assets/form-components-dark.jpg">
+ <img src="../../.gitbook/assets/form-components-light.jpg" alt="Forms section in the Components panel, with Form (Beta), Button, Input Label, Text Input, File Input, Text Area, Select, Radio, and Checkbox.">
+ </picture>
+</figure>
For example, a field named `subject` becomes available in bindings as `formData.subject`. Its visible label can be different.
@@ -66,10 +68,12 @@ Select the Form and open **Settings > Properties & attributes > Action**:
- Drag actions to change their order.
- Remove an action to stop using it on this Form. The Resource itself remains available.
-<picture>
- <source media="(prefers-color-scheme: dark)" srcset="../../.gitbook/assets/form-actions-dark.jpg">
- <img src="../../.gitbook/assets/form-actions-light.jpg" alt="Form Action settings with the plus button, Email to owner and Email to visitor actions, and the Success redirect control below them." width="238">
-</picture>
+<figure>
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="../../.gitbook/assets/form-actions-dark.jpg">
+ <img src="../../.gitbook/assets/form-actions-light.jpg" alt="Form Action settings with the plus button, Email to owner and Email to visitor actions, and the Success redirect control below them.">
+ </picture>
+</figure>
If the list is empty, create a Resource in **Variables** first. You can select each Resource once.
@@ -112,10 +116,12 @@ See [Variables](../foundations/variables.md) for more about Resource settings an
Email Resources can notify your team, confirm receipt to a visitor, or send different messages to different recipients. The default Form includes two emails, but you can edit or remove either one.
-<picture>
- <source media="(prefers-color-scheme: dark)" srcset="../../.gitbook/assets/form-email-dark.jpg">
- <img src="../../.gitbook/assets/form-email-light.jpg" alt="Email to owner Resource configuration with project recipients, an empty Reply to field, bound Subject and Body fields, and Attach submitted files selected." width="320">
-</picture>
+<figure>
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="../../.gitbook/assets/form-email-dark.jpg">
+ <img src="../../.gitbook/assets/form-email-light.jpg" alt="Email to owner Resource configuration with project recipients, an empty Reply to field, bound Subject and Body fields, and Attach submitted files selected.">
+ </picture>
+</figure>
### Choose recipients
@@ -129,10 +135,12 @@ Use `Name <address>` to include a recipient’s name, such as `John <john@exampl
For a visitor confirmation, create the Email Resource on the Form. Its email input must have a fixed **Name** and a **Type** of `email` to appear in the field selector. The submitted value must contain one valid email address.
-<picture>
- <source media="(prefers-color-scheme: dark)" srcset="../../.gitbook/assets/form-visitor-dark.jpg">
- <img src="../../.gitbook/assets/form-visitor-light.jpg" alt="Email to visitor Resource with Visitor email field selected, the email input chosen, a confirmation message, and Do not attach files selected." width="320">
-</picture>
+<figure>
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="../../.gitbook/assets/form-visitor-dark.jpg">
+ <img src="../../.gitbook/assets/form-visitor-light.jpg" alt="Email to visitor Resource with Visitor email field selected, the email input chosen, a confirmation message, and Do not attach files selected.">
+ </picture>
+</figure>
### Set Reply to
@@ -257,10 +265,12 @@ Emails are not automatically resent when delivery is uncertain, to avoid duplica
The default Form provides these Variables on the Form and its children:
-<picture>
- <source media="(prefers-color-scheme: dark)" srcset="../../.gitbook/assets/form-variables-dark.jpg">
- <img src="../../.gitbook/assets/form-variables-light.jpg" alt="Form Variables list showing formData, browserInfo, Email to owner, Email to visitor, formState, results, errors, and system, with dynamic and static badges." width="238">
-</picture>
+<figure>
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="../../.gitbook/assets/form-variables-dark.jpg">
+ <img src="../../.gitbook/assets/form-variables-light.jpg" alt="Form Variables list showing formData, browserInfo, Email to owner, Email to visitor, formState, results, errors, and system, with dynamic and static badges.">
+ </picture>
+</figure>
| Variable | What it contains |
| ------------- | ------------------------------------------------------------------------------------------------ |
@@ -302,25 +312,25 @@ Once the Form works as expected, publish it to update the site. Later Builder ch
### Files and message sizes
-These limits apply to the whole request or message, not to each file separately.
+Limits count the whole request or message, not each file separately.
-| Limit | What it includes |
-| ------------------------------------------------ | --------------------------------------------------------------------------------------------- |
-| **25 MiB per Form submission** | All fields, files, and request encoding. |
-| **25 MiB per outbound HTTP Resource body** | The body sent to the API. The receiving API may have a lower limit. |
-| **32 attachments per email** | All files attached to that email. |
-| **7 MiB per email-service request** | Email text, encoded attachments, and request data. |
-| **5 MiB per complete email for most recipients** | The final email and attachments. Cloudflare allows 25 MiB for verified destination addresses. |
+| Limit | What it includes |
+| ----- | ---------------- |
+| **25 MiB per published Form submission** | The complete incoming multipart request: fields, files, and multipart encoding. |
+| **4.5 MB per Preview Form submission** | The complete request: fields, files, and multipart encoding. Leave room for fields and encoding when choosing file sizes. |
+| **25 MiB per outbound HTTP Resource body** | Webstudio's body-size check for a Form action. The destination or its network path may allow less. |
+| **32 attachments per email** | All files attached to that email. |
+| **7 MiB per email-service request** | The complete JSON request, including email text, attachment data encoded as Base64, and other fields. |
-Encoding increases file size. A file below the limit on disk can still exceed it once encoded and combined with the rest of the message.
+Multipart encoding adds bytes around each uploaded file and field. Base64 encoding makes attachments larger in the email-service request. Leave room for both when choosing file sizes.
-See [Cloudflare’s email limits](https://developers.cloudflare.com/email-service/platform/limits/).
+[Cloudflare's email limits](https://developers.cloudflare.com/email-service/platform/limits/) list 5 MiB for a complete email, or 25 MiB for verified destination addresses. Those are provider limits, not guaranteed Form allowances: Webstudio's 7 MiB JSON limit and the incoming Form limit can stop a submission first. The final email includes its own encoding and headers.
### Sending limits
Webstudio Cloud allows up to **five team-recipient deliveries per submission**, plus one visitor confirmation Resource. Duplicate addresses count as separate deliveries.
-An approximate limit of **50 recipient deliveries per project, per Cloudflare location, per minute** also applies. Preview and published sites have separate limits. Provider account limits may apply too.
+An approximate limit of **50 recipient deliveries per project, per Cloudflare location, per minute** also applies. This is not a guaranteed cutoff. Preview and published sites have separate limits. Provider account limits may apply too.
If an email fails, check its response for the reported reason. See [Cloudflare’s email error reference](https://developers.cloudflare.com/email-service/api/send-emails/workers-api/#error-codes).