[Skip to content](#main)

[→](/)

[![Avunu](/brand/avunu-logo.svg)![Avunu](/brand/avunu-logo-light.svg)](/)[Services](/services/)[Consulting](/services/consulting/)[ERP](/services/erp/)[Odoo](/services/erp/odoo/)[ERPNext](/services/erp/erpnext/)[Custom software](/services/custom-software/)[Devices & IoT](/services/devices-iot/)[Websites](/services/websites/)[Infrastructure](/services/infrastructure/)[Partners](/partners/)

[Work](/work/)[Open source](/open-source/)[Knowledge base](/kb/)[About](/about/)

[About Avunu](/about/)[Team](/about/team/)[Insights](/insights/)[Contact](/contact/)

[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

- [Services](/services/)[Consulting](/services/consulting/)
- [ERP](/services/erp/)
- [Odoo](/services/erp/odoo/)
- [ERPNext](/services/erp/erpnext/)
- [Custom software](/services/custom-software/)
- [Devices & IoT](/services/devices-iot/)
- [Websites](/services/websites/)
- [Infrastructure](/services/infrastructure/)
- [Partners](/partners/)

[Work](/work/)[Open source](/open-source/)[Knowledge base](/kb/)[About](/about/)

- [About Avunu](/about/)
- [Team](/about/team/)
- [Insights](/insights/)
- [Contact](/contact/)

[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

[Knowledge base](/kb/)[Frappe](/kb/frappe/)Web Forms

Search the knowledge basePress/

ESC

Jump to

[Browse the knowledge base](/kb/)[Frappe](/kb/frappe/)[ERPNext](/kb/erpnext/)[Odoo](/kb/odoo/)[WordPress](/kb/wordpress/)[NixOS](/kb/nixos/)[Email](/kb/email/)[Linux](/kb/linux/)[Databases](/kb/databases/)[Containers](/kb/containers/)[Proxmox](/kb/proxmox/)[Git & Dev Tools](/kb/git-and-dev-tools/)

↵select↑↓navigateescclose

Search the knowledge base

[Skip to the article](#kb-article)[Frappe](/kb/frappe/)20 articles

- [Overview](/kb/frappe/)
- [Bench Operations](/kb/frappe/bench-operations/)
- [Builder Page Scripts](/kb/frappe/builder-page-scripts/)
- [Client-Side Recipes](/kb/frappe/client-side-recipes/)
- [Common Query Patterns](/kb/frappe/common-query-patterns/)
- [Custom Field Controllers](/kb/frappe/custom-field-controllers/)
- [Custom Pages](/kb/frappe/custom-pages/)
- [Custom Views](/kb/frappe/custom-views/)
- [Customizations API](/kb/frappe/customizations-api/)
- [Customizing Grid Columns for Child Tables](/kb/frappe/customizing-grid-columns-child-tables/)
- [Doctype States & Status Fields](/kb/frappe/doctype-states-status-fields/)
- [Grandchild Table Fields](/kb/frappe/grandchild-table-fields/)
- [Portal Views](/kb/frappe/portal-views/)
- [Project Structure & Hooks](/kb/frappe/project-structure-hooks/)
- [Query Builder & PyPika Extensions](/kb/frappe/query-builder-pypika/)
- [Quick Entry Forms](/kb/frappe/quick-entry-forms/)
- [Script Reports](/kb/frappe/script-reports/)
- [Testing on Live Databases](/kb/frappe/testing-live-databases/)
- [Type Annotations & Controller Overrides](/kb/frappe/type-annotations-controller-overrides/)
- [Vite & TypeScript Compilation](/kb/frappe/vite-typescript-compilation/)
- [Web Forms](/kb/frappe/web-forms/)

Other sections[ERPNext](/kb/erpnext/)[Odoo](/kb/odoo/)[WordPress](/kb/wordpress/)[NixOS](/kb/nixos/)[Email](/kb/email/)[Linux](/kb/linux/)[Databases](/kb/databases/)[Containers](/kb/containers/)[Proxmox](/kb/proxmox/)[Git & Dev Tools](/kb/git-and-dev-tools/)

In Frappe: 20 articles

[Overview](/kb/frappe/)[Bench Operations](/kb/frappe/bench-operations/)[Builder Page Scripts](/kb/frappe/builder-page-scripts/)[Client-Side Recipes](/kb/frappe/client-side-recipes/)[Common Query Patterns](/kb/frappe/common-query-patterns/)[Custom Field Controllers](/kb/frappe/custom-field-controllers/)[Custom Pages](/kb/frappe/custom-pages/)[Custom Views](/kb/frappe/custom-views/)[Customizations API](/kb/frappe/customizations-api/)[Customizing Grid Columns for Child Tables](/kb/frappe/customizing-grid-columns-child-tables/)[Doctype States & Status Fields](/kb/frappe/doctype-states-status-fields/)[Grandchild Table Fields](/kb/frappe/grandchild-table-fields/)[Portal Views](/kb/frappe/portal-views/)[Project Structure & Hooks](/kb/frappe/project-structure-hooks/)[Query Builder & PyPika Extensions](/kb/frappe/query-builder-pypika/)[Quick Entry Forms](/kb/frappe/quick-entry-forms/)[Script Reports](/kb/frappe/script-reports/)[Testing on Live Databases](/kb/frappe/testing-live-databases/)[Type Annotations & Controller Overrides](/kb/frappe/type-annotations-controller-overrides/)[Vite & TypeScript Compilation](/kb/frappe/vite-typescript-compilation/)[Web Forms](/kb/frappe/web-forms/)

Other sections[ERPNext](/kb/erpnext/)[Odoo](/kb/odoo/)[WordPress](/kb/wordpress/)[NixOS](/kb/nixos/)[Email](/kb/email/)[Linux](/kb/linux/)[Databases](/kb/databases/)[Containers](/kb/containers/)[Proxmox](/kb/proxmox/)[Git & Dev Tools](/kb/git-and-dev-tools/)

FrappeWeb Forms

Build public web forms with server-side context loading, client-side validation, kiosk-style auto-submit, and payments.

UpdatedOct 1, 2026

Tagsfrappeweb-formsjavascriptpythonwebsite

Reading time7 min

On this page[File Structure](#file-structure)[Web Form JSON Configuration](#web-form-json-configuration)[Server-Side Context Loading](#server-side-context-loading)[Key Context Properties](#key-context-properties)[Client-Side Logic](#client-side-logic)[Field Change Handlers](#field-change-handlers)[Immediate Validation Feedback](#immediate-validation-feedback)[Submit Validation](#submit-validation)[Field Property Manipulation](#field-property-manipulation)[Web Form API Reference](#web-form-api-reference)[Kiosk Forms with Auto-Submit](#kiosk-forms-with-auto-submit)[Lifecycle Hooks](#lifecycle-hooks)[Example: Time Clock Form](#example-time-clock-form)[Hidden Fields for Server-Side Use](#hidden-fields-for-server-side-use)[Payment Flow](#payment-flow)

Public-facing data entry forms with custom server-side context loading, client-side validation, field binding, and payment integration.

## File Structure

```text
mymodule/web_form/my_form/
├── my_form.json           # Web form definition (fields, payment config, routes)
├── my_form.py             # Server-side get_context() hook
├── my_form.js             # Client-side logic
└── block_form.json        # Custom Builder layout (optional)
```

## Web Form JSON Configuration

Key configuration fields in the JSON definition:

```
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">{</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#7EE787;--shiki-light:#116329">"doctype"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Web Form"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#7EE787;--shiki-light:#116329">"name"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"my-form"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#7EE787;--shiki-light:#116329">"doc_type"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Player Application"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#7EE787;--shiki-light:#116329">"route"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"my-form"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#7EE787;--shiki-light:#116329">"module"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"My Module"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#7EE787;--shiki-light:#116329">"is_standard"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">1</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#7EE787;--shiki-light:#116329">"published"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">1</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#7EE787;--shiki-light:#116329">"login_required"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">0</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#7EE787;--shiki-light:#116329">"allow_edit"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">0</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#7EE787;--shiki-light:#116329">"allow_delete"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">0</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#7EE787;--shiki-light:#116329">"allow_multiple"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">0</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#7EE787;--shiki-light:#116329">"button_label"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Submit & Pay"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#7EE787;--shiki-light:#116329">"success_message"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Thank you for your submission!"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#7EE787;--shiki-light:#116329">"breadcrumbs"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"[{</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">\"</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">label</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">\"</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">: </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">\"</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">Home</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">\"</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">, </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">\"</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">route</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">\"</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">:</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">\"</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">/</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">\"</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">},{</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">\"</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">label</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">\"</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">: </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">\"</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">Apply</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">\"</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">, </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">\"</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">route</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">\"</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">:</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">\"</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">apply</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">\"</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">}]"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#7EE787;--shiki-light:#116329">"accept_payment"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">1</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#7EE787;--shiki-light:#116329">"payment_gateway"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Stripe-Credit Card"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#7EE787;--shiki-light:#116329">"currency"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"USD"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#7EE787;--shiki-light:#116329">"amount_based_on_field"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">1</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#7EE787;--shiki-light:#116329">"amount_field"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"fee"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#7EE787;--shiki-light:#116329">"payer_email_based_on_field"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">1</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#7EE787;--shiki-light:#116329">"payer_email_field"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"email"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#7EE787;--shiki-light:#116329">"payer_name_based_on_field"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">1</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#7EE787;--shiki-light:#116329">"payer_name_field"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"name_full"</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">}</span>
```

| Property                                 | Purpose                                                 |
| ---------------------------------------- | ------------------------------------------------------- |
| `login_required`                         | `0` for public/guest access, `1` for authenticated only |
| `accept_payment`                         | Enable payment gateway integration                      |
| `amount_based_on_field`                  | Payment amount comes from a form field value            |
| `amount_field`                           | Which field contains the payment amount                 |
| `payer_email_field` / `payer_name_field` | Fields for payment gateway payer info                   |
| `allow_edit` / `allow_delete`            | Post-submission capabilities                            |
| `is_standard`                            | Part of the app (version controlled)                    |
| `show_list`                              | Show list view of submitted records                     |
| `apply_document_permissions`             | Respect doctype-level permissions                       |

## Server-Side Context Loading

The `get_context(context)` function runs before rendering and receives a mutable context dict:

```
<span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">import</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> frappe</span>
<span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">from</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> frappe.query_builder </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">import</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> DocType</span>
<span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">from</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> frappe.utils </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">import</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> format_date</span>

<span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">def</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">get_context</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(context):</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781"># 1. Custom template (optional)</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">if</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">not</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> frappe.form_dict.is_list:</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        context.template </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"templates/web_form/my_form.html"</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781"># 2. Business logic gating</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    current_season </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> get_current_season()</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    force </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> frappe.local.request.args.get(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"force"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">)</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">if</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">not</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> current_season.is_open() </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">and</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">not</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> force:</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        context.enrollment_closed </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">True</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        context.message </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"<strong>Enrollment is closed.</strong>"</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">return</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781"># 3. Dynamic introduction text</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    close_date </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> format_date(current_season.enrollment_close_date)</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    fee </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> frappe.format_value(current_season.fee, {</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"fieldtype"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Currency"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">})</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    context.introduction_text </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">f</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Entries due by </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">{</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">close_date</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">}</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">. Fee: </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">{</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">fee</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">}</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">."</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781"># 4. Pre-fill form fields</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    context.reference_doc[</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"fee"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">] </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> current_season.get_fee()</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    context.reference_doc[</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"season"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">] </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> current_season.name</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781"># 5. Sidebar for logged-in users</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">if</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> frappe.session.user </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">!=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Guest"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">:</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        context.show_sidebar </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">True</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        context.sidebar_items </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> frappe.get_all(</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Website Sidebar Item"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            </span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">filters</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">{</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"parent"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"My Portal"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">},</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            </span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">fields</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">[</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"title"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"route"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"group"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">],</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            </span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">order_by</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"idx"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        )</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781"># 6. Pre-fill from logged-in user's contact</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">if</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> frappe.session.user </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">==</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Guest"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">:</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">return</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    contact_name </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> frappe.db.exists(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Contact"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, {</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"user"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: frappe.session.user})</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">if</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">not</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> contact_name:</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">return</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    contact </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> frappe.get_doc(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Contact"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, contact_name)</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    context.reference_doc.update({</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"name_first"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: contact.first_name,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"name_last"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: contact.last_name,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"email"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: contact.email_id,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"phone"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: contact.mobile_no,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    })</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781"># 7. URL-parameter-driven pre-fill</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    player_name </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> frappe.local.request.args.get(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"player"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">)</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">if</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">not</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> player_name:</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">return</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781"># Verify authorization via QueryBuilder join</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    Contact </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> DocType(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Contact"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">)</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    Guardian </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> DocType(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Family Guardian"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">)</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    Player </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> DocType(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Player"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">)</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    is_authorized </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> (</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        frappe.qb.from_(Contact)</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        .join(Guardian).on(Guardian.guardian </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">==</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> Contact.name)</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        .join(Player).on(Player.family </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">==</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> Guardian.parent)</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        .select(Player.name)</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        .where(Contact.email_id </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">==</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> contact.email_id)</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        .where(Player.name </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">==</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> player_name)</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        .run()</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    )</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">if</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> is_authorized:</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        player </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> frappe.get_doc(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Player"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, player_name)</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        context.reference_doc.update({</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"player_first"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: player.first_name,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"player_last"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: player.last_name,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        })</span>
```

### Key Context Properties

| Property                    | Purpose                               |
| --------------------------- | ------------------------------------- |
| `context.reference_doc`     | Dict of initial form field values     |
| `context.introduction_text` | HTML shown above the form             |
| `context.template`          | Override the Jinja template           |
| `context.show_sidebar`      | Show/hide sidebar                     |
| `context.sidebar_items`     | Sidebar navigation items              |
| `context.enrollment_closed` | Custom flag for template conditionals |

## Client-Side Logic

### Field Change Handlers

```
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">frappe.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">ready</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">function</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> () {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// Auto-compute combined field from parts</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    frappe.web_form.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">on</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"first_name"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, (</span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">_field</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, </span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">value</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">) </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=></span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">let</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> first </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> value.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">trim</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">();</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">let</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> last </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> frappe.web_form.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">get_value</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"last_name"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">);</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">if</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> (first </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">&&</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> last) {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            frappe.web_form.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">set_value</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"full_name"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">`${</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">first</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">} ${</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">last</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">}`</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">);</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        }</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    });</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// Trim whitespace</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    frappe.web_form.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">on</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"first_name"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, (</span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">field</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, </span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">value</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">) </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=></span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">let</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> trimmed </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> value.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">trim</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">();</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">if</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> (value </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">!==</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> trimmed) {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            frappe.web_form.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">set_value</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"first_name"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, trimmed);</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        }</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    });</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">});</span>
```

### Immediate Validation Feedback

```
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">frappe.web_form.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">on</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"birthdate"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, (</span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">field</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, </span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">value</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">) </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=></span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">let</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> age </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> frappe.datetime.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">get_diff</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        frappe.datetime.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">get_today</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(), value</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    ) </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">/</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">365</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">;</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">if</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> (age </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">></span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">15</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">) {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        frappe.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">msgprint</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">__</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Sorry, players must be under 16."</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">));</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    }</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">if</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> (age </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E"><</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">6</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">) {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        frappe.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">msgprint</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">__</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Sorry, players must be over 5."</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">));</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    }</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">});</span>
```

### Submit Validation

```
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">frappe.web_form.events.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">on</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"after_load"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, () </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=></span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    frappe.web_form.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">validate</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> () </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=></span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">let</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> values </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> frappe.web_form.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">get_values</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">();</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">if</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> (</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">!</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">values.liability_release) {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            frappe.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">msgprint</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Please accept the liability release."</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">);</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">return</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">false</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">;</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        }</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">if</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> (values.birthdate) {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">let</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> age </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> frappe.datetime.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">get_diff</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">                frappe.datetime.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">get_today</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(), values.birthdate</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            ) </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">/</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">365</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">;</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">if</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> (age </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">></span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">15</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">||</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> age </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E"><</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">6</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">) </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">return</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">false</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">;</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        }</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">return</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">true</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">;</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    };</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">});</span>
```

### Field Property Manipulation

```
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">frappe.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">ready</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">function</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> () {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// Hide a field</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    frappe.web_form.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">set_df_property</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"computed_field"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"hidden"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">1</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">);</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// Custom page title</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">const</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">title</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> document.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">querySelector</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">".web-form-title h1"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">);</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">if</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> (title) title.textContent </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Custom Form Title"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">;</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">});</span>
```

### Web Form API Reference

| Method                                                    | Purpose                                        |
| --------------------------------------------------------- | ---------------------------------------------- |
| `frappe.web_form.on(fieldname, callback)`                 | Field change handler                           |
| `frappe.web_form.get_value(fieldname)`                    | Get field value                                |
| `frappe.web_form.set_value(fieldname, value)`             | Set field value                                |
| `frappe.web_form.get_values()`                            | Get all field values                           |
| `frappe.web_form.set_df_property(fieldname, prop, value)` | Set field property                             |
| `frappe.web_form.validate`                                | Custom validation function (return true/false) |
| `frappe.web_form.events.on("after_load", fn)`             | Hook into form lifecycle                       |

## Kiosk Forms with Auto-Submit

A web form can act as a single-purpose kiosk, such as a shared time clock where staff scan a badge and the form records an Employee Checkin with no further clicks. The pattern combines four client-side pieces: focus the first field on load, react to that field's change, save programmatically, and send the browser straight back to a fresh form.

### Lifecycle Hooks

Besides `frappe.web_form.on()` and `validate`, the web form object calls these optional functions if you assign them:

| Hook                         | When it runs                                               |
| ---------------------------- | ---------------------------------------------------------- |
| `frappe.web_form.after_load` | After the form is rendered and the client script has run   |
| `frappe.web_form.validate`   | At the start of `save()`; return `false` to block the save |
| `frappe.web_form.after_save` | After the server accepts the document                      |

Each also fires as an event, so `frappe.web_form.events.on("after_save", fn)` works too.

### Example: Time Clock Form

This script assumes a web form on Employee Checkin with the fields `employee`, `log_type` (Select: IN / OUT), `time`, and optional `manual_override`, `manual_override_date`, and `manual_override_time` fields for supervisors.

```
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">frappe.web_form.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">after_load</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> () </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=></span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// Put the cursor in the badge field so a scanner can type straight into it</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">$</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"input[data-fieldname='employee']"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">).</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">trigger</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"focus"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">);</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">render_log_type_buttons</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">();</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">};</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">frappe.web_form.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">on</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"employee"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, (</span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">field</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, </span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">value</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">) </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=></span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">if</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> (</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">!</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">value) </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">return</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">;</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// Optional: show the employee's last punch from a whitelisted method in your app</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    frappe</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        .</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">xcall</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"<APP_NAME>.api.get_last_checkin"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, { employee: value })</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        .</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">then</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">((</span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">last</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">) </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=></span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> last </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">&&</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> frappe.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">show_alert</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">__</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Last punch: {0}"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, [last])));</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">if</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> (frappe.web_form.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">get_value</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"manual_override"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">)) {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        frappe.web_form.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">set_value</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"time"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">`${</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">frappe</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">.</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">web_form</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">get_value</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"manual_override_date"</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">)</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">} ${</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">frappe</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">.</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">web_form</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">get_value</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"manual_override_time"</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">)</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">}`</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        );</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    } </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">else</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        frappe.web_form.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">set_value</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"time"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, frappe.datetime.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">now_datetime</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">());</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    }</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    frappe.web_form.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">save</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">();</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">});</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">frappe.web_form.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">after_save</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> () </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=></span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// Skip the success page and go straight back to a blank form</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    window.location.href </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"/<WEB_FORM_ROUTE>/new"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">;</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">};</span>

<span style="--shiki-dark:#8B949E;--shiki-light:#6E7781">// Replace the log type dropdown with large toggle buttons</span>
<span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">function</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">render_log_type_buttons</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">() {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">const</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">$select</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">$</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"select[data-fieldname='log_type']"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">);</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">const</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">$group</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">$</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">'<div class="log-type-buttons"></div>'</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">).</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">insertAfter</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">($select);</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    $select.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">hide</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">();</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    $select.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">find</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"option"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">).</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">each</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">function</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> (</span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">i</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">) {</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">const</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">value</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">$</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">).</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">val</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">();</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">if</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> (</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">!</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">value) </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">return</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">;</span>

<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">const</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">id</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">`log-type-${</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">value</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">}`</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">;</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">$</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"<input type='radio' name='log_type_choice' class='d-none'>"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">)</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            .</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">attr</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">({ id, value })</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            .</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">prop</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"checked"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, i </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">===</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">0</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">)</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            .</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">on</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"change"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, () </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=></span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> frappe.web_form.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">set_value</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"log_type"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, value))</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            .</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">appendTo</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">($group);</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">        </span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">$</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"<label class='btn btn-light btn-lg mr-4'>"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">)</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            .</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">attr</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"for"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, id)</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            .</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">text</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">__</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">(</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Clock {0}"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">, [</span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">this</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">.textContent.</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">toLowerCase</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">()]))</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">            .</span><span style="--shiki-dark:#D2A8FF;--shiki-light:#8250DF">appendTo</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">($group);</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    });</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">}</span>
```

Notes:

Read values with `get_value()` one field at a time. `get_values()` validates mandatory fields and shows a "Missing Values Required" message if any are empty, which is noisy on a kiosk.

Set the Select through `frappe.web_form.set_value()` rather than jQuery's `.val()`, so the form's model and dependent fields stay in sync.

The employee selects the log type before scanning, because the scan itself triggers the save.

Web forms in current Frappe open a blank form at `/<route>/new`. Older notes that redirect to `?new=1` predate this.

The **Success URL** setting on the Web Form also redirects after saving, but only after a five-second countdown. Use `after_save` when the redirect has to be immediate.

Warning

A kiosk form that creates Employee Checkins for any employee ID will accept anyone who can reach the URL. Keep `login_required` on and sign the kiosk in as a dedicated low-privilege user, or restrict the route at the proxy to the kiosk's network.

## Hidden Fields for Server-Side Use

Fields can be hidden from the user but populated by `get_context()`:

```
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">{</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#7EE787;--shiki-light:#116329">"fieldname"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"fee"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#7EE787;--shiki-light:#116329">"fieldtype"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"Currency"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#7EE787;--shiki-light:#116329">"hidden"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">1</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">,</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#7EE787;--shiki-light:#116329">"default"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">: </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"150"</span>
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">}</span>
```

The server sets the actual value dynamically:

```
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">context.reference_doc[</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"fee"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">] </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> current_season.get_fee()</span>
```

## Payment Flow

When `accept_payment: 1`, form submission redirects to the payment gateway:

User fills form and clicks "Submit & Pay"

Frappe creates the document (e.g., Player Application)

Frappe generates a payment URL using the configured gateway

User is redirected to complete payment

On success, the payment status is updated on the document

The payment amount, payer email, and payer name are extracted from form fields configured in the JSON definition.

Sources

- [docs.frappe.io/framework/user/en/guides/portal-development/web-forms](https://docs.frappe.io/framework/user/en/guides/portal-development/web-forms)
- [github.com/frappe/frappe/blob/version-15/frappe/public/js/frappe/web_form/web_form.js](https://github.com/frappe/frappe/blob/version-15/frappe/public/js/frappe/web_form/web_form.js)

Need help with Frappe?

Our notes can take you a long way, but sometimes you'd rather have someone who's done it before.

[ERPNext implementation](/services/erp/erpnext/)

[← PreviousVite & TypeScript Compilation](/kb/frappe/vite-typescript-compilation/)

CC0This article is in the public domain ([CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/)), code samples included. Use it however helps you.

On this page

- [File Structure](#file-structure)
- [Web Form JSON Configuration](#web-form-json-configuration)
- [Server-Side Context Loading](#server-side-context-loading)
- [Key Context Properties](#key-context-properties)
- [Client-Side Logic](#client-side-logic)
- [Field Change Handlers](#field-change-handlers)
- [Immediate Validation Feedback](#immediate-validation-feedback)
- [Submit Validation](#submit-validation)
- [Field Property Manipulation](#field-property-manipulation)
- [Web Form API Reference](#web-form-api-reference)
- [Kiosk Forms with Auto-Submit](#kiosk-forms-with-auto-submit)
- [Lifecycle Hooks](#lifecycle-hooks)
- [Example: Time Clock Form](#example-time-clock-form)
- [Hidden Fields for Server-Side Use](#hidden-fields-for-server-side-use)
- [Payment Flow](#payment-flow)

[Back to top↑](#top)

Services

- [ERP implementation](/services/erp/)
- [Odoo](/services/erp/odoo/)
- [ERPNext](/services/erp/erpnext/)
- [Custom software](/services/custom-software/)
- [Devices & IoT](/services/devices-iot/)
- [Websites](/services/websites/)
- [Infrastructure](/services/infrastructure/)

Resources

- [Our work](/work/)
- [Open source](/open-source/)
- [Knowledge base](/kb/)
- [Insights](/insights/)

Company

- [About](/about/)
- [Team](/about/team/)
- [Partners](/partners/)
- [Contact](/contact/)

Clients

- [Project portal](https://erp.avunu.net/projects)
- [Invoices](https://erp.avunu.net/)
- [Support](https://erp.avunu.net/)

[![Avunu](/brand/avunu-logo-light.svg)](/)[\<av-icon data-jx-static>\<svg viewBox="0 0 24 24" width="20" height="20" fill="currentColor" stroke="none" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false">\<path d="M20.400 20.500h-3.600v-5.600c0-1.300 0-3-1.800-3s-2.100 1.400-2.100 2.900v5.700H9.400V9h3.400v1.600c.5-.9 1.600-1.900 3.400-1.900 3.600 0 4.300 2.400 4.300 5.500v6.300zM5.300 7.400a2.100 2.100 0 1 1 0-4.100 2.100 2.100 0 0 1 0 4.100zm1.800 13.100H3.600V9h3.500v11.500zM22.200 0H1.800C.8 0 0 .8 0 1.700v20.600c0 .9.800 1.700 1.800 1.700h20.400c1 0 1.800-.8 1.800-1.700V1.700C24 .8 23.200 0 22.200 0z">\</path>\</svg>\</av-icon>](https://www.linkedin.com/company/avunu)[\<av-icon data-jx-static>\<svg viewBox="0 0 24 24" width="20" height="20" fill="currentColor" stroke="none" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false">\<path d="M12 .3a12 12 0 0 0-3.8 23.4c.6.1.8-.3.8-.6v-2c-3.3.7-4-1.6-4-1.6-.6-1.4-1.4-1.8-1.4-1.8-1-.7.1-.7.1-.7 1.2.1 1.8 1.2 1.8 1.2 1 1.8 2.8 1.3 3.5 1 .1-.8.4-1.3.7-1.6-2.7-.3-5.5-1.3-5.5-5.9 0-1.3.5-2.4 1.2-3.2-.1-.3-.5-1.5.1-3.2 0 0 1-.3 3.3 1.2a11.500 11.500 0 0 1 6 0c2.300-1.500 3.300-1.200 3.300-1.200.6 1.700.2 2.900.1 3.200.8.8 1.200 1.900 1.200 3.200 0 4.600-2.800 5.600-5.500 5.900.4.400.8 1.100.8 2.200v3.300c0 .3.2.7.8.6A12 12 0 0 0 12 .3">\</path>\</svg>\</av-icon>](https://github.com/Avunu)[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

Avunu LLC · 948 East Philadelphia Street, York, PA 17403 · (717) 814-8540Knowledge base articles are in the public domain[Privacy](/privacy/)[Terms](/terms/)
