How to setup the Contact Form plugin

Learn how to embed the Crisp Contact Form plugin on your website.

The Contact Form plugin lets visitors contact you from a traditional form while still sending messages into your Crisp Inbox, where your team can reply and collaborate like on any other conversation.

Before you start

The Contact Form plugin is available for Crisp workspaces and can be embedded on a public contact page. It uses hCaptcha to help protect your inbox from automated spam. To configure it, open Crisp, then go to Plugins → Contact Form → Settings.

You will need:

Access to Crisp and your workspace plugins
Your Crisp Website ID
An hCaptcha account with a site key and secret
The domain where the form will be embedded

The Contact Form plugin is available for all Crisp plans, including Free workspaces.

Watch the video tutorial

What the Contact Form does

The Contact Form is designed for website contact pages. Visitors submit their email address and message from the form, and Crisp creates a conversation in your inbox so agents can reply from the same place they handle chat, email, and other channels.

Contact Form embedded on a website contact page

Embed the Contact Form

Add the following iframe on the page where the form should appear.

<iframe
    title="Contact Form"
    src="https://plugins.crisp.chat/urn:crisp.im:contact-form:0/contact/[WEBSITE_ID]"
    referrerpolicy="origin"
    sandbox="allow-forms allow-popups allow-scripts allow-same-origin"
    width="100%"
    height="600px"
    frameborder="0">
</iframe>

Replace [WEBSITE_ID] with your Crisp website identifier, available from Settings → Workspace Settings → Setup & Integrations. You can also add locale as an optional URL argument to force a display language, for example ?locale=en.

The referrerpolicy and sandbox attributes are important security settings. They limit what the embedded form can access and prevent full page URLs from being leaked to the iframe.

Configure security

Add hCaptcha credentials

The form requires hCaptcha credentials before visitors can submit it. In the Contact Form plugin settings, open Security, then add your hCaptcha site key and hCaptcha secret.

hCaptcha challenge shown before Contact Form submission

hCaptcha credentials in Contact Form security settings

Add allowed domains

Allowed domains protect your Contact Form against malicious embeds. Add the domains where the form is allowed to appear from the Security section of the plugin settings.

Allowed domains in Contact Form settings

Make sure your hCaptcha domain settings and your Contact Form allowed domains match the domain where the form is embedded.

Customize the form style

You can customize the Contact Form with a CSS file served from your own domain. Inspect the form with your browser developer tools, then add a stylesheet from the Customization section of the plugin settings.

<link rel="stylesheet" href="https://assets.acme.com/contact-form-custom.css" type="text/css" />

Replace the stylesheet URL with your own file before publishing.

Crisp keeps Contact Form CSS classes stable so you can customize the form without having to rewrite your stylesheet after minor updates.

Frequently Asked Questions

Still have questions which were not covered in this article? Here is a collection of the most frequently asked questions on this topic.

Where does the submitted data go?

The message is sent to your Crisp Inbox as a conversation. Your agents can reply from Crisp using the visitor details submitted in the form.

Do I need hCaptcha?

Yes. The Contact Form plugin requires hCaptcha credentials to reduce automated spam and allow submissions to be accepted.

Can I embed the form on several pages?

Yes, as long as the domains are allowed in the plugin settings and the iframe is added to each page where the form should appear.

Updated on: 03/05/2026

Was this article helpful?

Thank you!