Documentation
Feedback
Guides
Storefront Development

Storefront Development
Store Framework
Managing performance
Deactivating the VTEX IO native service worker

The VTEX IO platform provides a native service worker to every store using VTEX Store Framework.

This is due to the fact that all VTEX Store Framework stores natively benefit from having a PWA at their disposal.

A PWA is a sort of web app used to promote certain advantageous features to users, such as offline navigation or a home screen icon. Once enabled in a store, the PWA uses the VTEX IO necessarily service worker in order to function.

As a result of this native usage, you may face a conflict when working with a third party service responsible for providing its own service worker to operate. Since a website can only have one service worker running, you can choose to deactivate the native service worker provided by VTEX IO in order to successfully use a third party solution in your store.

Step by step

  1. Access your account's admin.
  2. Access CMS and then Store.
  3. Click on the Advanced tab.
  4. Toggle the Service Worker button.

{"base64":"  ","img":{"width":2876,"height":1432,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":285413,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/images/vtex-io-documentation-deactivating-the-vtex-io-native-service-worker-0.png"}}

  1. Save changes.

Notice that the toggle button can activate and deactivate the VTEX IO native service worker. Therefore, use the step by step above to manage it according to your store's needs.

Once you save the changes, the VTEX Service Worker will be automatically disabled.

Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest edits (Github)
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page