Skip to content

Account Registration

Overview

Section titled “Overview”

Customer account registration form that creates new customer accounts in BigCommerce’s customer management system. Allows new customers to sign up for an account to access order history, faster checkout, and saved information.

Requirements

Section titled “Requirements”
  • Parent block: None (can be placed on any page)
  • BigCommerce data: Creates new customer records in BigCommerce

Configuration

Section titled “Configuration”

Attributes

Section titled “Attributes”
  • settingsId (string) - Settings configuration identifier
    • Default: ""

Block Support

Section titled “Block Support”
  • HTML editing: Not supported

Usage

Section titled “Usage”

Placement

Section titled “Placement”

This block is typically placed on a dedicated registration page or alongside the login form. It can also be added to any template where customer signup is needed.

Common Patterns

Section titled “Common Patterns”

From the demo video script, the registration block is part of the customer account creation experience:

[Account Registration Page]
  → Account Registration Form ←
    Email field
    Password field
    Confirm Password field
    [Additional customer information fields]
    Create Account button
    Already have an account? Sign In link

After successful registration:

  • New customer account is created in BigCommerce
  • Customer is automatically logged in
  • Session is established between WordPress® and BigCommerce
  • Customer can access account features (order history, profile, etc.)

Technical Details

Section titled “Technical Details”

CSS Classes

Section titled “CSS Classes”

The block includes its own stylesheet (style-index.css) for form styling.

Data Source

Section titled “Data Source”

The registration block communicates directly with BigCommerce’s customer management API to:

  • Create new customer account in BigCommerce
  • Validate email uniqueness (prevent duplicate accounts)
  • Establish authenticated session after registration
  • Store customer profile information in BigCommerce

Customer accounts are managed entirely in BigCommerce. When a customer registers:

  1. Form data is submitted to BigCommerce API
  2. New customer record is created in BigCommerce customer database
  3. Customer is automatically authenticated
  4. Session token is created and stored
  5. Customer can immediately access account features

Troubleshooting

Section titled “Troubleshooting”

Registration form not displaying

Section titled “Registration form not displaying”
  • Verify the block is added to the page/template
  • Check that the BigCommerce connection is active
  • Ensure the page is published and accessible

Registration fails with error message

Section titled “Registration fails with error message”
  • Check that the email is not already registered in BigCommerce
  • Verify password meets BigCommerce password requirements
  • Review browser console for API error messages
  • Ensure all required fields are completed

Customer account created but not logged in

Section titled “Customer account created but not logged in”
  • Check session handling between WordPress® and BigCommerce
  • Verify authentication token is being stored correctly
  • Review browser console for authentication errors
  • Test login manually with the new credentials

Duplicate account errors

Section titled “Duplicate account errors”
  • BigCommerce enforces unique email addresses per customer
  • Customer may already have an account - direct them to login
  • Check for existing account in BigCommerce admin
  • Use password reset if customer forgot their credentials

Validation errors or requirements unclear

Section titled “Validation errors or requirements unclear”
  • Ensure form includes clear validation messages
  • Check BigCommerce customer field requirements
  • Verify password strength requirements are displayed
  • Test with various input scenarios to identify specific validation issues