> For the complete documentation index, see [llms.txt](https://help.dollarlabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.dollarlabs.io/dollarlabs-b2b-custom-pricing/wholesale-forms/add-the-form-to-your-store.md).

# Add the form to your store

Publish a form on a page in your theme, and set the messages applicants see.

Forms are placed with the **Wholesale Form** theme app block.

## Get the form ID

Open **Wholesale Forms** and copy the ID of the form you want to publish with the clipboard button in the **Form ID** column. You can also open the form and choose **Storefront**. You will paste the ID into the block.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-1b4a9c379f46fd0744e0a54cedcdb0f39de56f6c%2Fform-storefront-popover-annotated.png?alt=media" alt="Storefront popover with Not on your storefront yet, the form ID with a copy button, and an Add to theme button."><figcaption><p>Copy the form ID and open the theme editor from the form itself.</p></figcaption></figure>

## Create the page

1. **Online Store → Pages → Add page**. Call it something like *Wholesale application*.
2. Publish it. Leave the content empty — the block supplies the form.

## Add the block

1. **Online Store → Themes → Customize**.
2. Navigate to your new page.
3. Create or select a dedicated page template. Assign that template to the application page in Shopify Admin so other pages do not inherit the form.
4. **Add block → Apps → Wholesale Form**.
5. Paste the **Form ID**.
6. **Save**.

<figure><img src="https://2844543096-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcVBfwy7Yj4tU8TsxkHEr%2Fuploads%2Fgit-blob-f606c66bc48b075a64210230f5d944aad7bd8edd%2Ftheme-editor-wholesale-form-block-annotated.png?alt=media" alt="Shopify theme editor showing the Wholesale Form app block settings and the form rendered on the page."><figcaption><p>The Wholesale Form block in the theme editor, with the form ID pasted.</p></figcaption></figure>

{% hint style="success" %}
**Shortcut:** in the form editor, open **Storefront** and choose **Add to theme**. The theme editor opens with the Wholesale Form block already added; paste the form ID from the same popover and save. Back in the app, **Recheck** confirms **On your storefront**.
{% endhint %}

## Settings

<table><thead><tr><th width="270">Setting</th><th>What it does</th><th width="200">Default</th></tr></thead><tbody><tr><td><strong>Form ID</strong></td><td>Which form to render. Required.</td><td>—</td></tr><tr><td><strong>Submit button text</strong></td><td>The button label.</td><td><code>Submit Application</code></td></tr><tr><td><strong>Success message</strong></td><td>Shown after a successful submission.</td><td><code>Thank you for your application! We will review it and get back to you soon.</code></td></tr><tr><td><strong>General error message</strong></td><td>Shown when something goes wrong.</td><td><code>There was an error submitting your application. Please try again.</code></td></tr><tr><td><strong>Submit error message</strong></td><td>Shown when the submission itself fails.</td><td><code>Failed to submit form</code></td></tr><tr><td><strong>Network error message</strong></td><td>Shown when the request cannot reach us.</td><td><code>Network error. Please try again.</code></td></tr><tr><td><strong>Form not found message</strong></td><td>Shown when the Form ID does not match a form.</td><td><code>Form not found or is disabled.</code></td></tr><tr><td><strong>Form disabled message</strong></td><td>Shown when the form's Status is Draft.</td><td><code>This form is currently disabled.</code></td></tr><tr><td><strong>Access denied message</strong></td><td>Shown when the visitor doesn't match the form's <strong>Access rules</strong>.</td><td><code>You do not have access to this form.</code></td></tr><tr><td><strong>Custom CSS</strong></td><td>Your own styling.</td><td>—</td></tr></tbody></table>

## Write the success message properly

The block has default success and error messages. Review them and add your actual review timeframe if you can commit to it.

Say what happens next and when:

> Thanks for applying. We’ll review your business details and email you with the next steps.

Check the error messages as well so buyers know when to retry.

## Linking to it

* Add it to your main navigation, or the footer under "Wholesale" or "Trade accounts"
* Link it from your product pages where prices are hidden behind login — the buyer asking "why can't I see prices?" is exactly who should apply
* Include it in any trade marketing you send

## Testing

1. Open the page as a logged-out visitor.
2. Submit a real application with an email you control.
3. Confirm the success message appears and reads sensibly.
4. Confirm the submission is in your queue.
5. Approve it and check the [automations](/dollarlabs-b2b-custom-pricing/wholesale-forms/approvals-and-automations.md) ran.

Then test the failure states: set the form's Status to **Draft**, save, and reload the page to confirm your disabled message shows. Set it back to **Active** afterwards.

## Common problems

**"Form not found or is disabled."**\
The Form ID is wrong or has a stray space. Re-copy it.

**"This form is currently disabled", or the Storefront popover says "Hidden while Draft".**\
The form's Status is Draft. Set it to **Active** in the form editor and save.

**The block is missing from the theme editor.**\
You are on a different template or theme than you think, or the theme is not Online Store 2.0.

**The form looks wrong against your theme.**\
Use **Custom CSS** on the block.