Skip to Content
Platform.Ontology

Periodic Background Sync

Wakes an installed site every so often to refresh data.

Asks you firstNotifications and backgroundBackgroundWeb browsersAfter you leave the site

In one line

Can refresh an installed web app now and then while closed, at times the browser picks

Wakes an installed site every so often to refresh data.

Lets an installed web app fetch updates on a schedule while closed. The browser, not the site, picks the actual times from engagement and battery.

What it can and can't do

What the user does: You install the web app and use it often

It can

  • Fetch fresh news, mail or podcasts on a schedule while the app is closed
  • Wake no more than about once every 12 hours
  • Update quietly with no pop up

It cannot

  • Run for a site that is not installed
  • Choose the exact times, since the browser decides from your use and battery
  • Work in Firefox or Safari
  • Work on Samsung Internet

How it differs between platforms: Chrome and Edge on computers and Android, for installed apps only. Firefox, Safari and iPhone do not support it.

Browser support

BrowserStatusFirst versionReleasedNote
ChromeSupported802020-02-04Installed PWAs only
EdgeSupported802020-02-07None
FirefoxNot supportedNot availableNot listedNone
SafariNot supportedNot availableNot listedNone
Safari on iPhoneNot supportedNot availableNot listedNone
Chrome on AndroidSupported802020-02-04None
Samsung InternetNot supportedNot availableNot listedNone

How a site asks for it

APIregistration.periodicSync.register('tag', {minInterval}); 'periodicsync' event
Permission nameperiodic-background-sync
Browser compat keysapi.PeriodicSyncManager
How access is grantedinstall
What the user seesNo prompt; Chrome only allows it for installed PWAs, and the permission follows engagement.
Needs a secure context (HTTPS)Yes
Needs a user gestureNo
How long it lastsInstalled app only
How to take it backUninstall or Site settings
Inside an iframeService worker only

Typical flow

  1. Install the PWA
  2. Register with minInterval
  3. Browser wakes the worker on its own schedule
  4. Worker fetches content

Data you get

What comes back: Periodic sync event
Shape: event
How often: browser chosen, minimum interval 12 hours (Chrome)

FieldTypeUnitRangePrecision
minIntervalintegerms12 hours minimum in Chromebrowser decided

Technical limits

  • Not in Firefox or Safari
  • Installed PWA only
  • Frequency chosen by engagement

The story

What it is

An installed web app can wake up now and then to refresh its content, even when closed.

For you

There is no prompt in most cases. If you installed the app, it may refresh news or weather in the background, so it is up to date when you open it. It can use some battery and data.

For makers

Makers get a native feel: fresh content ready at launch. The browser decides when to wake the app, based on how often you use it. It is only for installed apps in Chromium.

Where you see it

TypeExampleApps
newsAn installed news web app fetches the morning headlines before you wake up, so it opens instantly.BBC News
musicA music web app refreshes your playlists and downloads new songs overnight.None named
travelA transit web app updates timetables and delays in the background.None named
utilitiesA weather web app refreshes the forecast so it is fresh when you open it.None named
productivityA mail web app syncs new messages in the background to save time at launch.None named
gamesA browser game refreshes daily challenges before you open it.None named
shoppingA store web app refreshes deals and wishlists in the background.None named

Risks

  • Battery and data use
  • Runs when not in use

What the platform says

Good uses and abuse

Legitimate uses

  • News and email refresh
  • Podcast downloads

Known abuse

  • Staying alive after leaving

Scores

ScoreValueMeaning
Sensitivity2 of 5How revealing the data is
Utility3 of 5How useful it is to honest apps
Friction1 of 5How much the user has to do
Fingerprint bitsNot ratedRough identifying entropy, when known

History

  • 2020-02, Chrome 80: Periodic Background Sync ships for installed PWAs
  • Background Sync. Can retry sending queued data after you close the tab, once you are back online

Sources

How well checked: Based on official documentation.

On this page