- The Limitations of Default Shopify Plus B2B Registration Forms
- Step 1: Creating Custom Registration Fields Using Company Metafields
- Step 2: Building the Custom Front-End Registration Form via Liquid or Hydrogen
- Step 3: Configuring the Shopify Flow Automation for Real-Time Tax ID (EIN/VAT) Validation
- Step 4: Setting Up the Manual Approval Queue and Admin Notification System
- Step 5: Automating Company Creation, Price List Assignment, and Activation Emails
- Testing and Troubleshooting Common B2B Onboarding API Failures
- Common Mistakes to Avoid
- How to Fix API and Automation Failures
- Authoritative References
Out-of-the-box Shopify Plus B2B registration forms cannot natively collect custom business credentials, validate them automatically, or hold wholesale accounts in a pending state. This technical guide provides a step-by-step blueprint to build a secure, automated B2B onboarding pipeline that prevents retail buyers from accessing wholesale pricing.
The Limitations of Default Shopify Plus B2B Registration Forms
Shopify b2b registration is the process of onboarding wholesale clients by collecting business credentials, verifying tax identities, and assigning company profiles. Because default Shopify Plus forms lack validation gates, operators must customize this workflow to prevent unauthorized retail customers from accessing restricted wholesale price lists.
The native Shopify Plus B2B registration flow contains several critical operational gaps for high-volume merchants:
- No Custom Fields: The default form cannot collect essential B2B data points like EIN, VAT, or business license uploads.
- Immediate Account Creation: Customers are created instantly without a "pending review" status, exposing wholesale catalogs if not restricted.
- No Automated Validation: Operators must manually check tax registries, which slows down onboarding and increases overhead.
- Migration Friction: Importing existing wholesale clients without triggering automatic retail access requires precise setup. If you are currently transitioning from a legacy platform, utilizing a professional Shopify Migration Service is highly recommended to preserve historical data structures.
Step 1: Creating Custom Registration Fields Using Company Metafields
To collect and store business credentials, you must leverage Shopify Company Metafields rather than standard Customer Metafields. This ensures the data remains tied to the buying business entity.
- Navigate to Settings > Custom Data > Companies in your Shopify Admin.
- Click Add definition to create the following three required metafields:
- Tax ID / EIN: Set the namespace and key to
custom.tax_idwith a type of "Single line text". - Business License File: Set the namespace and key to
custom.business_licensewith a type of "File". - Registration Status: Set the namespace and key to
custom.registration_statuswith a type of "Single line text" (limit choices to:pending,approved,rejected).
Step 2: Building the Custom Front-End Registration Form via Liquid or Hydrogen
Because the standard customer registration page only creates Customer profiles, you must build a custom form that handles both Customer and Company creation.
For Liquid-based themes, construct a custom page template containing an HTML form that submits payload data to a custom App Proxy or a serverless function (such as a Cloudflare Worker or AWS Lambda). This intermediary service will safely execute Shopify's Admin GraphQL API using your private access token.
- Ensure the form captures the user's first name, last name, email, company name, address, and your custom metafields.
- Configure the serverless function to call the
companyCreateGraphQL mutation, passing the form inputs directly into the company and contact input objects. - To prevent performance bottlenecks, ensure your custom Liquid code is optimized. Consulting an expert on Shopify Theme Optimization ensures that custom front-end forms do not degrade your store's core web vitals.
Step 3: Configuring the Shopify Flow Automation for Real-Time Tax ID (EIN/VAT) Validation
Once the form submits data and creates a "pending" Company, Shopify Flow must trigger to validate the business credentials in real time.
- Open the Shopify Flow app and click Create workflow.
- Select the trigger: Company created.
- Add an action: Send HTTP request. Configure this to ping an external validation API (such as VAT Sense or OpenCorporates) using the
custom.tax_idmetafield value. - Add a conditional block: Check if the API response returns a status code of 200 and a
valid: truepayload. - If valid, configure Flow to update the Company Metafield
custom.registration_statustoapproved. - If invalid, configure Flow to set the status to
rejectedor flag it for manual review.
Step 4: Setting Up the Manual Approval Queue and Admin Notification System
Not all business registries can be validated programmatically. You need a fallback mechanism that alerts your operations team when a application requires manual intervention.
- In Shopify Flow, add a branch to your validation step for instances where the external API returns an error or a mismatch.
- Add the action: Send admin notification or Send Slack message containing the registration details and a direct admin link.
- In the Shopify Admin, navigate to the Companies list view and create a custom search filter:
metafield.custom.registration_status = 'pending'. - Save this view as "Pending B2B Approvals" to serve as your operational queue.
- For complex pipeline setups, engaging a dedicated Shopify Plus Consulting specialist can help align these manual workflows with your ERP or CRM.
Step 5: Automating Company Creation, Price List Assignment, and Activation Emails
Once the validation step confirms a legitimate business entity, the onboarding automation must finalize the account setup to grant immediate portal access.
- Update Company Status: Shopify Flow changes the
custom.registration_statusmetafield toapproved. - Assign Price List: Flow calls the
priceListAssignmutation to link the Company Location to your specific wholesale price list. - Enable Ordering: The Company Location is assigned to your B2B checkout channel, enabling payment terms (e.g., Net 30).
- Send Activation Email: Flow triggers the Send customer invite email action, prompting the buyer to set up their password and log in.
Testing and Troubleshooting Common B2B Onboarding API Failures
Common Mistakes to Avoid
- Omitting the Company Location: Creating a Company without a Company Location prevents Shopify from applying Price Lists or Tax Exemptions.
- Hardcoding API Credentials in Liquid: Never expose your Shopify Admin API tokens in front-end Liquid or Hydrogen code; always route requests through a secure serverless proxy.
- Ignoring Draft Orders: Allowing unapproved B2B accounts to submit draft orders before validation is complete can expose proprietary wholesale pricing.
How to Fix API and Automation Failures
- GraphQL Rate Limits (User Errors): If your registration volume spikes, you may hit Shopify's GraphQL rate limits. Implement a retry mechanism with exponential backoff in your serverless middleware.
- Missing API Scopes: Ensure your custom app has both
write_companiesandwrite_customersaccess scopes enabled, or thecompanyCreatemutation will fail silently. - Null Metafield Values: If Shopify Flow fails on the validation step, verify that your front-end form inputs map precisely to the exact namespace and key defined in your Custom Data settings.
Authoritative References
Use these official resources to verify platform-specific claims and implementation details before making commercial or technical decisions.
Frequently Asked Questions
How do you collect custom business registration data in Shopify Plus B2B?
To collect custom business registration data in Shopify Plus B2B, merchants must utilize Company Metafields rather than standard Customer Metafields. This ensures that critical business credentials, such as Tax IDs, EINs, VAT numbers, and uploaded business licenses, remain structurally tied to the buying Company entity rather than an individual customer profile. By navigating to Settings, Custom Data, and then Companies within the Shopify Admin, operators can define custom fields like custom.tax_id (Single line text) and custom.business_license (File). Because standard front-end registration forms only support customer-level data creation, developers must build a custom front-end form using Liquid or Hydrogen. This form submits the payload to a secure serverless middleware (such as a Cloudflare Worker), which executes Shopify's Admin GraphQL API using the companyCreate mutation to map the custom metafields directly to the newly created Company and Company Location profiles.
Can you automate Tax ID and VAT validation in Shopify Plus?
Yes. By using Shopify Flow combined with external APIs (like VAT Sense or OpenCorporates), you can automatically validate Tax IDs or VAT numbers. When a new Company is created, Shopify Flow triggers an HTTP request to the validation API and updates the Company Metafield status to 'approved' or 'rejected' based on the API payload response.
Why does the default Shopify registration form fail for B2B onboarding?
The default Shopify registration form only creates individual Customer accounts, not Company profiles. It cannot collect custom business data like EINs or file uploads, nor does it support a 'pending review' status, meaning users can immediately access the store without verification.
Ecommerce manager, Shopify & Shopify Plus consultant with 10+ years of experience helping enterprise brands scale their ecommerce operations. Certified Shopify Partner with 130+ successful store migrations.
