This repo is the source of truth for the public, open source BigCommerce DevDocs and API reference at developer.bigcommerce.com. It consists of Markdown React (.mdx), OpenAPI Specification (.yml), and JSON Schema (.json and .yml) files.
The BigCommerce DX team maintains these open source docs; we welcome your issues, discussions, and pull requests!
If you're interested in contributing, see our Contribution guide and Code of conduct.
On December 27, 2023, the following public documentation repositories were deprecated, and all documentation moved into this repository. We retained the git
history of each document using the --allow-unrelated-histories
flag. The following repositories are now read-only:
https://github.com/bigcommerce/api-specs
https://github.com/bigcommerce/dev-docs
https://github.com/bigcommerce/theme-context-object-schemas
If you maintain API clients, this repository is your source for the most up-to-date public API specifications.
Please keep your fork up to date to ensure you're working with the newest source files.
Significant dates include the following:
- As of August 22, 2022, all API specification files are in OAS 3+ format.
- In March 2023, we made significant changes to support a new OAS parser at developer.bigcommerce.com.
- In May 2023, we subdivided both the Catalog and Payments API specifications into multiple files.
- On December 27, 2023, all public docs moved into the bigcommerce/docs repo.