Skip to content

Manifest member in Manifest

edge_side_panel manifest member

Published

edge_side_panel is a Microsoft Edge manifest member that lets an installed PWA be pinned to the Edge sidebar, the vertical strip of apps on the right edge of the browser window. Its one property, preferred_width, sets the requested opening width; the default is the 376-pixel minimum.

The member is implemented only by Microsoft Edge on desktop (Windows, macOS, Linux). Chrome 155, Firefox 157, and Safari 27 drop it as an unknown member with no error. Microsoft’s own documentation carries an update dated July 2026 stating that the feature is being deprecated and will no longer be supported. Avoid using it for new work.

Property Value
Type object. The empty object {} is the complete opt-in; the only recognized property is preferred_width, a number of CSS pixels.
Default absent. Without the member Edge offers no sidebar pin for the app; with {} the sidebar opens the app at its default minimum width of 376 px and the user can widen it.
Example value { "preferred_width": 480 }.

Microsoft’s documentation requires name, short_name, description, and icons to be present before the member is honoured, because the sidebar store listing is built from them. A preferred_width below the 376 px minimum is clamped to it; the user can still resize the panel larger or smaller down to that minimum.

An app pinned in the sidebar receives the desktop User-Agent Client Hint by default even when a mobile variant exists. The sidebar identifies itself to the page through a UA-CH brand, which is the supported detection path; Microsoft documents the User-Agent string match as a fallback and recommends against it.

Adding the manifest member takes one line. A separate runtime check lets the app choose its layout.

Opting a music player into the sidebar at 480 px

Section titled “Opting a music player into the sidebar at 480 px”

A player with a two-column layout cannot fit in 376 px, so it asks for 480. Edge opens the sidebar at that width when the user pins the app; everything else about the manifest is a normal installable PWA.

{
"name": "PWAmp music player",
"short_name": "PWAmp",
"description": "A skinnable music player app to play your favorite mp3 files",
"start_url": "/",
"display": "standalone",
"icons": [{ "src": "/favicon-256.png", "sizes": "256x256", "type": "image/png" }],
"edge_side_panel": { "preferred_width": 480 }
}

Dropping preferred_width keeps the pin available and leaves the width to the user, which is the better choice for a layout that already works at 376 px.

Detecting the sidebar context and falling back

Section titled “Detecting the sidebar context and falling back”

Edge exposes the sidebar through a User-Agent Client Hint brand. Browsers without navigator.userAgentData (Firefox 157, Safari 27) take the fallback branch and are treated as a normal window.

function isInEdgeSidebar() {
if (!('userAgentData' in navigator)) return false; // no UA-CH: not Edge's sidebar
return navigator.userAgentData.brands.some((b) => b.brand === 'Edge Side Panel');
}
document.documentElement.dataset.layout = isInEdgeSidebar() ? 'sidebar' : 'window';

Use the data attribute in CSS to adjust the layout. A sidebar app runs in a narrower, taller viewport; a max-width media query covers most of the same adjustments without branching application logic.

Serving the desktop layout to a sidebar on a mobile-first site

Section titled “Serving the desktop layout to a sidebar on a mobile-first site”

Because the sidebar sends desktop client hints, a site that picks a mobile bundle from the Sec-CH-UA-Mobile header serves its desktop variant to a 376 px panel. Check the brand on the server before choosing.

// Express middleware: prefer the compact layout inside the Edge sidebar.
app.use((req, res, next) => {
const brands = String(req.get('Sec-CH-UA') ?? '');
res.locals.compact = brands.includes('"Edge Side Panel"') || req.get('Sec-CH-UA-Mobile') === '?1';
next();
});

Sec-CH-UA is a low-entropy hint sent on every request, so no Accept-CH opt-in is needed for this check.

Specifications

SpecificationStatus
Microsoft Edge Explainers: Side PanelExplainer