PWA

# FAQ & Troubleshooting

# Issue: [ERROR] Problem with fetching CMS data: Path `` could no be resolved.

  • Make sure you have followed the instructions in our Cheatsheet, especially Shopware setup.*
  • Ensure you have configured shopware-pwa application by setting the right values described in this step. It's crucial to have the right shopwareAccessToken in the shopware-pwa.config.js file.
    It should be taken from storefront Sales Channel type - NOT a headless one.

# Issue: [ERROR] Problem with fetch <ENTITY_NAME> data: No Matching sales channel found.

  • There is no Sales Channel related to the shopwareAccessToken you have set in your shopware-pwa.config.js file.
  • Either shopwareEndpoint or shopwareAccessToken does not match.
  • Use the appropriate endpoint and access token (from Shopware admin panel) and follow steps described here ("Running Shopware PWA on custom Shopware instance" chapter).

# Issue: There are no products in the product listing. *

  • In your Shopware platform: Assign the categories and the products to the right Sales Channel, related to the shopwareAccessToken you have set in shopware-pwa.config.js.

  • It might be, that your local PWA version is out of date. Try to use the npx @shopware-pwa/cli command instead to have always latest version of the package.

* - if you are using your self-hosted Shopware instance

# Question: How can I override theme component?

You can override theme component easily by typing yarn shopware-pwa override and picking component to override.

WARNING

Please remember, that overriding component means you no longer use theme component so you'll have no updates for overrided components. If you feel that you need to override couple of components to accomplish some effect maybe we can help you upgrading theme to allow you to override just one component to have this. Feel free to ask your questions on discord or create an issue for that.

Here's how overriding component looks like: overriding theme components

# Issue: Console warning - Trying to access Application context without Vue instance context.

Example: composables context security warning It means that somewhere you have useAddToCart invocation without passing root. Find that in your code and add context.

See: Context-awareness section. It's explained in details.

# Issue: Console warning - [shopware-6-api] After calling API method XXXXXX there is no "onConfigChange" listener.

You should check all your imports for @shopware-pwa/shopware-6-client and add apiInstance as the last parameter.

See: Context-awareness section. It's explained in details.

# Issue: The API Client's timeout is too low. I'm getting HTTP 408 errors.

You can increase the timeout setting, to do so:

  • Edit shopware-pwa.config.js file
  • Add entry:
shopwareApiClient: {
  timeout: 10000; // 10 seconds of axios timeout setting
}

# Issue: There is no language available in language switcher

TIP

Learn the details how to set the new language properly.

  • Check if there are entries in .shopware-pwa/sw-plugins/domains.json.
  • If not, check your shopware-pwa.config.js, if shopwareDomainsAllowList entry contains a domain you would like to use
  • then run yarn shopware-pwa domains command.

# Issue: There's no "thank you page" on Apple devices

  • The issue is described broadly here (opens new window).
  • The possible solution in your project may look like in the PR (opens new window):
    • copy api-client.js plugin from (%PROJECT_DIR%/node_modules/@shopware-pwa/nuxt-module/plugins/api-client.js), do the changes from mentioned PR and put it in your project's src/plugins folder (you will lose the compatibility on further upgrades)
    • adjust every handlePayment usages to pass the context token parameter as a part of success/failure URL.

# Console errors during initialization of a project via @shopware-pwa/cli package

  • Currently Shopware PWA uses node v14.15.3
  • Check if you node version meets the requirements from package.json

# Specific version of Shopware PWA cannot be installed via CLI (CI/CD process)

  • pass a version using a --stage option like npx @shopware-pwa/cli@canary --stage=^0.9.1 --ci

← Setup Cheatsheet →