> ## Documentation Index
> Fetch the complete documentation index at: https://thehyperstack.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Wix Forms Integration

> Issue a credential to everyone who submits a Wix Forms form on your Wix site, or only to those whose answer passes your rule.

The Wix integration connects your Wix site to your Hyperstack organization. With it you can:

* Map each Wix Forms form on your site to a credential group.
* Pick which fields give the name and the email on the credential.
* Add a rule, so only some submissions issue a credential. For example: **Did you watch the full safety video? is Yes**.
* See every submission on the **Logs** tab, with the credential it issued or the reason it issued nothing.

You add the Hyperstack app to your Wix site once. You don't copy an API key or a URL, you don't change your forms, and you don't need Zapier.

![The Wix extension page in Hyperstack Studio with the Connect button](https://mintcdn.com/hyperstack/On-UWfW8FM16sUhi/images/wix-overview.webp?fit=max\&auto=format\&n=On-UWfW8FM16sUhi\&q=85\&s=007b3f4025abac6b9a1877d50e061c43)

## Before you start

* **Hyperstack:** any plan. You must be an administrator of the organization.
* **Wix:** a Wix site with Wix Forms, and a Wix account that can add apps to that site (the site owner, or a collaborator with that right).
* At least one [credential group](https://thehyperstack.com/docs/tutorials/credential-setup/creating-credential-group.md) with its design, or let **Sync forms** create them for you.

One Wix site connects to one Hyperstack organization. Hyperstack sees every Wix Forms form on that site.

## Step 1: Connect Wix

**1. Open the Wix extension**

In the Studio, click **Add integration**, then **Wix**, then **Connect**. Wix opens in a new tab.

**2. Pick your site**

Sign in to Wix if it asks. In **Select Site**, click the site with your forms.

![Wix asks you to select the site to add Hyperstack to](https://mintcdn.com/hyperstack/On-UWfW8FM16sUhi/images/wix-select-site.webp?fit=max\&auto=format\&n=On-UWfW8FM16sUhi\&q=85\&s=9f8753d85064bab46183beb49f53e799)

**3. Add the Hyperstack app**

Wix shows **Adding Hyperstack will allow it to**: read form submissions, read site, business and email details, and view your forms. Click **Agree & Add**.

![Wix lists what the Hyperstack app asks for, with the Agree & Add button](https://mintcdn.com/hyperstack/On-UWfW8FM16sUhi/images/wix-consent.webp?fit=max\&auto=format\&n=On-UWfW8FM16sUhi\&q=85\&s=4d656ef28ce54ca0e155a341a9bee483)

**4. Open your forms**

Hyperstack opens on the **Wix forms** page. It lists every Wix Forms form on the site, and says **Connected to** with your site's name.

![The Wix forms page in Hyperstack, connected to the site, with one form](https://mintcdn.com/hyperstack/yKegQ7zBqH9JXxc_/images/wix-connected.webp?fit=max\&auto=format\&n=yKegQ7zBqH9JXxc_\&q=85\&s=6efd730d2580316f4db12f6745628fa2)

If the Wix page keeps loading after **Agree & Add**, your browser may have blocked the new tab. In your Wix site's dashboard, open **Apps → Manage Apps** and click **Go to Dashboard** next to **Hyperstack**. Hyperstack opens and the site connects.

Any Wix Forms form works: a form on a page of your site, or a standalone form with its own link.

![A Wix form with First name, Last name, Email and a Yes/No question](https://mintcdn.com/hyperstack/On-UWfW8FM16sUhi/images/wix-form-builder.webp?fit=max\&auto=format\&n=On-UWfW8FM16sUhi\&q=85\&s=ceca12f51c1e73026bd3f28371b8eaf5)

## Step 2: Map your forms to credential groups

* To map one form, click **Choose group** on its row, type to search, and pick a credential group.
* To map many forms at once, click **Sync forms**. Hyperstack creates a credential group for each form that is not mapped yet, named after the form, with the design you pick.

![The group picker open on a Wix form row](https://mintcdn.com/hyperstack/On-UWfW8FM16sUhi/images/wix-map-form.webp?fit=max\&auto=format\&n=On-UWfW8FM16sUhi\&q=85\&s=5c490addc41b22ab492f39caa4f8d35f)

## Step 3: Pick the name, the email and an optional rule

Each mapped form has a **Name and email** column. It says **Matched by label** until you pick. Then Hyperstack reads the form's **Email**, **First name** and **Last name** fields, the contact fields of Wix Forms.

To pick the fields yourself, click the button in the **Name and email** column.

![The Name, email and rule dialog with First name and Last name for the name, Email for the email, and a rule on a Yes/No question](https://mintcdn.com/hyperstack/On-UWfW8FM16sUhi/images/wix-name-email-rule.webp?fit=max\&auto=format\&n=On-UWfW8FM16sUhi\&q=85\&s=aeb34437490480c6582429b5c39a339c)

* **Name:** the field whose answer is the name on the credential.
* **Add to the name (optional):** a second field added after the first one, such as **Last name** after **First name**.
* **Email:** the field whose answer is the email address. Hyperstack sends the credential there.
* **Only issue when (optional):** pick a field, a comparison and a value.

| Comparison | Issues when the answer… |
| - | - |
| **is** | is the value (capital letters don't matter) |
| **is not** | is not the value |
| **contains** | has the value anywhere in it |
| **is at least** | is a number equal to or higher than the value |
| **is at most** | is a number equal to or lower than the value |

For a choice field, Hyperstack compares the option's value, which is the option's text unless you changed it in Wix. A checkbox answers **yes** or **no**.

Click **Save**. The column shows what you picked, for example **First name + Last name · Email** and **Only if Did you watch the full safety video? is Yes**.

> [!TIP]
>
> Wix Forms has no quiz score of its own. To issue only to people who pass, ask a question whose answer shows it, and add a rule on that question.

## Step 4: Turn on auto-issue

Click **Turn on** under **Auto-issue on form submission**.

![Auto-issue on form submission is On, with the form mapped and its rule](https://mintcdn.com/hyperstack/yKegQ7zBqH9JXxc_/images/wix-auto-issue.webp?fit=max\&auto=format\&n=yKegQ7zBqH9JXxc_\&q=85\&s=b1e1601e4f920192e1e65df2551fe586)

Nothing changes in your forms in Wix: the Hyperstack app sends each submission to Hyperstack. Now, when someone submits a mapped form, they get that group's credential. Hyperstack issues and publishes it at once, and sends the email if the group sends one.

![Someone fills in the Wix form: name, email and Yes for the safety video question](https://mintcdn.com/hyperstack/On-UWfW8FM16sUhi/images/wix-form.webp?fit=max\&auto=format\&n=On-UWfW8FM16sUhi\&q=85\&s=cbad65551deb8e904359ae98421c324c)

## Check what happened: the Logs tab

The **Logs** tab lists every submission of your mapped forms, for 90 days.

![The Logs tab: one submission issued, one skipped by the rule](https://mintcdn.com/hyperstack/On-UWfW8FM16sUhi/images/wix-logs.webp?fit=max\&auto=format\&n=On-UWfW8FM16sUhi\&q=85\&s=c13fb74e7e1cf65d5c4b29016e3d572b)

* **Issued:** a credential was created. Its ID shows in the **Credentials** column.
* **Skipped:** nothing was issued, and the line says why. For example: the rule wasn't met, the email answer isn't an email address, or the person already has a credential in that group.
* **Failed:** something went wrong while Hyperstack issued the credential. Contact us.

Click a row to see the full submission that Wix sent.

![One log entry: the rule wasn't met, with the submission that Wix sent](https://mintcdn.com/hyperstack/On-UWfW8FM16sUhi/images/wix-log-entry.webp?fit=max\&auto=format\&n=On-UWfW8FM16sUhi\&q=85\&s=424e80cb6f6900d372c636c7421a5d8e)

## Good to know

* **One credential per email per group.** If a person submits the form again, nothing new is issued.
* **Payments:** a form that takes a payment issues nothing while its payment is still waiting.
* **What Hyperstack keeps:** the site's app ID, a short-lived access token and the site's name. A credential keeps only the form, the submission ID and the time. Hyperstack doesn't copy the form answers into the credential.
* **Security:** Wix signs every submission it sends. Hyperstack refuses a call that Wix didn't sign.
* **Turn off auto-issue** to stop issuing but keep your mappings.
* **Open App** on the Hyperstack app in your Wix dashboard opens the Wix page in the Studio.

## Disconnect Wix

Click the **⋯** button at the top right of the Wix page, then **Disconnect Wix**. Hyperstack deletes your mappings. Credentials you already issued stay as they are.

![The Disconnect Wix dialog](https://mintcdn.com/hyperstack/On-UWfW8FM16sUhi/images/wix-disconnect.webp?fit=max\&auto=format\&n=On-UWfW8FM16sUhi\&q=85\&s=86b9adacf3e8c871b282618bae8982b4)

Then remove the Hyperstack app from your site in Wix too: in your site's dashboard, open **Apps → Manage Apps**, and remove **Hyperstack**. If you remove the app in Wix first, Hyperstack disconnects by itself.

## Troubleshooting

| What you see | What to do |
| - | - |
| **Wix didn't connect** | Click **Connect** again. If the app is already on your site, Wix opens it and the site connects. |
| The Wix page keeps loading after **Agree & Add** | In your site's dashboard, open **Apps → Manage Apps** and click **Go to Dashboard** next to **Hyperstack**. |
| **This Wix site is already connected to another Hyperstack organization** | One Wix site connects to one organization. Disconnect it in the other organization first, or pick another site. |
| **This organization is connected to another Wix site** | Disconnect Wix on this page first, then connect the other site. |
| **Wix can't be connected right now** | Contact us. |
| **Your Wix connection expired** | The Hyperstack app was removed from your site. Click **Reconnect** to add it again. |
| A submission is **Skipped**: "no email answer" or "no name answer" | Pick the fields in the **Name and email** column. |
| A submission is **Skipped**: "is not an email address" | The field picked for the email got another answer. Pick the right field. |
| A submission is **Skipped**: "The rule wasn't met" | The answer didn't pass the rule. Check the rule in the **Name and email** column. |
| A submission is **Skipped**: "Auto-issue is off" | Turn on auto-issue. |

Questions or problems: [support@thehyperstack.com](mailto:support@thehyperstack.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.