Repository navigation
Test issue : Local workbench fails when tenant URL is not configured in serve.json #11066
Description
Describe the bug
The local workbench starts, but when attempting to load the SharePoint Online workbench, the project does not open against the expected tenant.
To Reproduce
Steps to reproduce the behavior:
- Create a new SPFx web part project.
- Run heft start.
- Select the SharePoint Online workbench.
- Observe that the project does not load against the expected tenant.
- Expected behavior
- automatically configure the tenant URL during project setup,
VS Code Extension Information (please complete the following information):
OS: [e.g. iOS]
Version [e.g. 22]
CLI Information (please complete the following information):
SPFx version 1.23.x
Node.js 22.x
Gulp 4.x
Additional context
] Linting isn't currently supported in watch mode
[build:configure-webpack-serve] Placeholder {tenantdomain} was found in serve.json but OS variable SPFX_SERVE_TENANT_DOMAIN is not set. Either set the environment variable or update the serve.json initial page url.
[build:configure-webpack-serve] Launching initial page: https://{tenantdomain}/_layouts/workbench.aspx?debugManifestsFile=https%3A%2F%2Flocalhost%3A4321%2Ftemp%2Fbuild%2Fmanifests.js&debug=true&noredir=true
Activity
m365-agent-toolkit-assistant commentedon Oct 19, 2026
👋 Hi Ashlesha-MSFT,
Thank you for reporting this issue. Here is an AI-generated initial response:
Classification: Not a bug — the hosted workbench URL still contains
{tenantDomain}because the tenant setting has not been supplied; SPFx does not automatically select a tenant during project setup.SPFX_SERVE_TENANT_DOMAINis unset. The local server starting is separate from opening the SharePoint Online workbench.What to do now:
SPFX_SERVE_TENANT_DOMAINto your tenant domain, such ascontoso.sharepoint.com, in the environment runningheft start; then restart it.initialPageinconfig/serve.jsonwith your hosted workbench’s full URL. If the URL remains unresolved, share theserve.jsonvalue and how you launch Heft.Useful links: