Magento: Troubleshooting

Resolving common issues after a Magento+ScandiPWA installation

404 Not Found on Homepage

There can be multiple reasons why the homepage shows a 404 page. This is usually due to a Magento misconfiguration:

  1. Go to Stores > Configuration > General > Web > Default Pages > CMS Home Page and check if it is set

  2. Go to Content > Pages make sure the column Store View is not empty for your Home Page CMS page. If it is empty, click on the page, select necessary stores and click save

Luma Theme Visible

If you installed ScandiPWA, but the frontend still displays the Luma theme, follow the steps below.

Verify that the type of your theme in the theme Magento table to 4.

Verify that the theme is compiled

Verify that Magento_Theme is not be empty, and contains 2 folders. If this is not the case, compile the theme:

yarn (Recommended)
npm
yarn (Recommended)
BUILD_MODE=magento yarn build
npm
BUILD_MODE=magento npm run build

After the command's execution, the folders should appear. If there is a compliation issue, please read the logs to found out why.

Verify that the theme is set in the Magento admin panel

Check the Content > Design > Themes and make sure your store has the correct ScandiPWA theme set.

Flush caches

magento cache:flush

Asking for Help

If you couldn't resolve your issue, feel free to ask for help! Please see the guidelines for asking for help in Slack.

‚Äč