Loading

DevOps Center Deployment Error: Experience Site Bundle Missing Required Route Type (e.g., "flow")

Publiceringsdatum: May 21, 2026
Beskrivning

When deploying an Experience Site (formerly Community) bundle from a source org to a target org using Salesforce DevOps Center, the deployment fails with the following error:
"Your site needs a route with route type flow. Update your file and try again."

This error occurs because the Experience Site bundle in the deployment payload is missing a required default route file — in this example, a route of type "flow." Routes are metadata files that define the URL structure and page mapping within an Experience Site. 

The required route file should be included automatically when the bundle is retrieved from Experience Builder or downloaded as metadata. However, the route file may be missing if:

  • The metadata bundle was modified directly outside of Experience Builder and the route file was accidentally deleted.
  • The bundle was retrieved in a partial or incomplete state.
  • The bundle payload was manually curated and the route file was excluded.
Lösning

Two options are available to resolve this deployment error. Option 1 is the recommended approach.

Option 1: Restore the Missing Route File (Recommended)

This option preserves all existing site customisations. You may need to repeat these steps if multiple route types are missing.

  1. Create a new Experience Site in the source org using the same template and components as the affected site.
  2. Retrieve the Experience bundle for the new site using Salesforce CLI or the Metadata API.
  3. In the retrieved bundle, open the routes folder and locate the file with "routeType": "flow" (or whichever route type appears in the error message).
  4. Copy that route file. Open it and update the appPageId value to match your original Experience Site (you can copy the appPageId from any other route file in your original bundle).
  5. In the views folder of the new site bundle, locate the file with the same name as the route file you just copied.
  6. Copy that view file and update its appPageId to match your original Experience Site.
  7. Place both the route file and the view file into the corresponding folders of your original site bundle.
  8. Redeploy the updated bundle via DevOps Center.
  9. If additional route errors appear, repeat the above steps for each missing route type.

Option 2: Switch and Reset the Experience Site Template (Destructive)

Warning: This approach resets all customizations made to the current Experience Site. Use only if Option 1 is not feasible and you are prepared to rebuild site content.

  1. Navigate to All Sites | Workspaces | Administration | Settings | Change Template.
  2. Change the template to any template other than the current one.
  3. Open Experience Builder and publish the site with the new template.
  4. Return to Administration | Settings | Change Template and switch back to the original template.
  5. Salesforce recreates the site with all default out-of-the-box routes restored, including the missing route type.
Knowledge-artikelnummer

001920428

 
Laddar
Salesforce Help | Article