How to fix autocomplete valid on BigCommerce

Add valid `autocomplete` attribute values to every form field that collects personal information, using the exact tokens specified by the HTML standard.

Steps for BigCommerce

  1. Go to Storefront → My Themes → Advanced → Edit Theme Files (Stencil theme editor).
  2. For the checkout, BigCommerce uses an optimised one-page checkout rendered by its platform; it already includes standard autocomplete tokens. For customised checkouts using the Checkout SDK, edit your custom checkout component files.
  3. For account and contact forms, open the relevant Handlebars template files such as `templates/pages/auth/login.html`, `templates/pages/auth/create-account.html`, or `templates/pages/account/edit.html`.
  4. Find each `<input>` element and add the correct `autocomplete` attribute.
  5. Download, edit, and re-upload the theme bundle, or use the Stencil CLI for live editing.
  6. Preview the theme and validate with an axe browser extension before publishing.
Official BigCommerce documentation ↗

What is autocomplete valid?

The HTML `autocomplete` attribute tells browsers (and assistive technologies) what kind of data a form field expects — for example, a person's name, email address, shipping street address, or credit card number. WCAG Success Criterion 1.3.5 ("Identify Input Purpose") requires that any field collecting personal information carry a correct, recognised `autocomplete` value from a defined list. If the value is missing, misspelled, or used on the wrong type of field (e.g. `autocomplete="email"` on a password input), browsers and screen readers cannot reliably identify its purpose, and the autocomplete feature breaks.

For users with cognitive disabilities, motor impairments, or low vision, browser autofill is not a convenience — it is often the only practical way to complete a checkout form. An invalid or missing `autocomplete` value means autofill silently fails, forcing customers to type every field manually and dramatically increasing checkout abandonment. WCAG 1.3.5 is a Level AA requirement, which is the legal conformance target in most accessibility laws worldwide (ADA, EAA, AODA, EN 301 549); non-compliance creates real legal exposure. Fixing it also improves Google's Page Experience signals and can lift organic conversion rates, since a frictionless checkout is one of the clearest levers on revenue.

See the complete Autocomplete valid guide for every platform and the full background.

Not sure if your BigCommerce store has this?

Run a free SEOLZ scan — we’ll find autocomplete valid and every other issue across your whole site.

Scan my site free

Fix autocomplete valid on another platform