How to set up Application Gateway path based routing on Static Web Apps

By Sai Kiran Pandrala · reviewed by Sai Kiran Pandrala, Editor Last verified: 2026-05-30

Why this matters

Set up application gateway path based routing on a Static Web Apps device is one of the highest-volume how-to searches for the Azure Devops category. Most users find the menu path inconsistent across Static Web Apps model revisions, so this guide gives a generalised path plus model-specific notes.

Pre-requisites

• A Static Web Apps device that's powered on and on the latest stable service version / OS.
• The Static Web Apps companion app or management tool installed and signed in.
• 5-15 minutes uninterrupted.

Step-by-step

1. Locate the setting. Open settings on your Static Web Apps device. For "set up Application Gateway path based routing", the option lives under one of: General, Advanced, Connectivity, Accessibility, or a Static Web Apps-specific menu. Check the Static Web Apps user manual for your exact model if you can't find it.
2. Toggle the feature on. Confirm the on-screen prompt.
3. Configure sub-options. Most features have 2-3 sub-options (mode, schedule, paired device). Pick values that match your real-world usage pattern.
4. Save / apply. Some Static Web Apps models auto-save, others require an explicit Done / Save tap.
5. Test live. Trigger the feature in a real scenario to confirm the configuration is correct.

Tips that save time

• Pair this feature with a Static Web Apps automation / routine if the device supports it.
• If the feature relies on cloud sync, give it 1-2 minutes after enabling to propagate.
• For multi-user households / multi-admin teams, set per-user profiles so each user sees their preferred state.

Common gotchas

• Feature greyed out , usually service version too old. Update + retry.
• Feature works once then stops, battery saver / power saver mode is killing the Static Web Apps app process. Whitelist it.
• Feature works but with delay, usually cloud-sync latency; check internet speed and Static Web Apps service status.

Region / variant notes

Some Static Web Apps features are region-locked or only available on higher-tier SKUs. If your variant doesn't show "set up Application Gateway path based routing" at all, check the Static Web Apps model spec sheet to confirm support.

Frequently asked questions

How long should the recovery / setup take?

For most Static Web Apps Azure Devops cases, allow 15-45 minutes the first time. Repeats are usually under 10 minutes once you know the menu path.

Will this exact procedure work on every Static Web Apps model?

The procedure reflects current Static Web Apps behaviour. Menu paths shift between service version generations; verify against the manual for your specific model + revision.

Is the procedure safe in production / live use?

Apply during a maintenance window where possible. Capture pre-change state. Static Web Apps doesn't usually publish rollback procedures, so make sure you can restore manually.

Does this affect my Static Web Apps support coverage?

Standard operation per the user manual + applying official service version updates does NOT void support coverage. Opening managed services, third-party repair, or unauthorised modifications can void support coverage, check before going further.

Related guides

• All Azure Devops guides → /microsoft/section/azure_devops.html
• All Microsoft guides → /microsoft/

Related fixes

Related guides worth a look while you sort this one out:

• How to set up Application Gateway path based routing on Logic Apps
• How to set up Application Gateway path based routing on App Service
• How to set up Application Gateway path based routing on Application Insights
• How to set up Application Gateway path based routing on ARM Templates / Bicep
• How to set up Application Gateway path based routing on Azure CLI
• How to set up Application Gateway path based routing on Azure DevOps Pipelines

References

• Static Web Apps official support portal for your model.
• Static Web Apps community forum + Reddit threads.
• Vendor PSIRT / advisory page (where applicable).

Reference material, not professional advice. Validate with your vendor manual and follow local regulations.

What changed recently?

Fault diagnosis on this unit goes faster when you map the symptom to a recent change:

• Did service version update in the last 7 days?
• Did the network (router, ISP, VPN) change?
• Was the device moved physically?
• Did paired devices (phone, hub, app) update?
• Were any accessories swapped in or out?

The answer narrows the root cause to a manageable subset.

Safety + preconditions

Before any work on this hardware:

• Unplug from mains for any internal-access procedure.
• flush cached state (circuit breakers in PSUs, residual battery charge) per manufacturer guidance.
• Use ESD-safe handling for boards and modules — no carpet, no wool sleeves.
• Avoid moisture; never apply liquids near vents or connectors.
• If you smell smoke, see scorch marks, or feel uneven heat, stop and escalate.

Verification checklist

After applying the fix on the device, confirm:

• The original symptom is no longer reproducible.
• Related features (status service health indicators, app sync, paired accessories) still work.
• The device responds to a soft reboot without the fault returning.
• Any error codes that were on display have cleared.
• Documentation (your service log, the brand companion app) reflects the change.

When to call How support instead

Escalate if:

• The same symptom returns within 24 hours of a clean fix.
• You see physical damage (burn marks, swollen battery, cracked PCB).
• The device is in support coverage and a hardware replacement is the cheaper outcome.
• Repair requires specialised tools you don't own (alignment jigs, calibration software).
• Following the official path keeps the support coverage intact, which matters more than the time spent.

