# About S:Contact Form Builder

Wondering why you need a contact form on your website? Why not just publish an email address instead?

A contact form makes your store more interactive and useful. And a contact form will be very helpful to help you grow your business. The customers can use it to reach out to you for any query they have and you can revert back quickly.

With the S:Contact Form Builder app you can easily create a beautiful & professional contact us, contact form.

## Highlight Features

#### 1. Fully customize Form Builder

Build contact form/popup contact form/contact us form with great customization of form fields, form styles, response email settings, etc.

#### 2. Manage & Export Submissions

Help you easily to view submission history, report or export submissions to excel.

#### 3. Email Service Integrations

Contact form builder integrate with Mailchimp, Klaviyo, Campaign Monitor, GetResponse, Omnisend, Google Sheets, Active Campaign, HubSpot,...

<details>

<summary>Add app: <a href="https://apps.shopify.com/storeify-contact-form-builder">https://apps.shopify.com/storeify-contact-form-builder</a></summary>

</details>

## **Key features of  S:Contact Form Builder**

* Active Form: with only one click, the store admin can activate or deactivate the contact form.
* Build unlimited forms
* Display the form anywhere as an embedded form or a popup form
* Duplicate form: very useful when you need to create another similar form
* Conditional logic form: customize the form according to the logical conditions
* Allow splitting into multiple steps for forms with multiple fields
* Display information box on the contact form
* Integrate form with Shopify to create customer registration form

### **Contact Form Dashboard**

* Store owner can track submission history (daily, weekly, monthly & total submissions)
* Store owner can export submission data to Excel
* Store owner can view Recently Submissions

#### **Form Fields**

* Allow adding form title, form description
* Allow adding multiple custom fields to the contact form (textbox, text-area, checkbox, dropdown, radio button, date-time filed, subscribe newsletter, etc)
* Allow adding Department field: customer can send email to any department.
* Drag and Drop change to sort order fields
* Allow uploading attachment file
* Allow customizing thank you message
* Add tracking code
* Google ReCaptcha

#### **Form Styles**

* Allow changing form style: background, text color, font size, border, etc.
* Allow uploading your background image
* Allow changing fields style: field label, field border, field icon, color, field transparent, etc
* Allow previewing the form in the backend

#### **Email Settings**

* Email service integration: Mailchimp, Klaviyo, Campaign Monitor, GetResponse, Omnisend, Google Sheets, Active Campaign, HubSpot, Sendinblue.
* Allow adding multiple email receivers, CC & BCC
* Allow editing email subject with custom fields
* Allow choosing a custom field to insert into email content
* Redirect the customer to the thank you page after submission
* Custom SMTP

#### **Popup Widget**

* Allow changing the contact form widget style: background, text color, font size
* Allow showing the contact form widget button at 4 positions: center left, center right, bottom left, bottom right
* Allow showing and choosing the widget icon
* Allow showing or hiding the contact form widget on mobile

### **Other features of S: Contact Form Builder**

* User-friendly Contact Form for both customers and store owners
* Customizable contact form without coding
* Fully responsive design

<details>

<summary>Add app: <a href="https://apps.shopify.com/storeify-contact-form-builder">https://apps.shopify.com/storeify-contact-form-builder</a></summary>

</details>


# Pricing Plans

## All available plans

<figure><img src="/files/kUsj2mnFiFDnk2WE2Roa" alt=""><figcaption></figcaption></figure>


# Install app

