App Extensions scope and automatic deletion on uninstall
Clarified how App Extensions relate to the app that creates them and what happens to them when an app is uninstalled.
- App ownership and scope — App Extensions are dual-scoped: each one is owned by the app registration that created it (through the app’s OAuth
client_id) and stored independently in each store’s database. Only the owning API account can manage an app’s App Extensions. - Automatic deletion on app uninstall — BigCommerce automatically deletes a store’s App Extensions when the owning app is uninstalled, so no manual cleanup is required.
- Uninstall callback guidance — The
/uninstallcallback is for cleanup within your own app; platform-registered resources such as webhooks and App Extensions are removed automatically and don’t need manual deletion.
For details, see the App Extensions overview and Single-Click App Callback Handlers.
Global Regions tutorial: clearer starting point
Thanks to user feedback, the Global Regions tutorial now explains how to reach its starting point instead of assuming you already know how to edit theme files.
- Expanded prerequisites: the tutorial now recommends completing Create and Place a Widget first and describes both ways to edit theme files, locally with Stencil CLI or in the control panel.
- Concrete steps: the tutorial now points to the theme’s
templates/pages/folder and spells out thestencil pushcommand for applying local changes.
For details, see the Global Regions tutorial.
GraphQL Schema Updates
Authenticated customers can now delete a stored payment instrument through the Storefront GraphQL API. This mutation is an alpha release: the schema marks it deprecated with the reason “Alpha version. Do not use in production.”
Storefront GraphQL
- Delete stored payment instruments: new
deleteStoredPaymentInstrumentmutation on theCustomerMutationstype deletes a stored payment instrument for the authenticated customer.- Input:
DeleteStoredPaymentInstrumentInputtakes thetokenof the stored payment instrument to delete. - Result:
DeleteStoredPaymentInstrumentResultreturns anerrorslist ofDeleteStoredPaymentInstrumentError; an empty list indicates success.
- Input:
For schema details, browse the Storefront GraphQL API reference.
Removed invalid is_default filter from Get Locations
Thanks to user feedback, we’ve removed the is_default query parameter from the Get Locations endpoint reference: it was documented as a valid filter but the live API rejects it with a 422 error.
- Removed the
is_defaultfilter parameter, which never worked against the live API - Other documented filters (
location_id,location_code,type_id,managed_by_external_source,is_active,storefront_visibility) are unaffected and continue to work as documented
For details, see Get Locations.
Stencil Advanced course: custom regions and visual editor testing
The Stencil Advanced course now covers theme regions and how they enable content building in both visual editors, with new labs for adding and testing regions after deployment.
- New Regions lesson: Regions explains how regions make a page editable in Page Builder or Makeswift, and covers the
{{{region}}}helper syntax and global regions. - New regions lab: Add Regions to the Product Page walks through adding a standard and a global region to the product page template.
- New testing lab: Test Custom Regions and Config Settings provides branching steps for placing content in your custom regions in Page Builder and, optionally, in Makeswift (Beta), including built-in Stencil components and Component Styles.
Amazon EventBridge and Google Cloud Pub/Sub webhook delivery
BigCommerce webhooks can now be delivered to Amazon EventBridge and Google Cloud Pub/Sub in addition to HTTPS, giving you serverless, at-scale alternatives to hosting your own callback endpoint.
- Amazon EventBridge — route webhook events to a serverless event bus. This delivery mechanism has graduated from closed beta to public documentation.
- Alternative delivery mechanisms — the webhooks overview now surfaces HTTPS, Google Cloud Pub/Sub, and Amazon EventBridge as selectable delivery options.
For details, see Amazon EventBridge Webhooks and the Webhooks Overview.