# Troubleshooting with the debugger and Storefront Toolkit

*B2C Commerce Developer Study Guide · Application Development · Last updated November 3, 2026 · https://www.certifyforce.com/study-guide/b2c-commerce-developer/application-development/troubleshooting-with-the-debugger-and-storefront-toolkit*

How to work an error from production log evidence to a sandbox debug session, pick the right Storefront Toolkit tool, isolate SFRA upgrade regressions, and read script timeouts, cache side effects and deprecation messages.

- Certification: Salesforce B2C Commerce Developer
- Exam section: Application Development
- Study guide: https://www.certifyforce.com/study-guide/b2c-commerce-developer

**Official exam objective:**

> Use debugging best practices and techniques to troubleshoot scripts and controllers and verify outcomes.

## What the exam expects

- Follow the documented troubleshooting order: production evidence (session ID, URL, time) into log files, then reproduce and debug on a non-production instance.
- Choose the Storefront Toolkit tool that answers a question about a page: templates and controllers, content, caching, search scoring, request logs or preview.
- Run the SFRA troubleshooting checks and isolate whether a defect comes from base code or customizations.
- Explain script timeouts per context, why they can't be caught, and how a debug session changes them.
- Recognise side effects that show up while verifying outcomes: shortened cache times after script exceptions and deprecation log entries.

Key terms: **Script Debugger API** (the REST API IDE debuggers use for breakpoints, variables and expressions); **Storefront Toolkit** (six storefront overlay tools opened from Business Manager); **Request Log** (the toolkit tool that shows log entries for recent server calls); **code compatibility version** (the API behaviour level a code version runs with); **script timeout** (a per-context limit that aborts a script with a non-catchable exception); **deprecation log** (the system log of deprecated API usage).

## Key facts

| Fact | Detail | Source |
|---|---|---|
| Production error | Note session ID, URL and exact time; find the error in logs | [Troubleshooting](https://developer.salesforce.com/docs/commerce/b2c-commerce/guide/b2c-troubleshooting.html) |
| Script Debugger API | Not available on a production instance | [Scripts](https://developer.salesforce.com/docs/commerce/b2c-commerce/guide/b2c-working-with-scripts.html) |
| `debug` log level on production | Always disabled | [Log Files](https://developer.salesforce.com/docs/commerce/b2c-commerce/guide/b2c-log-files-overview.html) |
| Storefront Toolkit | Six tools | [Storefront Toolkit Tools](https://help.salesforce.com/s/articleView?id=cc.b2c_storefront_toolkit_tools.htm&type=5) |
| Cache Info icons | Red uncached, green cached | [Storefront Toolkit Tools](https://help.salesforce.com/s/articleView?id=cc.b2c_storefront_toolkit_tools.htm&type=5) |
| Request Log precondition | Same host name for storefront and Business Manager | [Examine Server Calls Using the Request Log](https://help.salesforce.com/s/articleView?id=cc.b2c_using_the_request_log.htm&type=5) |
| Controller request timeout | 5 minutes | [Scripts](https://developer.salesforce.com/docs/commerce/b2c-commerce/guide/b2c-working-with-scripts.html) |
| Debug session open | Minimum timeout for all contexts becomes 30 minutes | [Scripts](https://developer.salesforce.com/docs/commerce/b2c-commerce/guide/b2c-working-with-scripts.html) |
| `isscript` exception | Page cache time limited to 5 minutes | [iscache Element](https://developer.salesforce.com/docs/commerce/b2c-commerce/guide/b2c-iscache.html) |
| `status="off"` usage | Logged with code location in the deprecation log | [iscache Element](https://developer.salesforce.com/docs/commerce/b2c-commerce/guide/b2c-iscache.html) |

## Check yourself

- Which timeout applies to form field validation scripts?
- When should you add code instrumentation?
- Why can the Request Log show your own log lines while you debug a script?
- When does an empty deprecation log tell you something useful?

## Sources

- [Troubleshooting](https://developer.salesforce.com/docs/commerce/b2c-commerce/guide/b2c-troubleshooting.html)
- [Scripts](https://developer.salesforce.com/docs/commerce/b2c-commerce/guide/b2c-working-with-scripts.html)
- [Storefront Toolkit Tools](https://help.salesforce.com/s/articleView?id=cc.b2c_storefront_toolkit_tools.htm&type=5)
- [Examine Server Calls Using the Request Log in B2C Commerce](https://help.salesforce.com/s/articleView?id=cc.b2c_using_the_request_log.htm&type=5)
- [Troubleshoot SFRA](https://developer.salesforce.com/docs/commerce/b2c-commerce/guide/b2c-troubleshooting-sfra.html)
- [SFRA Features and Components](https://developer.salesforce.com/docs/commerce/b2c-commerce/guide/b2c-sfra-features-and-comps.html)
- [Log Files](https://developer.salesforce.com/docs/commerce/b2c-commerce/guide/b2c-log-files-overview.html)
- [iscache Element](https://developer.salesforce.com/docs/commerce/b2c-commerce/guide/b2c-iscache.html)

## About the full unit

The "Core concepts", "Exam traps" and "Worked scenario" sections of this unit, its 10 linked practice questions, and unlimited timed mock exams are included with the B2C Commerce Developer pack (USD $19): https://www.certifyforce.com/practice-exams