> For the complete documentation index, see [llms.txt](https://magecomp.gitbook.io/shopify/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://magecomp.gitbook.io/shopify/apps/rfq-hide-price/build-rfq-form.md).

# Build RFQ Form

The **Build RFQ Form** section allows you to create and customize the RFQ form that customers will use to submit quote requests. You can select a template, configure the form fields, add security settings, customize the submit button, and define the success message.

***

### Step 1: Open Build RFQ Form

1. Open the **RFQ Request Quote & Hide Price** app from your Shopify admin.
2. From the left-side app menu, click **Build RFQ form**.
3. The **Build RFQ form** page will open.

<figure><img src="https://922942541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGRcMuVZCEGNibOl1OmW%2Fuploads%2FfrphljXH4OHaXnjXKf1l%2Fimage.png?alt=media&amp;token=beb5e9d0-0df4-456c-ab04-248409a2bcdd" alt=""><figcaption></figcaption></figure>

## Step 2: Select the Form Language

At the top of the **Build form** section, you will find the language dropdown.

#### Language

Select the language in which you want to configure the RFQ form.

For example:

**English**

The selected language determines the language version of the RFQ form you are currently editing.

<figure><img src="https://922942541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGRcMuVZCEGNibOl1OmW%2Fuploads%2FSePwYzdhW0QH9IOIB2Gp%2Fimage.png?alt=media&amp;token=d685a244-e7df-46b6-8ac9-b6e997174c41" alt=""><figcaption></figcaption></figure>

## Step 3: Select an RFQ Template

Under the **Template** section, you can select the design of your RFQ form.

Three templates are available:

* **Basic** – A simple and straightforward layout.
* **Modern** – A more modern arrangement of the RFQ form.
* **Viktor** – A structured layout for displaying the form and product information.

#### How to select a template

1. Click the template you want to use.
2. The selected template will be highlighted.
3. Check the **Preview** section on the right.
4. The preview will show how the selected template will appear to customers.

#### Basic:

<figure><img src="https://922942541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGRcMuVZCEGNibOl1OmW%2Fuploads%2Fm9yNHT62DXhKGc1svrix%2Fimage.png?alt=media&amp;token=7b52c318-52a9-4a9f-be41-83feeb8786d1" alt=""><figcaption></figcaption></figure>

#### Morden:

<figure><img src="https://922942541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGRcMuVZCEGNibOl1OmW%2Fuploads%2FVTlvEz2JQnPw3tNYLCMz%2Fimage.png?alt=media&amp;token=b4005347-650c-44a1-a491-98d6f33bd9c7" alt=""><figcaption></figcaption></figure>

#### Viktor:

<figure><img src="https://922942541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGRcMuVZCEGNibOl1OmW%2Fuploads%2Fx16i00BKWJ8mIHOU5nCZ%2Fimage.png?alt=media&amp;token=9aa1ccd8-f92e-40fc-90b0-bb2e4ce483ac" alt=""><figcaption></figcaption></figure>

#### Example

If you select **Basic**, the preview will display the RFQ form using the Basic layout.

You can try each template and select the one that best suits your store.

## Step 4: Add the RFQ Form Title

After selecting the template, configure the form title.

#### Title

Enter the title that you want to display at the top of the RFQ form.

**Example:**

`Request a Quote`

This title helps customers understand that they are submitting a request for a quotation.

<figure><img src="https://922942541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGRcMuVZCEGNibOl1OmW%2Fuploads%2Fwy0E3QtxJ2LWYYSfpz8M%2Fimage.png?alt=media&amp;token=f03e60a7-3aff-4881-87b0-39e21f84078f" alt=""><figcaption></figcaption></figure>

## Step 5: Add a Form Description

#### Description

Enter additional information or instructions that you want customers to see on the RFQ form.

**Example:**

`Submit your requirements and our team will get back to you with a customized quote.`

You can use this field to explain what customers should do before submitting their request.

<figure><img src="https://922942541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGRcMuVZCEGNibOl1OmW%2Fuploads%2Fu6vyKtyOWLPhPsZDNJSb%2Fimage.png?alt=media&amp;token=0e272a9d-4440-43ad-a2fa-970f076db2de" alt=""><figcaption></figcaption></figure>

## Step 6: Configure Form Fields

The RFQ form contains customer information fields that can be displayed to customers.

In your screenshot, the available fields include:

* **First Name**
* **Last Name**
* **Your Email**
* **Phone number**
* **Any comments or suggestions?**

Each field has an **Edit** option, allowing you to customize the field.

Some fields also have a **Delete** option if you don't want to display them.

<figure><img src="https://922942541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGRcMuVZCEGNibOl1OmW%2Fuploads%2FAU7ReXbyqNZFcYMaSYvb%2Fimage.png?alt=media&amp;token=ddb4f317-9894-41aa-a998-3d13016b5af4" alt=""><figcaption></figcaption></figure>

### Step 7: Edit a Form Field

To modify a field:

1. Find the field you want to change.
2. Click the **Edit** icon next to the field.
3. Configure the available field settings.
4. Save the field configuration.

For example, you can edit the **First Name** field according to your requirements.

## Step 8: Add Additional Fields

Click the **Add fields** button to add additional information fields to your RFQ form.

This allows you to collect additional information from customers that may be required to prepare a quotation.

<figure><img src="https://922942541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGRcMuVZCEGNibOl1OmW%2Fuploads%2FwYgicPV1irbxWJKT2iwZ%2Fimage.png?alt=media&amp;token=e71f156f-97fa-4c80-8cf8-deb2c341be9c" alt=""><figcaption></figcaption></figure>

#### Example

If you need additional information from customers, you can add a custom field such as:

**Custom Field:** Company Name

This allows the merchant to collect the customer's company information along with the RFQ.

## Step 9: Enable Google reCAPTCHA

The RFQ form also provides a security option to help prevent spam submissions.

#### Enable Google reCAPTCHA

Enable the **Enable Google reCAPTCHA** checkbox.

After enabling it, you need to configure the required Google reCAPTCHA information.

<figure><img src="https://922942541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGRcMuVZCEGNibOl1OmW%2Fuploads%2Fz8U4TnJ1uAZyL4i9CIcM%2Fimage.png?alt=media&amp;token=0c083a5c-01cd-4647-9b85-8678fc4d65b0" alt=""><figcaption></figcaption></figure>

## Step 10: Configure Google reCAPTCHA

After enabling reCAPTCHA, enter the required API information.

The app provides a **here** link where you can obtain the required Google reCAPTCHA API credentials.

#### reCAPTCHA Type

The screenshot indicates that the app uses:

**reCAPTCHA type: v2 Checkbox**

This adds a reCAPTCHA checkbox to the RFQ form to help prevent automated or spam submissions.

<figure><img src="https://922942541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGRcMuVZCEGNibOl1OmW%2Fuploads%2FxpNl191LhN4aZVhip6P2%2Fimage.png?alt=media&amp;token=3226671e-93f1-42d7-b9ea-fd2e443842f9" alt=""><figcaption></figcaption></figure>

## Step 11: Add Privacy Text

#### Privacy text

Enter the privacy-related text that you want to display on the RFQ form.

**Example:**

`By submitting this form, you agree to our Privacy Policy.`

This helps inform customers about how their submitted information is handled.

<figure><img src="https://922942541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGRcMuVZCEGNibOl1OmW%2Fuploads%2FhD074Fuoqw65SdyEHHxq%2Fimage.png?alt=media&amp;token=9ad28e98-2223-44db-ac12-064c4f1b4165" alt=""><figcaption></figcaption></figure>

## Step 12: Add Privacy Link

#### Add privacy link

Enter the link to your store's Privacy Policy page.

This allows customers to access your privacy policy from the RFQ form.

**Example:**

Your store's Privacy Policy page.

<figure><img src="https://922942541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGRcMuVZCEGNibOl1OmW%2Fuploads%2FDLm9eqO6c7eWRrafGEnu%2Fimage.png?alt=media&amp;token=dcac0ed2-4ba0-42e0-ae6c-cb189d440408" alt=""><figcaption></figcaption></figure>

## Step 13: Customize the Submit Button

#### Submit button

Enter the text that you want to display on the RFQ form's submission button.

**Example:**

`Submit`

You can change this text according to your requirements.

Other possible examples:

* `Send Request`
* `Request a Quote`
* `Submit Request`

<figure><img src="https://922942541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGRcMuVZCEGNibOl1OmW%2Fuploads%2Fq343PhMems5l0jTE3jO8%2Fimage.png?alt=media&amp;token=7fd2b0aa-336e-47f5-bebb-1a2e6604d64d" alt=""><figcaption></figcaption></figure>

## Step 14: Select the Success Message Type

After a customer submits the RFQ form successfully, you can choose how the success message should be displayed.

#### Select success message type

Use the dropdown to select the preferred success message display type.

In your screenshot, the selected option is:

**Pop-up model**

This means the success message is displayed in a pop-up after the form is successfully submitted.

<figure><img src="https://922942541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGRcMuVZCEGNibOl1OmW%2Fuploads%2FlBxJFhP6WbPN4tYuoCGy%2Fimage.png?alt=media&amp;token=85f1b33f-0a0b-4e6e-bd7f-636ffe188fd1" alt=""><figcaption></figcaption></figure>

## Step 15: Configure the Success Message

#### Success message (Modal)

Enter the message that customers should see after successfully submitting the RFQ form.

**Example:**

`Form successfully saved`

You can replace this with a more customer-friendly message, such as:

`Your quote request has been submitted successfully. We will contact you shortly.`

<figure><img src="https://922942541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGRcMuVZCEGNibOl1OmW%2Fuploads%2F6gMacw2tDuDjMgrjwbCP%2Fimage.png?alt=media&amp;token=da6347d0-2163-4ab4-a03d-f6b31863dd79" alt=""><figcaption></figcaption></figure>

## Step 16: Check the Preview

The **Preview** section on the right side allows you to see how your RFQ form will look.

Check the preview after making your changes to verify:

* Template layout
* Form title
* Description
* Customer fields
* Product information
* Quantity
* Offer price
* Comments
* Submit button

<figure><img src="https://922942541-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIGRcMuVZCEGNibOl1OmW%2Fuploads%2F0hefwZ9b94oG9c3Qr1aC%2Fimage.png?alt=media&amp;token=d47db9c5-fa0c-4096-99f5-7fde97fe47d6" alt=""><figcaption></figcaption></figure>

## Step 17: Save Your Changes

After completing all configurations, click **Save** at the top of the page.

This will apply your RFQ form configuration.

### Example Configuration

For example, you can configure your RFQ form as follows:

| Setting              | Example                                                   |
| -------------------- | --------------------------------------------------------- |
| Language             | English                                                   |
| Template             | Basic                                                     |
| Title                | Request a Quote                                           |
| Description          | Submit your requirements and receive a customized quote.  |
| Customer Fields      | First Name, Last Name, Email, Phone Number                |
| Comments             | Enabled                                                   |
| Google reCAPTCHA     | Enabled                                                   |
| reCAPTCHA Type       | v2 Checkbox                                               |
| Privacy Text         | By submitting this form, you agree to our Privacy Policy. |
| Submit Button        | Send Request                                              |
| Success Message Type | Pop-up model                                              |
| Success Message      | Your quote request has been submitted successfully.       |

> #### Note
>
> * The **Preview** section updates according to your form configuration.
> * You can edit or remove available fields according to your requirements.
> * Use **Add fields** when you need to collect additional information from customers.
> * Google reCAPTCHA is useful for reducing spam submissions.
> * Make sure the privacy text and privacy link point customers to the appropriate privacy information.
> * Click **Save** after completing the configuration.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://magecomp.gitbook.io/shopify/apps/rfq-hide-price/build-rfq-form.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