Directly go to this link: [S: Contact Form - Contact Us](https://apps.shopify.com/storeify-contact-form-builder) to install the app.

<figure><img src="/files/GPVCGJtki7EnvC9VRQuw" alt=""><figcaption></figcaption></figure>

After adding the app to the store is complete, you need to embed the app in the theme:

Go to **Integrate Theme**  from the left sidebar -> Select the theme you want to apply -> Click the "Go to Theme Editor **> App Embeds**" ->  Click the **Save** button in the upper right corner.

<figure><img src="/files/u8JmfYeuXjLP49Zo2BQA" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/ZQTEs30Mxs7SIc4brasR" alt=""><figcaption></figcaption></figure>

If you want to preview the application on an unpublished theme, then follow the same steps as above.


# Enable App & Disable App

## Enable **App**

From the app admin, click the **Integrate Theme** on the left sidebar -> Select the theme -> Click the "Go to Theme Editor **> App Embeds**" button -> Enable the app by swiping the button to turn blue -> Click the **Save** button

<figure><img src="/files/u8JmfYeuXjLP49Zo2BQA" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/ZQTEs30Mxs7SIc4brasR" alt=""><figcaption></figcaption></figure>

## Disable **App**

From the app admin, click the **Integrate Theme** on the left sidebar -> Select the theme -> Click the "Go to Theme Editor **> App Embeds**" button -> Enable the app by swiping the button to turn gray -> Click the **Save** button


# Create and manage form

## 1. **Enable Form**

From the app admin, go to the **Manage Forms** from the left sidebar, then edit the Contact Form was been generated automatically by our app.

<figure><img src="/files/hCO33dvzK06naqgL2tkO" alt=""><figcaption></figcaption></figure>

Basically, you only need to enable the form in the **Active Form** tab, then click the **Save** button.

<figure><img src="/files/L4EyxUpLqlK2sVnfQmea" alt=""><figcaption></figcaption></figure>

Now, let open your frontend and you can see the widget on the right bottom. Click it to open our popup contact form.

The contact form works with default setting and use the store owner email to receive email submissions.

![](/files/-Mbo6UX4Kst1up4uQ7bR)

## 2. Embed Form

To embed the form in any page/post you want, you need to get the embed code as HTML code or Short-code of the form.

In the Active form tab, you need to select **Embed Form**, then get the embed code (HTML/Short-code) to embed where you want to place the form.

<figure><img src="/files/8guw4zXHiqWMhYWU6o7M" alt=""><figcaption></figcaption></figure>

**For example to embed a form on a page you follow these steps:**

* Select **Pages** in the **Online Store**.
* Select the page you want to add the form.
* Finally, insert the form's code to the content (If you insert HTML code then you need to click on "**<>**" icon).

![](/files/-MiKQ0B3YtsMos0TxAyO)

## 3. Add form on Online Store 2.0

The application supports adding form to the store in an intuitive way compatible with Online Store 2.0.

<figure><img src="/files/FgKNTC96fP2HLYVqeuKK" alt=""><figcaption></figcaption></figure>

## 4. Manage Form

Now, you can customize your form styles, add new fields or change email settings, etc.

### 4.1 Form Fields

In the Form Fields tab, you can set the content for your form by adding title, description, and fields to the form.

<figure><img src="/files/Rpozw3ZxfPJYtqC4gPE9" alt=""><figcaption></figcaption></figure>

#### Add validations to the field

To do this, go to **Edit** field -> **Validations**

At this tab, you can set required field or add other required attributes such as: url, date, number, min, max, text length, etc.

<figure><img src="/files/Ys6TkopcHtYB2mFCm4ll" alt=""><figcaption></figcaption></figure>

#### Conditional Logic

If you want to set the display conditions of the field, go to **Edit** field -> **Conditional Logic**

<figure><img src="/files/gQXVdEHxx5GvaSkkTi6g" alt=""><figcaption></figcaption></figure>

#### Add checkbox to agree to add to email list ( Subscribe newsletter)

In case you don't want to add customers to your email list automatically, add the **Agree to add to the subscribe email list** field to your form. If your customer clicks the checkbox, their information will be saved to the email list and vice versa.

<figure><img src="/files/lW2neKh2Mh6drjEcvKhf" alt=""><figcaption></figcaption></figure>

Once done, you will have the result as shown below.

![](/files/G7Ik7JaXElYzCLHLNRXw)

#### Enable Google reCaptcha

You can enable Google reCaptcha for your form to prevent unwanted content spam.

To enable, go to **Manage Forms** -> **Edit form** -> **Form fields** -> Scroll down to the Other Fields section -> Tick ​ the **Enable reCaptcha** checkbox, then fill in the Site Key and Secret Key (generated from your Google reCaptcha account).

**Please note**: the app is only compatible with Google reCaptcha V3 (this is also the version recommended by Shopify)

<figure><img src="/files/k15ZCi6J9f9DrEAYv27l" alt=""><figcaption></figcaption></figure>

#### Add tracking code

You can use the tracking code to add to each form to track the conversion of the form.

Please go to **Manage Forms** -> **Edit Form** -> **Form fields** -> Scroll down to the bottom. -> **Add tracking code**

<figure><img src="/files/lqLORtkvWObEXaNjxbHj" alt=""><figcaption></figcaption></figure>

### 4.2 Form Styles

In this tab, you can customize everything related to the form's interface.

If you are a developer, you can also customize the form's interface in an advanced way through CSS code (the Custom CSS box at the bottom).

<figure><img src="/files/Vp0cQxaY4CzoHRFC1RN5" alt=""><figcaption></figcaption></figure>

### 4.3 Email Settings

<figure><img src="/files/aqP9F96WYBXT2q9p09Aa" alt=""><figcaption></figcaption></figure>

At this tab, you need to pay attention to completely and correctly fill in the required information fields so that sending and receiving emails after the customer submits the form goes smoothly.

* **To, CC, BCC:**  This is the field for you to set up the email addresses to be notified when the form is submitted
* **Select field with submitters email address**: the email to be filled in the form (*Selecting the form's email field is required*).
* **Select field with submitters name**: the name to be filled in the form.\
  These 2 fields are used to email the response to the form submitter.
* **Email Content**: The email content is sent to the store admin, you can add form fields to this body using the select-box above the content box.  ***Please note:** the short-codes available in this box are just sample data, they vary depending on the store, so you need to use the select-box right above to re-select the value fields you want to add to the email content*.

**Auto Response to submitter (Auto response)**: The email content is automatically sent to the person who just submitted the form. This feature is only available on paid plans.

<figure><img src="/files/FNhbqSL0lrCLWsrAiILj" alt=""><figcaption></figcaption></figure>

### 4.4 Info Box

<figure><img src="/files/B4JPmWB7cR1o6vV7XZqd" alt=""><figcaption></figcaption></figure>

#### Add Google Map to Info Box

To do this you need to add the Google maps embed code to the **Custom HTML** box at the bottom.

<figure><img src="/files/ouj7ihiYCSfH0Xzg73m3" alt=""><figcaption></figcaption></figure>

To get the Google Maps embed code, go to the website: <https://www.embedmymap.com/>

### 4.5 Popup Widget

In this tab, you can customize the style, position of the widget and can even disable/enable the widget on mobile devices.

<figure><img src="/files/utrERp9l6RWEZGnQRKct" alt=""><figcaption></figcaption></figure>

### 4.6 Multi-Step

You can split steps for forms with multiple fields.

<figure><img src="/files/aaVuAOEVnuXe7LfVVd5n" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/UO8Egz49QFhPIsoDXr5k" alt=""><figcaption></figcaption></figure>

Multi-step form example

![](/files/-McSNg7oL6WiT_u9DFFc)

### 4.7 Email Integrations

When you click on each email service, you'll see instructions for integration.

<figure><img src="/files/LDLVhnXLcn9Fi7bHmVud" alt=""><figcaption></figcaption></figure>

### Create a new customer account with form

The app integrates form with Shopify to create new customer account. You need to enable this feature in the **Email Integrations** tab.

<figure><img src="/files/FZaKKd1bOGcSw13TBKPZ" alt=""><figcaption></figcaption></figure>

With this feature enabled, after the customer clicks the Submit button, an email will be sent to the customer for them to activate account.

![](/files/8Hkep0GcNUgCJS4lpeoK)

After the customer clicks the Active your account button, their new customer account will be created.

![](/files/7fR5Equq2aYNLMCc6eEC)


# Submissions

Here you can see detailed statistics of customer submissions for each form and delete the submissions.

<figure><img src="/files/XW2pqS53XPoyMF89n4Vu" alt=""><figcaption></figcaption></figure>


# SMTP

In the backend app, go to **SMTP** in the left menu.

At this menu, you can configure your own email server service. In some cases, when you use the application's email server, emails sent to you or your customers may end up in the spam box. To prevent this, you should use your own email server and see the provider's parameters to fill in this section.

## 1. Use SMTP authenticate

We will guide you to set up SMTP with Gmail (if you use another email service, the setup is similar, just the parameters, you can get these parameters from the email service provider or search on Google).

**Important:** To create an app password, you need 2-Step Verification on your Google Account.

If you use 2-Step-Verification and get a "password incorrect" error when you sign in, you can try to use an app password.

1. Go to your [Google Account](https://myaccount.google.com/).
2. Select **Security**
3. Under "Signing in to Google," select **2-Step Verification**.
4. At the bottom of the page, select **App passwords**.
5. Enter a name that helps you remember where you’ll use the app password.
6. Select **Generate**.
7. To enter the app password, follow the instructions on your screen. The app password is the 16-character code that generates on your device.
8. Select **Done**.

**Final**: Go to our contact form app admin -> SMTP and put your Gmail information

<figure><img src="/files/5eShEKH9Ea4QQX6FG5bu" alt=""><figcaption></figcaption></figure>

**Note**: *You must receive a success message when you click the Test connection button for the configuration to be considered successful*.

## 2. Use OAuth 2.0 <a href="#id-2.-use-oauth-2.0-applies-only-to-google-oauth-and-microsoft-office365-oauth" id="id-2.-use-oauth-2.0-applies-only-to-google-oauth-and-microsoft-office365-oauth"></a>

This guide covers how to configure SMTP with OAuth 2.0 for three email providers: **Google (Gmail)**, **Microsoft Personal (Outlook.com / Hotmail)**, and **Microsoft 365 Business**.

### **Prerequisites**

* In your app's SMTP settings, set **Authentication method** to **OAuth 2.0**.
* Note down your app's **Redirect URI** (shown in the app settings page) — you will need it when registering your OAuth app. It looks like: <https://cf.storeify.app/oauth/callback> (<mark style="color:$danger;">**IMPORTANT**</mark>)<br>

***

### **1. Google (Gmail)**

#### **Step 1 — Create a Google Cloud Project**

1. Go to Google Cloud Console.
2. Click the project dropdown at the top → **New Project**.
3. Enter a project name (e.g., "SMTP OAuth") → **Create**.
4. Make sure the new project is selected.

#### **Step 2 — Enable the Gmail API**

1. Go to **APIs & Services** → **Library**.
2. Search for **Gmail API** → click it → **Enable**.

#### **Step 3 — Configure OAuth Consent Screen**

1. Go to **APIs & Services** → **OAuth consent screen**.
2. Choose **External** → **Create**.
3. Fill in the required fields:
   * **App name**: any name (e.g., "SMTP OAuth")
   * **User support email**: your email
   * **Developer contact email**: your email
4. Click **Save and Continue** through the remaining steps.
5. Under **Test users**, add the Gmail address you plan to use for sending emails.

#### **Step 4 — Create OAuth 2.0 Credentials**

1. Go to **APIs & Services** → **Credentials**.
2. Click **+ CREATE CREDENTIALS** → **OAuth client ID**.
3. **Application type**: select **Web application**.
4. **Name**: any name.
5. Under **Authorized redirect URIs**, click **+ ADD URI** and paste your app's redirect URI: <https://cf.storeify.app/oauth/callback> (<mark style="color:$danger;">**IMPORTANT**</mark>)
6. Click **Create**.
7. Copy the **Client ID** and **Client Secret**.

#### **Step 5 — Configure in App**

1. Select provider: **Google**.
2. Paste the **Client ID** and **Client Secret**.
3. Enter the **Email** address (must be the same Gmail you added as a test user).
4. Click **Save**, then click **Connect with your email above**.
5. Sign in with the same Gmail account and grant permission.

> <mark style="color:$warning;">**Note**</mark>**:** While the app is in "Testing" status in Google Cloud, the OAuth token expires every 7 days and users have to reconnect. To avoid this, submit the app for verification in Google Cloud Console → OAuth consent screen → **Publish App**.

***

### **2. Microsoft Personal (Outlook.com / Hotmail)**

Use this option if you want to send emails from a **personal** Microsoft account (e.g., `yourname@outlook.com`, `yourname@hotmail.com`, `yourname@live.com`).

#### **Step 1 — Register an App in Azure**

1. Go to Azure Portal — App registrations.
2. Click **+ New registration**.
3. Fill in:
   * **Name**: any name (e.g., "SMTP OAuth")
   * **Supported account types**: select **Personal Microsoft accounts only**
   * **Redirect URI**: select **Web**, then paste your redirect URI: <https://cf.storeify.app/oauth/callback> (<mark style="color:$danger;">**IMPORTANT**</mark>)
4. Click **Register**.
5. On the app's **Overview** page, copy the **Application (client) ID**.

#### **Step 2 — Create a Client Secret**

1. Go to **Certificates & secrets** → **Client secrets** tab.
2. Click **+ New client secret**.
3. Enter a description and select an expiry period.
4. Click **Add**.
5. **Immediately** copy the **Value** (this is your Client Secret — it will not be shown again).

#### **Step 3 — Configure API Permissions**

1. Go to **API permissions**.
2. Click **+ Add a permission** → **APIs my organization uses** tab → search for **Office 365 Exchange Online** (or select from Microsoft APIs → **SMTP**).
   * If Office 365 Exchange Online is not available for personal accounts, you can skip this — the default permission with the scope `SMTP.Send` requested during OAuth login is sufficient.
3. Make sure the app has the `SMTP.Send` permission.

#### **Step 4 — Enable SMTP for Your Mailbox**

For personal Outlook.com / Hotmail accounts, SMTP is usually enabled by default. If it's not working:

1. Go to Outlook.com → **Settings** (gear icon) → **View all Outlook settings**.
2. Go to **Mail** → **Sync email**.
3. Under **POP and IMAP**, make sure **Let devices and apps use POP** or **IMAP** is enabled (this also enables SMTP AUTH).

#### **Step 5 — Configure in App**

1. Select provider: **Microsoft Personal (Outlook.com / Hotmail)**.
2. Paste the **Client ID** and **Client Secret**.
3. Enter the **Email** address (your Outlook.com / Hotmail / Live.com address).
4. **Tenant ID** is NOT required for personal accounts.
5. Click **Save**, then click **Connect with your email above**.
6. Sign in with the same Microsoft personal account and grant permission.

> <mark style="color:$danger;">**Important**</mark>**:** The "From" email address **must match** the Microsoft account you authenticated with. Sending from a different address will cause emails to be rejected or go to spam.

***

### **3. Microsoft 365 Business**

Use this option if you want to send emails from a **work or school** Microsoft 365 account (e.g., `yourname@yourcompany.com`).

#### **Step 1 — Register an App in Azure**

1. Go to Azure Portal — App registrations.
2. Click **+ New registration**.
3. Fill in:
   * **Name**: any name (e.g., "SMTP OAuth Business")
   * **Supported account types**: select one of:
     * **Accounts in this organizational directory only** — if only your organization will use it
     * **Accounts in any organizational directory** — if multiple organizations may use it
   * **Redirect URI**: select **Web**, then paste your redirect URI: <https://cf.storeify.app/oauth/callback> (<mark style="color:$danger;">**IMPORTANT**</mark>)
4. Click **Register**.
5. On the app's **Overview** page, copy the **Application (client) ID** and **Directory (tenant) ID**.

#### **Step 2 — Create a Client Secret**

1. Go to **Certificates & secrets** → **Client secrets** tab.
2. Click **+ New client secret**.
3. Enter a description and select an expiry period.
4. Click **Add**.
5. **Immediately** copy the **Value** (this is your Client Secret).

#### **Step 3 — Configure API Permissions**

1. Go to **API permissions**.
2. Click **+ Add a permission** → **Microsoft APIs** → **Microsoft Graph**.
3. Select **Delegated permissions**.
4. Search and add: **SMTP.Send**, and **offline\_access**.
5. Click **Add permissions**.
6. If you have admin access, click **Grant admin consent for \[Your Organization]** (recommended but not always required).

#### **Step 4 — Enable SMTP AUTH for the Mailbox**

Microsoft 365 Business often has SMTP AUTH **disabled** by default. An admin must enable it:

**Option A — Microsoft 365 Admin Center:**

1. Go to Microsoft 365 Admin Center.
2. Go to **Users** → **Active users** → select the user.
3. Go to **Mail** tab → **Email apps**.
4. Check **Authenticated SMTP** → **Save**.

**Option B — PowerShell:**

Set-CASMailbox -Identity "<user@yourcompany.com>" -SmtpClientAuthenticationDisabled $false

#### **Step 5 — Configure in App**

1. Select provider: **Microsoft 365 Business**.
2. Paste the **Client ID** and **Client Secret**.
3. Enter the **Tenant ID** (Directory ID from Step 1).
4. Enter the **Email** address (your Microsoft 365 work email).
5. Click **Save**, then click **Connect with your email above**.
6. Sign in with the same Microsoft 365 work account and grant permission.

> <mark style="color:$danger;">**Important**</mark>**:** If your organization uses Conditional Access policies, you may need an admin to whitelist this app or allow SMTP AUTH for the specific mailbox.

***

### **Which Provider Should I Choose?**

| Feature                        | Google (Gmail)  | Microsoft Personal                    | Microsoft 365 Business                 |
| ------------------------------ | --------------- | ------------------------------------- | -------------------------------------- |
| **Email address**              | @gmail.com      | @outlook.com, @hotmail.com, @live.com | @yourcompany.com (custom domain)       |
| **Account type**               | Personal Google | Personal Microsoft                    | Work / School Microsoft                |
| **Tenant ID needed**           | No              | No                                    | Yes                                    |
| **Daily send limit**           | \~500 emails    | \~300 emails                          | \~10,000 emails                        |
| **Azure account type setting** | —               | "Personal Microsoft accounts only"    | "Accounts in organizational directory" |
| **SMTP Host**                  | smtp.gmail.com  | smtp-mail.outlook.com                 | smtp.office365.com                     |

***

### **Troubleshooting**

| Error                                                                    | Cause                                                                                                           | Fix                                                                                                                            |
| ------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **AADSTS9002346** — "configured for use by Microsoft Account users only" | You selected **Microsoft 365 Business** but the Azure app is registered with "Personal Microsoft accounts only" | Go to Azure Portal → App registration → Authentication → change **Supported account types** to include organizational accounts |
| **AADSTS50020** — "not in the tenant"                                    | The email account doesn't belong to the tenant specified                                                        | Check Tenant ID is correct, or the user account belongs to that organization                                                   |
| **Connection failed** with no error                                      | Missing Client Secret, wrong redirect URI, or wrong Client ID                                                   | Double-check all credentials                                                                                                   |
| **Emails going to spam**                                                 | The "From" email doesn't match the authenticated email                                                          | Make sure the email field matches the account you sign in with                                                                 |
| **Token expired**                                                        | Google test mode tokens expire after 7 days. Microsoft tokens are typically longer.                             | For Google: publish your OAuth app. For Microsoft: reconnect when prompted                                                     |
| **SmtpClientAuthenticationDisabled**                                     | SMTP AUTH is disabled for the M365 mailbox                                                                      | Admin must enable SMTP AUTH in Microsoft 365 Admin Center                                                                      |


# Upgrade and Downgrade

To upgrade or downgrade the plan you are using, go to the **Pricing plans** in the left side menu.

<figure><img src="/files/kUsj2mnFiFDnk2WE2Roa" alt=""><figcaption></figcaption></figure>

In this section, the plan that you are using is displayed, to change the plan you just need to select the desired plan and press the **Upgrade now** or **Downgrade now** button.


# Uninstall

If you no longer need the S: Contact Form Builder app, you can uninstall it from your Shopify admin in just a few steps.

***

#### Step 1: Go to the Apps Section <a href="#step-1-go-to-the-apps-section" id="step-1-go-to-the-apps-section"></a>

1. Log in to your Shopify admin
2. From the left-hand menu, click Settings > Apps

***

#### Step 2: Locate the App <a href="#step-2-locate-the-app" id="step-2-locate-the-app"></a>

1. In the Installed apps list, find S: Contact Form Builder
2. Click the three-dot (⋯) menu next to the app

***

#### Step 3: Uninstall the App <a href="#step-3-uninstall-the-app" id="step-3-uninstall-the-app"></a>

1. From the dropdown menu, click Uninstall
2. Confirm the uninstallation when prompted

<figure><img src="/files/gciZckJ3z4IbWa0kdvj4" alt=""><figcaption></figcaption></figure>

***

#### Important Notes <a href="#important-notes" id="important-notes"></a>

* Once uninstalled, the app will be removed from your store immediately
* Any app-related configurations may be deleted
* Billing for the app will stop according to Shopify’s billing policy

***

#### Need Help Before Uninstalling? <a href="#need-help-before-uninstalling" id="need-help-before-uninstalling"></a>

If you’re experiencing issues or considering uninstalling due to a problem, we recommend contacting support first. Our team can help resolve most issues quickly.


# FAQs

Summary of frequently asked questions

<details>

<summary>Why do I not receive an email notification when the form is submitted?</summary>

The cause of this problem may be that you have not set up the receive email field and the response email field in **Email Settings**.

**Note**: With the Email response field, you must select the exact field that you have set up for customers to enter their email on the form.

<figure><img src="/files/aqP9F96WYBXT2q9p09Aa" alt=""><figcaption></figcaption></figure>

If you have done the above steps but still do not receive notification emails, you need to do an additional step of configuring SMTP for the app (Go to App backend -> **SMTP**).

**Please note: to configure SMTP for the app, you need to enable 2-factor authentication for your account and create an alternative password (app password), which will be filled in the password field in the app's SMTP menu.**

If you are using Gmail, you can refer to the following instructions: <https://cf-guide.storeify.app/smtp>

</details>

<details>

<summary>Why does the RFC error appear after submitting the form?</summary>

The cause of this error is that you chose the wrong value of the Submitter Email Address field in Email Settings. Please check and set the correct value for this field.

<figure><img src="/files/r3PEEhWSdNcQqqiuYVdc" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Why is the email I received without the content of the submitted form?</summary>

The cause of the problem may be that you have not selected to edit the **Email content** in **Email Settings** *(Manage Forms -> Edit form -> Email Settings -> Email content)*. You need to add the values of the fields to the email body by selecting in the select box just above.

***The text available in the box is for example only, you should use selectbox to select data fields again.***

<figure><img src="/files/5BpwkWw3o5gZ0Hh6tyQ0" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Why does the email notification content not display data fields but display short-codes?</summary>

The reason for the problem is that the pre-filled short-code in the email content is just a sample short-code and it can vary from store to store. In the backend app, go to **Manage Forms** -> **Edit form** -> **Email Settings** -> **Email content** -> Reselect the required fields using **Select box**

<figure><img src="/files/5BpwkWw3o5gZ0Hh6tyQ0" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Why is the form no longer displayed after I change the website theme?</summary>

This is because the source code of the application has not been applied on the new theme. To solve this problem, you just need to go to **Integrate Theme** in the left menu -> Choose a new theme of the website -> Click the "**Go to Theme Editor > App Embeds"** button -> Click the **Save** button in the upper right corner.

<figure><img src="/files/v3NxYRYW8XVekn0k3PUD" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>How to add product name and url to email?</summary>

First you need to go to **Manage Forms** -> **Edit** Form -> **Active Form** -> **Show form on** -> Select **Products** tab -> Select all products you want to place the form on

Then, still in **Edit** Form -> **Email Settings** -> **Email Content** -> Use the selectbox to add the **Product name** to the email content

<figure><img src="/files/yzoEmBxPnDjt8otk1FRj" alt=""><figcaption></figcaption></figure>

</details>


# How to get Client ID, Tenant ID and Client Secret in Microsoft Azure

To create a client ID, tenant ID, and client secret in Microsoft Azure, you need to register an application in Microsoft Entra ID (formerly Azure Active Directory).

PrerequisitesYou must have an Azure account with permissions to register applications in the Microsoft Entra tenant.

#### Step 1: Find your Tenant ID <a href="#step-1-find-your-tenant-id" id="step-1-find-your-tenant-id"></a>

1. Sign in to the Azure portal.
2. In the search bar, type "Microsoft Entra ID" and select the service from the results.
3. On the **Overview** page, find the **Directory (tenant) ID**.
4. Copy this ID and save it in a secure location.

#### Step 2: Create an App Registration (Client ID) <a href="#step-2-create-an-app-registration-client-id" id="step-2-create-an-app-registration-client-id"></a>

1. In the Microsoft Entra ID menu, select **App registrations** under the "Manage" section.
2. Select **+ New registration**.
3. On the "Register an application" page:
   * Enter a meaningful **Name** for the application (e.g., "MyTestApp").
   * Under **Supported account types**, select an option based on your needs (e.g., "Accounts in this organizational directory only" is recommended for most applications).
   * **Redirect URI:** [**https://cf.storeify.app/oauth/callback**](https://cf.storeify.app/oauth/callback) **(IMPORTANT)**.
4. Select **Register**.
5. After the app is created, you will be on its **Overview** page. Find and copy the **Application (client) ID**. This is your **client ID**.
6. Save the client ID in a secure location.
7. Head over to **API Permission** section in your app and add **Microsoft Graph permissions**.

<figure><img src="/files/8YYUllvuCMe35LHBRRqX" alt=""><figcaption></figcaption></figure>

8. Select **Delegated Permissions** for `IMAP.AccessAsUserAll`, `SMTP.Send` and `offline_access`, then click "Add permissions"

<figure><img src="/files/iLUpJMrRuRhVkyvpbctC" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/SBEUQiu5CK00VBDfZOeH" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/QuxlS8dm6z8Yt520uJqh" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/gHaYxQOso5RUKidWr0cr" alt=""><figcaption></figcaption></figure>

#### Step 3: Generate the Client Secret <a href="#step-3-generate-the-client-secret" id="step-3-generate-the-client-secret"></a>

1. From your app registration's left-hand menu, under "Manage", select **Certificates & secrets**.
2. Under the **Client secrets** section, select **+ New client secret**.
3. A dialog box will appear:
   * Provide a **Description** for the secret.
   * Select a duration for when the secret will **Expire**. Microsoft recommends choosing one year for easier tracking.
4. Select **Add**.
5. **Important**: The **Value** of the client secret is displayed only this one time. Be sure to copy the value immediately and save it in a secure location. You cannot retrieve it later. The **Secret ID** is not the value you need for authentication.

You have now successfully obtained your tenant ID, client ID, and client secret, which are used to authenticate your application with Microsoft Entra ID.


# How to get Client ID and Client Secret in Google Cloud Console

To get a **Client ID** and **Client Secret**, you must create **OAuth 2.0 credentials** within a project in the Google Cloud Console. The process involves setting up an OAuth consent screen and then generating the credentials for a specific application type.

#### Step-by-Step Guide <a href="#step-by-step-guide" id="step-by-step-guide"></a>

1. **Go to the Google Cloud Console**
   * Navigate to the Google Cloud Console and sign in with your Google account.
   * Select an existing project from the top menu, or create a new one if needed.
2. **Enable the Necessary API**
   * In the left-hand navigation menu, go to **APIs & Services** > **Library**.
   * Search for the API you need (e.g., "Google Sheets API," "Gmail API") and click on it.
   * Click the **Enable** button to activate the API for your project.
3. **Configure the OAuth Consent Screen**
   * In the left menu, go to **APIs & Services** > **OAuth consent screen**.
   * Select the **User type** (usually **External** unless you are a Google Workspace organization user) and click **Create**.
   * Fill in the required "App information," including the **App name**, **User support email**, and **Developer contact information**.
   * Click **Save and Continue** through the "Scopes" and "Summary" sections (you can define scopes later if needed).
4. **Create the OAuth Client ID and Secret**
   * In the left menu, go to **APIs & Services** > **Credentials**.
   * Click the **+ CREATE CREDENTIALS** button at the top and select **OAuth client ID** from the dropdown menu.
   * Select the appropriate **Application type** for your use case: **Web application**.
   * Provide a **Name** for your client ID (this is only for your reference within the console).
   * You need to add **Authorized redirect URIs:** [**https://cf.storeify.app/oauth/callback**](https://cf.storeify.app/oauth/callback)
   * Click **Create**.

**Retrieve the Client ID and Client Secret**

A pop-up window will display your generated **Client ID** and **Client Secret**. Copy these values and store the **Client Secret** securely, as it should be treated like a password.

You can revisit and view these credentials anytime from the Credentials page in the Google Cloud Console by clicking on the name of the client you created.

#### See the detailed step-by-step screenshots from A to Z to get ***Google client ID and secret Key***: <a href="#see-the-detailed-step-by-step-screenshots-from-a-to-z-to-get-google-client-id-and-secret-key" id="see-the-detailed-step-by-step-screenshots-from-a-to-z-to-get-google-client-id-and-secret-key"></a>

<figure><img src="/files/MtcZjxmWeFnkYRNwZCS1" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Cp3LLsK6m8T8Qv8cRiUZ" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/K3SF4oOnyhKzUN5VlxQP" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/KkeiboBHdNiseW2z7Vzn" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/JXymPw0ljZD76VGcdZ1E" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/lz4dNgKnpI0QY8p46XuT" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/k8EeVGXp1nxBaC1Wut9m" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/GzKsBMaqNq3WQSHyctu3" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/y0ilHtOBdGWgN0rhWmem" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/oYBDGLqgqZqcQyX8Tfwv" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Gka1d8Y2Musa2vn1wJsz" alt=""><figcaption></figcaption></figure>

<mark style="color:$danger;">**Note**</mark>**: The tutorial image above is using the URI of our Quote app; you need to replace this URI with the URI of your Contact Form app:** [**https://cf.storeify.app/oauth/callback**](https://cf.storeify.app/oauth/callback)

<figure><img src="/files/asqyL8KJJ1uJyckepowV" alt=""><figcaption></figcaption></figure>


