Articles on: Magento 2 Pearl Theme User Guide

Child Theme options not working / not applied - Theme or Customizations issue (wp_custom.less)?

We sometimes hear from users who notice that their Pearl Theme child theme stops responding to edits or admin adjustments. If this happens to you, here’s how to troubleshoot it.



First Check: Child Theme Customizations


The most common cause of this issue is custom code in the child theme. If your child theme was working fine before and suddenly stopped, you’ll want to review any recent changes in the following file:


app/design/frontend/Pearl/weltpixel_custom/web/css/source/wp_custom.less



Quick Test


To confirm whether the issue is caused by your customizations:


  1. Switch from the child theme back to the main Pearl Theme.
  2. Reload your storefront.


  • If the store works correctly with the main theme but fails with the child theme, it’s very likely the culprit is code inside wp_custom.less.



Debugging


The simplest way to debug is:


  1. Remove all custom code from wp_custom.less.
  2. Add it back section by section, testing the store each time.
  3. Identify the exact snippet causing the breakage and fix or remove it.



If That Doesn’t Solve It


There are a couple of other scenarios to check:


  1. Multiple Store-Views Configuration

If you’re running multiple store views, make sure the Pearl Theme is configured properly.

See: How to configure the Pearl Theme when using multiple store-views


  1. Production Mode Styles Not Applied

Sometimes styles fail to apply after switching Magento to Production Mode.

See: Pearl Theme styles not applied or design issues after switching Magento to Production Mode



By going through these steps, you should be able to pinpoint whether the issue comes from your custom LESS code or a Magento configuration scenario.

Updated on: 16/09/2025

Was this article helpful?

Share your feedback

Cancel

Thank you!