> 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

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. You will paste it into the block.

## 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. Assign a template, or create one for it.
4. **Add block → Apps → Wholesale Form**.
5. Paste the **Form ID**.
6. **Save**.

## 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>—</td></tr><tr><td><strong>General Error Message</strong></td><td>Shown when something goes wrong.</td><td>—</td></tr><tr><td><strong>Submit Error Message</strong></td><td>Shown when the submission itself fails.</td><td>—</td></tr><tr><td><strong>Network Error Message</strong></td><td>Shown when the request cannot reach us.</td><td>—</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</code></td></tr><tr><td><strong>Form Disabled Message</strong></td><td>Shown when the form exists but is disabled.</td><td><code>This form is currently disabled.</code></td></tr><tr><td><strong>Access Denied Message</strong></td><td>Shown when the visitor may not access this form.</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 default messages are placeholders. The success message in particular is the last thing an applicant sees, and "Success" tells them nothing.

Say what happens next and when:

> Thanks — we've got your application. We review these within two business days and will email you at the address you gave us. Approved accounts can sign in and see trade pricing straight away.

Set the error messages too. A buyer who hits a network error and sees nothing will assume it worked.

## 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: disable the form and reload the page to confirm your disabled message shows.

## Common problems

**"Form Not Found".**\
The Form ID is wrong or has a stray space. Re-copy it.

**"This form is currently disabled".**\
The form is disabled in the app. Enable it.

**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.