More frequently asked questions

Can I roll this back if something breaks?

Yes for software-level changes (service version rollback, config rollback). Hardware changes are usually one-way. Always back up settings before starting.

Why is this happening on a brand-new unit?

Out-of-box defects do occur. If you've owned the device under 30 days and the symptom persists after a tenant reset, escalate to the seller for replacement under DOA terms before opening a manufacturer support case.

Does this affect other devices on my network?

Generally no. The procedure is local to this device. Network-side changes (service version updates that affect TLS, SMB, or routing) are flagged explicitly in the steps.

What if the fix returns after a reboot?

Persistent fault returns mean either: a hardware fault (escalate), a configuration that's being overwritten by a sync source (check cloud profiles), or a regression in a recent service version update (rollback).

How long does this fix usually take?

Most users complete the steps in 20-45 minutes the first time, and 5-10 minutes on subsequent runs once the menu paths are familiar.

Field notes from real Azure Devops incidents

When I work on set up Application Gateway path based routing on Static Web Apps the rhythm I lean on is the one I have built over years of these tickets. Setting system.debug = true on an Azure Pipelines run is the single fastest way to turn a vague failure into an actionable line number. Self-hosted agent log under _diag is where the real story lives — the pipeline UI summary is always missing the one detail you need. Service connection failures almost always come down to a managed identity that lost a role assignment, not to Azure DevOps itself.

Tools I actually reach for

For set up Application Gateway path based routing on Static Web Apps on Static Web Apps the cheapest signal I can land usually comes from Boards REST API, then az devops cli, Service connection diagnose tool, Azure Pipelines agent diagnostics, Self-hosted agent runner logs when Boards REST API cannot see the layer the fault sits in, and Pipeline logs (verbose: system.debug=true) for the cases where neither of those answers cleanly. That ordering is not academic. It matches the layers the failure tends to surface through, so the cheap signal lands first and the heavier tooling only comes out when the simpler answer does not hold up under scrutiny.

Verification I run before I close the ticket

Before I mark set up Application Gateway path based routing on Static Web Apps resolved on a Static Web Apps unit, the verification loop below is what I actually run. Each step proves a different layer is green, and the order matters - the cheap checks gate the more expensive ones.

az pipelines runs list --project PROJ --top 5

If that one comes back clean, move to the next check. If it does not, stop and dig in there before layering more verification on top of a red signal.

Set pipeline variable system.debug = true; re-run to surface step-level traces

If that one comes back clean, move to the next check. If it does not, stop and dig in there before layering more verification on top of a red signal.

az devops project list --organization https://dev.azure.com/ORG

Only when every line above runs clean do I close the ticket and update the runbook with the timestamps.

Where I check first when the docs disagree

When two sources contradict each other on a Azure Devops detail, the disambiguation order I lean on is stable. I usually start at learn.microsoft.com/azure/devops for the ground-truth view on Azure Devops. I usually start at github.com/microsoft/azure-pipelines-tasks for the ground-truth view on Azure Devops. I usually start at dev.azure.com for the ground-truth view on Azure Devops. Random blog posts and reseller wikis are signal, not ground truth, and I treat them as such until the references above either confirm or contradict the claim.

Pitfalls I have walked into on this exact path

The shortcuts that look smart on set up Application Gateway path based routing on Static Web Apps have a habit of biting back. The pitfalls below are the ones I have personally walked into on a Static Web Apps unit, not things I read about. Self-hosted agent log under _diag is where the real story lives: the pipeline UI summary is always missing the one detail you need. Service connection failures almost always come down to a managed identity that lost a role assignment, not to Azure DevOps itself. Setting system.debug = true on an Azure Pipelines run is the single fastest way to turn a vague failure into an actionable line number. When in doubt I revert to the slower path that the manual prescribes - the time I save by skipping it is always smaller than the time I spend cleaning up afterwards.

What I tell the next on-call

When I hand set up Application Gateway path based routing on Static Web Apps off to the next person on rotation, the three lines I leave in the runbook are these. First, the symptom signature for Static Web Apps on the Azure Devops family - not a paraphrase, the exact string that surfaces. Second, the diagnostic that gave the highest signal in the least time. Third, the exact verification command whose green output justified closing the ticket. That trio is what turns a one-off fix into a runbook entry the next engineer can use without paging me at three in the morning.

I also add a one-line note on the cost of getting this wrong. For set up Application Gateway path based routing on Static Web Apps on a Static Web Apps unit, the cost is rarely the replacement part. It is the downtime, the second site visit, and the trust deficit you spend with whoever owns the asset when the fix does not hold. That framing keeps the next on-call from choosing the cheap-looking shortcut that ends up costing the most in elapsed hours and goodwill.