Frequently Asked Questions

General Questions

How do I create a contact form in Statamic?

With Easy Forms, creating a contact form in Statamic takes just a few steps:

1. Install Easy Forms: composer require reachweb/statamic-easy-forms
2. Run the setup: php artisan easy-forms:install
3. Create a form in the Statamic Control Panel under Forms
4. Add fields to your form's blueprint (name, email, message, etc.)
5. In your Antlers template, add: {{ easyform handle="contact_form" }}

That's it! Your form is fully styled, accessible, and functional.

What's the best Statamic form addon?

Easy Forms is designed to be the fastest way to add professional forms to Statamic. It offers:

• 17+ field types with pre-built styling
• One-tag rendering - no custom templates needed
• WCAG 2.1 Level AA accessibility out of the box
• Built-in security (CSRF, honeypot, reCAPTCHA v3)
• Wizard mode for multi-step forms
• Real-time validation with Laravel Precognition

How do I add frontend forms to Statamic?

Easy Forms renders forms on the frontend using a single Antlers tag:

{{ easyform handle="your_form_handle" }}

This outputs a complete, styled form with all fields defined in your Statamic form blueprint. No need to write HTML markup or JavaScript.

Does Easy Forms work with Statamic's built-in forms?

Yes! Easy Forms uses Statamic's native form system. You create and manage forms in the Control Panel as usual - Easy Forms just provides a better way to render them on the frontend.

Technical Questions

What are the requirements for Easy Forms?

• Statamic 5.x and 6.x
• PHP 8.2 or higher
• Alpine.js 3.x with the Focus plugin
• Tailwind CSS v4 (recommended, but a standalone CSS file is available)

How do I style Easy Forms?

Easy Forms uses Tailwind CSS and provides a theme file (easy-forms-theme.css) that you can customize. For deeper changes, you can publish and edit the Blade templates directly.

Can I create multi-step wizard forms?

Yes! Add wizard="true" to your tag:

{{ easyform handle="application" wizard="true" precognition="true" }}

Each section in your form blueprint becomes a step in the wizard.

How do I add spam protection?

Easy Forms includes multiple anti-spam options:

1. Honeypot (built-in): Set a honeypot field name in your form config
2. reCAPTCHA v3: Add your Google reCAPTCHA keys to .env:

   RECAPTCHA_SITE_KEY=your_key
   RECAPTCHA_SECRET_KEY=your_secret

Does Easy Forms support file uploads?

Yes! Easy Forms supports both:

• Assets fieldtype: For uploads stored in Statamic asset containers
• Files fieldtype: For attachments sent directly via email

Can I use conditional fields?

Yes, Easy Forms fully supports Statamic's conditional field logic. Just add Statamic's helper script:

<script src="/vendor/statamic/frontend/js/helpers.js"></script>

How do I get real-time validation?

Enable Laravel Precognition for server-side validation as users fill out the form:

{{ easyform handle="contact" precognition="true" }}

This validates fields on blur and shows errors immediately.

Accessibility

Is Easy Forms accessible?

Yes! All Easy Forms components are WCAG 2.1 Level AA compliant, including:

• Proper label associations
• ARIA attributes
• Keyboard navigation
• Focus management
• Screen reader support

Does it work on mobile?

Yes, Easy Forms uses a responsive 12-column grid layout that works on all screen sizes.

Support

Where can I get help?

• Documentation: easy-forms.dev
• GitHub Issues: github.com/reachweb/statamic-easy-forms
• Live Demo: demo.easy-forms.dev

Where do I purchase a license?

Licenses are available on the Statamic Marketplace. Local development works without a license.