Sin añadir entornos de servidor
Hugo genera archivos y no recibe POST. Un endpoint externo evita añadir serverless solo para contacto.
integraciones · static site generator
Hugo has no server runtime: it compiles your whole site to static HTML at build time, so there's nothing running to receive a form submission. Point a plain <form> at your mailcontact endpoint instead and submissions land in your project's inbox, with a notification in Discord, Slack, email, or a webhook. No serverless function, no mail service, no Hugo module.
Guarda HTML en layouts/partials/contact-form.html y reutiliza con {{ partial "contact-form.html" . }} en páginas, layouts o shortcodes.
La salida son archivos para GitHub Pages, Cloudflare, Netlify o S3 con CDN; el formulario sigue funcionando.
configuración recomendada
Añade este HTML a tu sitio o utiliza el generador de formularios. Sustituye el enlace por el de tu formulario. El script alojado inserta la comprobación oculta, gestiona el envío y la verificación automática y conserva el borrador si hay errores. Tú controlas el HTML y el CSS. Los formularios Free muestran un enlace visible «Processed by mailcontact.app»; Pro y Plus no. Los avisos siguen el idioma del navegador; configura data-mailcontact-language="fr" en el formulario para forzar el francés.
<form action="https://mailcontact.app/api/forms/your-form-id" method="POST" data-mailcontact-form lang="es" data-mailcontact-language="es">
<input type="hidden" name="_language" value="es" />
<fieldset>
<legend>Contáctanos</legend>
<label>
Nombre (opcional)
<input name="name" type="text" autocomplete="name" maxlength="200" />
</label>
<label>
Correo electrónico
<input name="email" type="email" autocomplete="email" maxlength="320" required />
</label>
<label>
Mensaje
<textarea name="message" rows="5" maxlength="5000" required></textarea>
</label>
<noscript>
<div aria-hidden="true" style="position:absolute;left:-10000px;width:1px;height:1px;overflow:hidden;">
<label>Sitio web
<input name="company_website" type="text" tabindex="-1" autocomplete="off" />
</label>
</div>
</noscript>
<button type="submit">Enviar mensaje</button>
</fieldset>
<p data-contact-status role="status" aria-live="polite" aria-atomic="true"></p>
</form>
<script defer src="https://mailcontact.app/forms/v1.js" crossorigin="anonymous" referrerpolicy="no-referrer"></script>Para un componente con su propio controlador de envío, carga el mismo script y utiliza MailContact.prepare(form) y MailContact.send() en lugar del marcador automático. Consulta la referencia de interfaces personalizadas para carga, avisos y atribución de Free.
el código
Este ejemplo envía directamente a la API. Mantén el campo obligatorio company_website presente y vacío. Los envíos nativos abren JSON si tienen éxito o una página de verificación si hace falta. Los scripts sin verificación envían los mensajes sospechosos a Spam; el spam claro también se retiene sin alertas ni consumo de cuota. Una respuesta de éxito confirma recepción, incluida revisión, o el descarte silencioso de una trampa rellenada. Consulta protección contra spam para conocer todo el funcionamiento.
{{/* layouts/partials/contact-form.html */}}
<form action="https://mailcontact.app/api/forms/your-form-id" method="POST">
<label for="name">Name</label>
<input type="text" id="name" name="name" />
<label for="email">Email</label>
<input type="email" id="email" name="email" required />
<label for="message">Message</label>
<textarea id="message" name="message" required></textarea>
<button type="submit">Send</button>
<input name="company_website" type="text" tabindex="-1" autocomplete="off"
style="position:absolute;left:-10000px" aria-hidden="true" />
</form>cómo funciona
Una bandeja por proyecto. Dale el nombre del sitio y obtén endpoint y email al instante.
Guarda layouts/partials/contact-form.html y usa {{ partial "contact-form.html" . }} en página o layout. Aplica el CSS del tema.
Añade Discord, Slack, email o webhook. Los mensajes avisan donde ya estás.
por qué mailcontact
Hugo genera archivos y no recibe POST. Un endpoint externo evita añadir serverless solo para contacto.
Define contact-form.html una vez y reutiliza con {{ partial }}. Un cambio actualiza todas las páginas.
El formulario viaja con tu sitio a GitHub Pages, Cloudflare, Netlify o S3, sin funciones del alojamiento.
preguntas frecuentes
No. Hugo solo genera HTML estático. El formulario envía a mailcontact, que guarda y notifica. Nada se ejecuta en tu servidor.
Sí. Funciona donde sirvas Hugo, incluido GitHub Pages o un bucket de S3 sin formularios propios.
Por completo. mailcontact solo recibe el POST. La plantilla parcial es tuya y utiliza la hoja de estilos del tema. Añade clases, reorganiza los campos o intégralo en tu diseño.
Utiliza el script o MailContact.send() para envío, verificación y avisos (el endpoint devuelve JSON como {"ok": true}). No hay redirección configurable.
relacionado
Formularios y una dirección de email real, juntos, con avisos en tus herramientas. Empieza con una cuenta gratuita.
Crear formulario gratisSin tarjeta de crédito. Free incluye un proyecto y 50 mensajes de formulario al mes.