Migrate to the Storefront Developer Workspace (Beta)
To manage the storefront development lifecycle in one interface, enroll in the Developer Workspace beta. Developer Workspace includes Managed Runtime resources in Business Manager for Storefront Next and Composable Storefront projects that are linked from Managed Runtime. For each storefront, the admin selects Business Manager or Runtime Admin as the tool to use to manage storefront development. Also, the admin also selects the API for that storefront: the SCAPI-based API or the MRT API.
Developer Workspace is a pilot or beta service that is subject to the Beta Services Terms at Agreements - Salesforce.com or a written Unified Pilot Agreement if executed by Customer, and applicable terms in the Product Terms Directory. Use of this pilot or beta service is at the Customer’s sole discretion.
Important
Step 1: Enroll in the Developer Workspace Beta
To turn on the Developer Workspace beta in Business Manager:
In the Search box, enter Feature Switches, and then select Feature Switches from the suggested result.
Click Enable Developer Workspace (Beta), and then click Apply.
Step 2: Set Up Admin Permissions
The storefront admin must have write access for the UI and API Access permission for the storefront. The Administrator role has this permission by default. During the beta, the admin must also have admin permissions for the corresponding Managed Runtime project. See Users, Abilities, and Roles in Managed Runtime Overview. Set up these permissions before you manage the storefront.
Step 3: Choose an Admin User Interface and API
In Business Manager, select Administration > Sites > Storefronts, and then click your storefront.
Click Storefront Settings > Management Interface, and then click Edit.
This user interface and API selection applies to the whole storefront and to its Managed Runtime project, if the storefront has one. The selection also applies to every environment and to the B2C Commerce instance.
Important
Select the admin user interface for the storefront.
To use the developer tools in Business Manager as part of the beta, select Business Manager.
To switch a storefront from Business Manager back to Runtime Admin, select Runtime Admin.
Under Storefront APIs, select the option for your setup. Follow the on-screen instructions to create a SCAPI client and to update your continuous integration and continuous delivery (CI/CD) tools to use the new credentials.
SCAPI: Select this option to use the SCAPI-based API for Managed Runtime. This option uses the same B2C Commerce (SCAPI) authentication as other B2C Commerce APIs.
SCAPI and MRT: (Recommended) Select this option when you migrate an existing storefront. This option uses the MRT API and the SCAPI-based API. The SCAPI-based API uses SCAPI authentication. If your CI/CD tools use the MRT API, keep both APIs enabled so that automation keeps working while you move that automation to SCAPI.
MRT: To turn off SCAPI access and use only the MRT API, select this option.
Save your changes.
Step 4: Grant Storefront Permissions to Users
Grant these permissions before users work with storefront environments and deployments.
Business Manager access to the B2C Commerce instance. An admin grants this access in Account Manager. Add the Business Manager role that includes a filter for the B2C Commerce instance. See Step 1: Give Users Business Manager Access.
Storefront module permissions in Business Manager, and per-storefront management permissions for environments, deployments, environment variables, and URL redirects. See Step 2: Add Storefront Permissions in Business Manager.
Step 5: Create a SCAPI Client and Update Automation
If you chose an API option that includes SCAPI:
In Account Manager, create an API client with the SALESFORCE_COMMERCE_API role and the sfcc.storefront.* scopes. See Add an API Client in B2C Commerce in Salesforce Help.
Is switching the management interface to Business Manager reversible? Yes. Switch a storefront back to Runtime Admin, or change the API option, at any time. Runtime Admin always stays available.
Is this a per-storefront choice or an all-or-nothing switch? Per storefront. Each storefront is one Managed Runtime project, so the selection applies to every environment for that storefront (development, staging, and production). It doesn’t apply to your other storefronts. Move one storefront at a time.
Do I log in to Runtime Admin? Yes. Some capabilities remain in Runtime Admin. See the next question.
What remains in Runtime Admin during the beta? These stay in Runtime Admin:
Managed Runtime CDN certificates and hostname (custom domain) management
Project notifications
User, API key, and notification management
Everything else (environments, deployments and history, environment variables, URL redirects, and performance monitoring) is available in Business Manager.
Are Managed Runtime (Account Manager) roles still needed during the beta? Yes. Business Manager permissions control which actions a user takes in Business Manager. Managed Runtime runs the operation, so assign each user a Managed Runtime project role in Runtime Admin that matches their Business Manager storefront role. Storefront operations require that Managed Runtime role in addition to the Business Manager permissions. This dependency is expected to be removed at GA.
Who can change a storefront’s management interface? During the beta, a user with UI and API Access (Write) in Business Manager and the Admin role on the Managed Runtime project can change the management interface. Business Manager Administrator status in the user’s own instance isn’t enough. This dependency is expected to be removed at GA.
Will opting in break my existing CI/CD or scripts? Existing CI/CD and scripts keep working if the MRT API stays enabled. Select SCAPI and MRT so that existing automation keeps working. After your pipelines use SCAPI, switch to SCAPI. Only the APIs that you enable can change the storefront, so a pipeline that targets a disabled API stops working.
Is there an automated way to migrate my Managed Runtime roles to Business Manager? No. Recreate each role as a Business Manager role. Use the permission model in Set Up Roles and Permissions for Developer Workspace.
Can I limit a user’s access to a single environment? No. Storefront permissions apply to every environment for a storefront. Scope a role to one storefront or to a group of storefronts in an instance. You can’t scope a role to one environment in a storefront. This matches Managed Runtime, where roles apply to the whole project. Scope roles and API clients per instance. For example, withhold production so that a user can’t reach its environments.
Why can’t a user see the full storefront list? The all-storefronts context controls whether a user lists every storefront. Grant the Storefront permission (Read) with the context set to all storefronts for roles that browse the complete list. A role scoped only to specific storefronts shows only those storefronts.
j