WeltPixel Help Center
  • English
Go to website
Back
Articles on:Magento 2 Pearl Theme User Guide
General information & troubleshooting for the Pearl Theme

Categories

  • Magento 2 Pearl Theme User Guide
  • Magento 2 User Guide
  • Google Analytics 4 User Guide
  • Troubleshooting & Common Issues
  • FAQs
  • Versioning & Updates
  • How to customize css / xml / phtml / js files in Magento 2 - examples [ Tutorial ]
    In this article, we’ll show practical ways to customize .css, .xml, .phtml, and .js files in Magento 2. These patterns work for any Magento 2 theme/extension and are demonstrated with the Pearl Theme for clarity. Summary Using a child theme for Magento 2 customizations Magento 2 CSS customization Magento 2 XML customization Magento 2 PHTML customization Magento 2 JS customization Add custom code in Footer and Head via Admin options Pearl TSome readers
  • Improve Magento store speed: Disable unused Pearl Theme extensions and Design Elements, implement Advanced JS Bundling
    Disable unused extensions and Design Elements that come with Pearl Theme to improve speed and strip down the theme code to only load the functionality you need for your project. Associated Pearl Theme extensions highly increase the theme functionality and are located under the folder structure below. You can choose the extensions you need, and deactivate the ones you don't need – this way your code will be light, fast, and more conflict-free. app/code/WeltPixel/NavigationLinks (MegaMeSome readers
  • Autoload error - How to fix Magento Marketplace wizard installation error
    autoloaderror.png Fixing Autoload Errors When Installing WeltPixel Extensions from Magento Marketplace You may encounter an Autoload Error during installation from the Magento Marketplace if both the standalone extension and its dependency pack (the package name ending with -theme) are selected. Normally, installation should work whether you select onlySome readers
  • Manual (SSH) Installation if product is purchased from Magento Marketplace
    Thanks for your purchase! Only Composer installation is available for extensions purchased from Magento Marketplace — we know it stinks. However, if you need Manual (SSH) Installation, we’ve got you covered with two scenarios: 1. Free Products If you purchased a Free Extension, go to weltpixel.com and re-download the product. You’ll be able to get instant access to the extension ZIP files under the Downloadable Products section of ySome readers
  • How to set Magento 2 permissions and avoid installation errors
    If you encounter installation issues or read/write errors in Magento 2, you may need to correct file permissions and ownership. Below are recommended setups for basic and advanced permissions. 1. Basic Permissions Setup We recommend the following permissions for Magento: Directories: 711 PHP files: 600 All other files: 644 Run these commands from your Magento root:Some readers
  • How to fix autoload error, Manual installation vs Magento composer installation
    Autoload errors can occur when the same module or a shared package is installed twice using different methods (Composer vs. manual). When this happens Installing a WeltPixel extension via Magento Marketplace (Composer) (under vendor/weltpixel) and updating the same extension manually (under app/code/WeltPixel) causes an autoload error because the module is defined twice. Installing one WeltPixel extension via Marketplace (Composer) and a second one manualSome readers
  • Bitnami AWS - Installation issues with Magento 2 Theme or Extensions [Solved]
    Common issue: When copying files via FTP to a Bitnami Magento installation, files are copied with user daemon. Later, when clearing cache, regenerating LESS, or deploying static content via SSH, problems may occur because the logged-in user is bitnami. Common solution: Use the sudo prefix before issuing SSH commands. After copying new files, ensure permissions are corrected. Most Bitnami Magento issues stem from permission mismatches or user privileges.Some readers
  • Magento 2.3.0 & 2.2.7 compatibility released - December 8, 2018
    Compatibility released – December 8, 2018. Magento versions 2.3.0 and 2.2.7 are now fully supported. The latest release is available under your weltpixel.com account. You can review the full details in the WeltPixel Product Updates – Change Log and New Releases. 👉 Tip: Sign up for the WeltPixel Newsletter on weltpixel.com to be notified as soon as new versions anSome readers
  • How can I restore Pearl Theme default settings to look like Pearl Demo store?
    You can restore Pearl Theme default settings using the built-in GUI installer that includes the theme configurator. Access the Installer Open the installer in your browser: Steps to Restore Defaults Step 1 — Skip Initial Installation Steps Skip Step 1, Step 2, and Step 3 (installation steps). SkipInstallationstep1.png (https://storage.crisp.chat/users/helpdesk/website/-/a/2/e/9/a2e9e45c125af800/1Some readers
  • Credentials for Demo Admin - WeltPixel products
    Credentials for accessing the WeltPixel Demo Admin are not required. If you are prompted for Magento credentials when trying to access the demo: Open the Demo Admin in an Incognito/Private Browsing tab. It should log you in automatically without requiring credentials. Still Having Issues? If the problem persists after trying the steps above, please contact our support team for assistance.Some readers
  • OWL Carousel / Sliders not showing up - common issues
    If your OWL Carousel / Sliders are not showing up in the storefront, there are a few common configuration issues that may be causing the problem. Below are the most frequent scenarios and how to resolve them. 1. Banner not showing in Slider The most common issue is setting an invalid visibility interval. Each banner can have a Valid From and Valid To date. If this interval is invalid (for example, set in the past), the banner will not show up in your slider. If ySome readers
  • How to customize the width for your store sections in Magento 2 Pearl Theme
    Adjusting the dimensions of your store layout can significantly improve customer experience by creating visual balance and harmony across all sections. Pearl Theme makes it simple to control widths for various elements via the Admin panel. Step 1: Adjust Store Section Widths Go to: Admin → WeltPixel → Pearl Theme Options → Frontend Options Key Notes WiSome readers
  • How we solved Braintree & Magento 2 checkout issues with our Magento 2.1 store
    Braintree checkout error message Summary After investigation, we found three independent causes behind Braintree checkout failures on Magento 2.1. Applying the solutions below reduced declines significantly; we stopped receiving reports of failed checkouts. Issue Some customers saw: “An error occurred on the server. Please try to place the ordeSome readers
  • How to make sure Magento 2 Pearl Theme admin option changes apply in storefront
    To ensure that changes made in the Pearl Theme Admin options are correctly applied to the storefront, follow these steps: 1. Clear Related Caches After updating theme settings, clear all related caches: Regenerate Pearl Theme CSS Flush Magento Cache Clear Browser Cache If necessary, also: Flush JS/CSS Cache Flush Catalog Images Files Flush Cache Storage RegenerateLESS.png (https://storage.crisp.chat/users/helpdesk/website/-/c/a/c/0/cac01d4af86eaSome readers
  • Page cache issue "Uncaught TypeError: element.prop is not a function" with Magento 2.0-2.1.x
    Fixing the Page Cache Bug in Magento 2.0–2.1.x When Using Pearl Theme Starting with Magento 2.2.0, a known page cache bug (GitHub issue 6818) was fixed by the Magento development team. Since this issue was originally patched in the Pearl Theme, starting with Pearl Theme v1.5.5, the custom theme-level fix was removed in favor of the official Magento fix. This means: If you are using Pearl Theme v1.5.5 or later on Magento 2.2.0 or newer, the issue is already rFew readers
  • How to install the Pearl Theme on Magento Commerce Cloud - using UNIX systems
    This guide covers installing the Pearl Theme on Magento Commerce Cloud environments where Static Content Deployment (SCD) happens in the Deploy hook. If your environment has SCD in the Build hook, follow this guide instead: How to install the Pearl Theme on Magento Cloud - Ideal State Environment. Step 1. Clone the Cloud repository on UNIXFew readers
  • Instagram widget - picture quality and layout optimization
    The Instagram API handles picture formats in a specific way, which directly affects how images appear in the Instagram widget. Image Format and Quality 150x150 resolution Images are retrieved in a square format, regardless of the original aspect ratio. This ensures uniformity but can crop or distort images. 306x306 or 612x612 resolution Images display in higher quality. The original aspect ratio of the Instagram post is preserved. This mayFew readers
  • Magento 2.4 & Extension Development
    magento-2-4-extension-compatibility.jpg With eCommerce being more dynamic than ever before, the Magento 2 platform is shifting into high gear, releasing updates regularly. This is fantastic for performance, security, and overall growth, but it also brings a downside many merchants face: incompatibilities. New Magento releases often rewrite or change core functionalitFew readers
  • Area is already set error in Magento 2.2.4 and 2.2.5
    Error Message: Something went wrong while saving this configuration: Area is already set This is a known Magento issue affecting versions 2.2.4 and 2.2.5. It is unrelated to third-party products, including ours. An official fix was scheduled for Magento 2.2.6. You can track the original report here: Magento GitHub Issue 14968 Official Patch Magento has released an official patch to fix this problem. DownloaFew readers
  • Add theme features to the homepage or any other CMS page or block using the Pearl Theme
    The Pearl Theme comes with a wide variety of built-in features that can be added directly into your homepage, CMS pages, or CMS blocks to enhance design and functionality. Where to Find Sample Feature Pages When you install the Pearl Theme with sample data, you’ll get preconfigured CMS pages that showcase each feature. You can access them under: Admin → Content → CMS Pages → weltpixel- featurepagename ✅ Simply copy the desired content from one of these sample pages and pastFew readers
  • Navigation / Mega menu missing when Varnish Cache is activated with Magento 2
    In some cases, when Varnish Cache is activated, the navigation/mega menu may disappear. This occurs due to a known Magento 2 + Varnish issue. Solution To fix this, you need to remove the TTL attribute from Magento’s default layout file: Open the file: /vendor/magento/module-theme/view/frontend/layout/default.xml Locate the following line: ttl="3600" Remove the ttl="3600" attribute and save the file. After this change, the navigation menu sFew readers
  • Unable to save WeltPixel and WeltPixel Mega Menu Options under Category settings
    We've occasionally received reports from Pearl Theme users who mention not being able to save WeltPixel Options and WeltPixel Mega Menu Options under Catalog → Categories in the Magento Admin. In most cases, the save action appears to work, but the options remain unchanged. Possible Cause This issue seems to occur most often in stores where Products or Categories were migrated from another Magento installation. During migration, certain database entries may not regisFew readers
  • Magento 2 Google Tag Manager / Google Analytics 4 - Missing or incomplete transactions/revenue
    One of the most crucial functionalities an online store can benefit from is good data analytics. This is achieved by proper implementation of Google Analytics tracking, and, more recently, Google Analytics 4. For the Magento 2 platform, we've made this process a simple one via our hugely popular Magento 2 Google Tag Manager - Enhanced eCommerce (Universal Analytics) extension, which is used by over 11000Few readers
  • Changing Slider and Carousel transition timing. Sort order on Banners.
    1) Changing Slider Transition Timing To adjust the transition timing of your slider: Navigate to Admin → WeltPixel → Sliders Manager. Select the slider you want to edit and click Edit. Scroll down to the Autoplay section. Locate the Autoplay Timeout box. The value is set in milliseconds. Example: 10000 → the slider will change every 10 seconds. Slider Autoplay Timeout (https://storage.crisp.chat/users/helpdesk/website/-/8/1/3/2/Few readers
  • Support & Product Updates
    We know how important it is to maintain product compatibility with new Magento versions, security patches, PHP versions, Elastic Search, and more. This takes significant work, and we’re proud to handle it for our customers. For over 10 years, we’ve maintained compatibility for all our products without any additional costs beyond the initial purchase. However, as the Magento ecosystem has evolved, we’ve reached a point where we need to choose between two paths: AbFew readers
  • Potential fix case for Uncaught SyntaxError: Unexpected end of JSON input - Console error displayed on all pages
    Sometimes, after editing the content on your CMS Pages or Blocks, you may encounter the following console error on the frontend of your store: Uncaught SyntaxError: Unexpected end of JSON input This error may show up on specific pages or across all pages. It can also be accompanied by loss of functionality such as submenus not opening, store switcher dropdowns not working, etc. Applicability This issue often applies to stores built with our Pearl Theme for Magento 2 (https://wwwFew readers
  • Magento 2 Mega Menu - Uncaught TypeError: base is not a constructor
    If you’re using the Magento 2 Mega Menu extension, you may occasionally see a console error like this: Mega Menu console error This typically results in the menu not functioning (e.g., dropdowns/subcategories won’t open). Cause A conflict with a third-party module that also applies a mixin toFew readers
  • Pictures / Images not showing in category page after updating from M2.2.x to Magento 2.3
    After upgrading from Magento 2.2.x to Magento 2.3, product/category images may not show on category pages. This happens because Magento is still trying to load images from old cached paths that were cleared during the upgrade. Fix Steps Reindex the Catalog Follow this guide for detailed reindex instructions: How to Reindex Your Magento 2 Store from Admin or SSH/CLI (https://help.weltpixel.com/en/article/how-to-reindex-your-magento-2-store-from-admin-or-ssh-cli-Few readers
  • License key for local / staging / development environment. Multi-store licensing.
    1. Licensed domain WeltPixel products can be installed on up to 5 subdomains of the licensed domain for testing purposes, including those ending in .local, .dev, .development, .staging, or .stage. A single license covers all installations. You can install locally or on another Magento instance and use the same license key generated for the licensed domain. 2. Licensing for local, staging, and development environments *Example: Licensed domain = https://wwwFew readers
  • Choosing the right Magento 2 hosting
    hosting1.png Choosing the best web hosting for your needs is one of the key components to having a successful online business, especially when your business is running on Magento 2. Past Magento 2 installation experiences made us deal with a lot of low performance, unsecured, unoptimized servers that transformed the eCommerce business in a time-consuming experience witFew readers
  • How to verify the root of my Magento installation using SSH?
    When working with Magento 2, you’re often asked by extension providers to connect via SSH to the root of your Magento installation to run installation commands. If you have multiple Magento installs on your server, it can be confusing to identify the correct one. Follow these steps to verify that you are in the right place. Step 1 — Connect via SSH Connect to your server using an SSH client. Your hosting provider should supply the SSH credentials. If you have connectionFew readers
  • How to add and use a custom font in Pearl Theme Magento 2 ?
    Note: The Pearl Theme uses Google Fonts by default. To add a custom (local) font, make CSS changes in your Pearl Child Theme and override the desired headings with your new font. Use one of the solutions below. Solution 1 — Include the font per Magento docs (recommended) Follow the official Magento guide for using custom fonts in a theme: https://devdocs.magento.com/guides/v2.0/frontend-dev-guide/css-topics/using-fonts.html *(Tip: Place your font files in your chiFew readers
  • MIME type error - Refused to apply style / Refused to execute script. Strict MIME checking is enabled
    Symptom: Refused to apply style / Refused to execute script due to Strict MIME checking. This usually occurs when Magento hasn’t generated static content correctly. It can also appear on a vanilla Magento install and isn’t necessarily related to a theme or extension. In most cases, the error disappears after setting correct permissions and regenerating static content. Solution 1 — Fix permissions, switch modes, and deploy static content Set correct MageFew readers
  • Magento 2 - Using Google Fonts in Email Templates
    Some email clients support web fonts (including Google Fonts). A common example is Mozilla Thunderbird. While most clients still do not support web fonts (including Gmail, Yahoo, and Outlook — see this reference on client support: Can I use Google Fonts in my email?), you may still want to enable them for users on compatible clients. Here’s how to set this up in Magento 2. Prerequisites To uFew readers
  • How to speed up your Magento 2 store and increase performance
    There are multiple ways to optimize your Magento 2 store for speed and performance. Ideally, combine as many of the items below as possible. Note: If you’re using our Pearl Theme for Magento 2, see this companion guide: How to speed up your Magento 2 store with the Pearl Theme. 1) Enable All Magento Caches Path: System → Cache ManagemeFew readers
  • Instagram widget not showing Tags or Location feed
    When you create an app on the Instagram Platform, it starts in Sandbox mode. This mode is designed for development and testing before submitting the app for review and going live. v2.png Understanding Sandbox Mode Restrictions Data is restricted to sandbox users only. You can only access the 20 most recent media items from each sandbox user. As aFew readers
  • 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/weltpixelcustom/web/css/source/wpFew readers
  • Google Analytics Tag Manager GTM with One Page Checkout OPC - compatibility
    Google Analytics Enhanced Ecommerce (WeltPixel GTM) is compatible with the default Magento 2 Checkout. Custom/One Page Checkout (OPC) Compatibility If a custom checkout (OPC or other) uses Magento 2’s standard API calls, tracking data should be pushed correctly. If the custom checkout alters how API calls are handled or changes the checkout flow, the extension may require compatibility adjustments. In most cases, only the checkout step events are aFew readers
  • How to set product page Layout and Image Size in Pearl Theme for Magento 2
    1. Select Product Page Version The Pearl Theme offers 4 product page layouts. You can preview them in the Pearl Theme Demo Store. Selecting product page version in Pearl Theme Product Page V1 is built on the default Magento product page structure. Product Page V2, V3, and V4 use custom layouts, so some admin options mayFew readers
  • How can I upgrade/update the Pearl Theme to the latest version?
    When a Pearl Theme update is released, it’s strongly recommended to install it since new versions contain added features and fixes for reported issues. To avoid potential problems, follow the upgrade process outlined below. Prerequisites before the upgrade ! Important: Always back up your code and database before performing an upgrade. !! Important: If you extended the theme with customizations, ensure those are placed in a Child Theme so your changes are not lost. By fFew readers
  • How to install extension if purchased from Magento Marketplace
    Installing via Composer CLI Commands Composer CLI is the only supported method to install Magento 2 modules, as Magento has deprecated the Web Setup Wizard. Step 1 — Check Compatibility Before installing, verify that the extension is compatible with your Magento version. WeltPixel Marketplace extensions are compatible with Magento 2.3.X – 2.4.X. Always install on a development/staging server first, then move to production after verifying functionality. SteFew readers
  • How to Go Live with Magento 2 in less than 30 days using the Pearl Theme - 50 step guide [tutorial]
    pearl-theme-magento2-hero.png A. Choose the right Magento 2 hosting 1) Select optimized Magento 2 hosting Picking the right host is critical for performance, security, and uptime—especially with Magento 2. This guide helps you evaluate providers: https://support.weltpixel.com/hc/en-us/articles/115004433688-Choosing-the-right-Magento-2-hosting B. Magento 2 installatFew readers
  • How to modify / extend a module in Magento 2 ?
    To modify or extend a Magento 2 module, always create your own custom module that extends the original instead of editing the vendor code. Why this approach? Keeps the original module unmodified, so you can upgrade to future versions without losing your changes. Lets you override layouts/templates and extend classes cleanly via Magento’s dependency injection and layout systems. Example: Extending the Quick View extension If you want to customize the QuicFew readers
  • Google Tag Manager - Sign in with Google temporarily disabled for this app
    A while back, Google placed apps created on their platform into a review process, disabling them temporarily until the review was finished. The Google Tag Manager extension uses a Sign in with Google functionality via an app (to connect to the Google API and generate Tags, Triggers, and Variables), which went under review as well. As a result, the Sign in functionality was disabled for all email addresses except those that had already been used with the app before. This caused the extFew readers
  • How to translate footer content - different language storeview
    If you have multiple store views in different languages, you can translate or customize the footer content for each store view individually. The best way to achieve this is to create footer blocks with the same identifier as the original footer and assign their visibility only to the corresponding store view. Example: Using Footer V3 for English and French Store Views Step 1 — Configure the English Footer Edit the original Footer V3 block and activate visibility onlyFew readers
  • Product Page Gallery Image won't close on Mobile - Known Magento Issue
    Issue: On mobile, if you go to a product page and open the image gallery of an item, clicking the upper-right “X” button does not close the gallery. This is a known Magento issue that has been reported by multiple users. You can track the progress and status of this bug here: Magento GitHub Issue 12185 ✅ Since this is a Magento core bug, no extension or theme fix is required. The resolution will depend on Magento’s official upFew readers
  • Ajax not working with Quick View / Quick Cart Magento 2
    WeltPixel extensions are built to follow Magento’s core architecture. However, if you are using third-party extensions, custom themes, or custom development that modifies Magento’s default behavior, you may sometimes encounter issues with functionality — including Ajax not working in Quick View or Quick Cart. This usually happens when the base files that our extensions rely on are modified by other code. Below are some troubleshooting steps and best practices to help you resolve tFew readers
  • How to customize the Primary and/or Default Buttons in Magento 2 Pearl Theme
    You can customize Primary and Default buttons in the Pearl Theme via the Frontend Options. Step 1 — Open Frontend Options Go to WeltPixel → Pearl Theme Options → Frontend Options from the Admin sidebar. Open Pearl Theme Frontend Options Step 2 — Choose the Store View Select the Store View you want to configure. Select Store View (https:/Few readers
  • Why Magento 2 Google Analytics Enhanced Ecommerce Tag Manager is FREE ?
    We believe that to successfully operate and grow an online store, merchants need access to reliable and accurate data. That’s why the Magento 2 Google Analytics Enhanced Ecommerce Tag Manager extension is offered for free. Why We Made It Free Access to good data is essential Every store owner should be able to track performance and customer behavior without technical barriers. Cleaner tracking implementation The extension provides a simple way to set upFew readers
  • Theme or extension bug / issue, check first Magento known issues
    Troubleshooting Bugs in Magento 2: Core vs. Third-Party Extensions When you encounter bugs in your Magento 2 installation, they may originate either from the Magento core functionality or from a third-party extension. Before starting to investigate issues in extensions, it’s important to first review Magento’s own list of known issues. Many problems reported by users are already documented there and may not be related to your extensions or theme at all. Why This MattersFew readers
  • Add social links to a static block or page?
    You can easily add footer social links to a static block or CMS page in Magento by inserting the following HTML snippet:Few readers
  • SQLSTATE: Column not found error on the frontend after installing a Magento theme or extension
    If you see a SQLSTATE: Column not found error on the storefront after installing a new theme or extension, it often occurs when the instance previously used a different theme or already had categories/products configured. Why this happens Installing a theme/extension can introduce new EAV attributes or change indexes. If Magento’s indexes are out of date, storefront queries may reference columns that aren’t materialized yet, resulting in a Column not found exception.Few readers
  • ReflectionException error on Magento 2.1.x when running bin/magento setup:di:compile
    Symptom Running bin/magento setup:di:compile on Magento 2.1.x fails with: ReflectionException Class MagentoFrameworkApiSearchCriteriaCollectionProcessorInterface does not exist Cause This error is triggered by the WeSupply Toolbox module on Magento 2.1.x only. It does not occur on Magento 2.2.x+. Solutions Solution 1 — Remove the module (if you don’t use it) If you do not need the WeSupply Toolbox module: Remove the directory: app/code/WeSupplyFew readers
  • How can I check Pearl Theme release version in Magento Marketplace?
    Step 1. Go to your account on Magento Marketplace by following this link HERE, log in, and access My Purchases under the Marketplace section as shown in the screenshot below. Magento Marketplace My Purchases Step 2. Under My Purchases, click on the Themes tab. You should now see the latest availFew readers
  • How to add a Global Promo Message for Magento 2 Pearl Theme
    When running a special campaign or announcement, you can use the Global Promo Message feature in the Pearl Theme for Magento 2 to reach your customers effectively. Step 1 — Edit the Global Promo Block Go to: Admin → Content → Elements → Blocks Look for the static block WeltPixel Global Promo Message (you can use filters to find it). (https://storFew readers
  • How to customize Breadcrumbs for Pearl Theme Magento 2
    Breadcrumbs help customers understand where they are within your store. Here’s how you can customize them in the Pearl Theme: Step 1 — Open Frontend Options From the Admin sidebar, go to WeltPixel → Pearl Theme Options → Frontend Options. Open Frontend Options Step 2 — Select Store View Choose the Store View you want to apply changes to. SeFew readers
  • Benefits of using Quick View in your Magento Store + Free Extension
    Online shopping is growing in popularity every day. While it brings many advantages, one common frustration is having to navigate to a product detail page just to see more information or images. This is where Quick View comes in. The Magento 2 Quick View extension makes browsing and purchasing faster and easier by letting customers view product details in a pop-up window without leaving the product listing page. Benefits of Using Quick View Saves time for shoppers CusFew readers
  • How to change Pearl Theme name to a Random theme name
    Renaming the Pearl Theme is best done by creating a child theme that extends Pearl and giving that child a custom name. You can use Magento’s standard child theme approach or start from the child theme that ships with the Pearl Theme pack. 1) Copy the bundled child theme Copy the provided child theme from /app/design/frontend/Pearl/weltpixelcustom to a new path, for example: /app/design/frontend/MyTheme/my-theme/ 2) Update theme.xml Edit: /app/design/frontFew readers
  • How to use Pearl Theme on multiple store views. Important update / install instructions
    Starting with Pearl Theme release 1.5.5 (October 20, 2017), Frontend Options moved to the store view scope. Because of this, sharing the same theme and the same locale across multiple stores/store views will cause LESS/CSS files to overwrite each other, which can lead to design or functionality issues. To avoid conflicts, ensure each store/store view has its own set of LESS/CSS files. Use one of the two approaches below. Important note: If you upgraded from a version older tFew readers
  • How to customize category pages with Pearl Theme for Magento 2 ?
    You can customize individual category pages in the Pearl Theme by adding CSS and JS directly from the Magento Admin. Pearl introduces dedicated fields so you can target a single category without editing theme files. Configure Global Breakpoints and CSS Set your responsive breakpoints in: WeltPixel → Pearl Theme Options → Frontend Options → Breakpoints Define breakpoints for mobile, tablet, and large screens. Use Custom Global CSS to apply CSS site-wide, rFew readers
  • How to debug: use WeltPixel Debugger and fix Magento 2 extension conflicts
    WeltPixel Debugger ships with every WeltPixel extension as part of the shared Backend package and works with all installed extensions—not just WeltPixel products. Its goal is to quickly surface potential conflicts so you can debug faster. Why conflicts happen When multiple third-party modules try to change the same Magento class or behavior (e.g., via di.xml preferences or plugins), one may override the other. This can break or change functionality in unexpected ways.Few readers
  • How to install Pearl Responsive Theme - 1 minute installation GUI
    Step 1 Unpack and upload the contents of the Theme Files directory into the root of your Magento installation. Step 2 Open your browser and navigate to: Follow the installation steps in the graphical interface. You can revisit Step 5–6 at any time to restore the default Pearl Theme settings. ⚠️ Important: Your store must be in Developer Mode before proceeding. How to enable Developer Mode (https://Few readers
  • Declaration of WeltPixel\CategoryPage\Block\Product\ImageBuilder::create() should be compatible with - How To Solve
    Sometimes, during code compilation via CLI or even on the storefront, you may encounter warnings like: Declaration of WeltPixelCategoryPageBlockProductImageBuilder::create() should be compatible with ... This guide explains why it happens and how to fix it. Cause An incompatibility between the installed WeltPixel extension / Pearl Theme files and your Magento version. Why this happens Starting with Magento 2.3.0, our codebase was split into tFew readers
  • Pearl Theme styles not applied or design issues after switching Magento to Production Mode?
    If you notice styles not applying or design issues after switching Magento to Production Mode, make sure you regenerate the Pearl Theme LESS/CSS after enabling Production Mode. What to Do You can regenerate from Admin or via SSH. Option A — From Admin Go to System → Tools → Cache Management and use Regenerate Pearl Theme LESS/CSS files. Regenerate Pearl Theme LESS/CSS (https://storage.crisp.chat/users/helpdesk/website/-/b/3/6/5/b36596e975ff8800Few readers
  • I purchased Pearl Responsive Theme via Magento Marketplace and I can't install it, can you help?
    Magento Marketplace delivers Extensions, Themes, and Dependency Packs in three separate locations: Extensions – purchased extensions Themes – purchased themes Packages – dependency packs required by some themes/extensions (must be installed) marketplace3.png Step 1: Download theme + all dependencies Download the Pearl TFew readers
  • How can I extend the support period for my WeltPixel products?
    You can check your support period expiration date by logging in to your WeltPixel account and navigating to the Downloadable Products section. There, you'll see the list of all your purchased WeltPixel products. To extend your Support & Updates Period, click the Extend Support link for the specific product. You will be redirected to the Purchase Support & UpdaFew readers
  • How to solve compatibility issues - Google Tag Manager Enhanced eCommerce and Google Analytics 4
    If you’ve installed Google Tag Manager Enhanced eCommerce or Google Analytics 4 and your product grid breaks or actions aren’t tracked (e.g., product view, add to cart, checkout), the cause is usually a compatibility conflict with a custom theme or a 3rd-party extension that alters Magento’s default templates/blocks. We guarantee full compatibility with default Magento 2 and our Pearl Theme. Other themes may customize category/product listing templates, requiring smaFew readers
  • How to Install the Pearl Theme on a Magento Cloud - Ideal State environment
    The process for installing the theme on Magento Cloud environments where the SCD happens in the Deploy hook can be found here: How to install the Pearl Theme on Magento Commerce Cloud - using UNIX systems Magento’s Ideal State, however, requires the SCD to happen in the Build hook, which is an issue for Pearl Theme because there’s no DB access there and theFew readers
  • How to use GRUNT for Magento 2 and Pearl Theme [step by step Tutorial]
    Make sure your Magento application is in developer mode before you begin. Note: You might need root privileges for some commands. If a command fails, retry it with sudo. Step 1 — Install Node.js Example for Debian/Ubuntu: For other Node.js versions, see: NodeSource Distributions Step 2 — Install the Grunt CLI glFew readers
  • How NS8 Protect defends Magento shops against fraud
    WeltPixel partnered with NS8 Protect™ to help Magento merchants reduce order and advertising fraud. Learn how NS8 Fraud Prevention works, or continue below for a detailed breakdown. How NS8 Protect Works NS8 Protect uses behavioral analytics, real-time user scoring, and global monitoring to detect bots and malicious activity threatening Magento storefronts. It installs via a one-click process from the Magento MarketplacFew readers
  • How LESS / CSS Generation works in Pearl Theme & Magento [developer corner]
    Why LESS/CSS generation is needed Short answer: performance & best practice. Pearl Theme offers many admin options for functionality, layout, and design. Instead of piling overrides on top of Magento’s CSS (the Magento 1 way), Pearl reuses Magento variables and generates LESS dynamically from your admin settings so it can be merged with Magento’s own LESS before CSS is built. This avoids duplicate CSS and keeps output lean. 1) LESS generation in Pearl Theme Some modFew readers
  • How to create a Size Chart on product page using Smart Product Tabs
    You can use Smart Product Tabs to display different Size Charts for men’s and women’s clothing directly on the product page. Here’s how to set it up: Step 1 — Enable Smart Product Tabs Go to: Admin → WeltPixel → Smart Product Tab Settings → General settings for Smart Product Tabs Grid: Enable Screenshot149.jpeg Step 2 — Create the Size ChaFew readers
  • How can I show product swatches on my category page?
    To display product swatches on category pages, enable swatch visibility in the Pearl Theme settings. Enable Swatches on Category Pages Go to: Pearl Theme → Theme Options → Category Page → Swatch Options Display Swatches — Show swatches on products in category pages: Options: No / Yes / On Hover Set this to Yes (always visible) or On Hover to show swatches on category pages. Additional Swatch Options In *Pearl Theme → Theme Options → CategoryFew readers
  • How to overcome Cookie restriction issues in Magento 2.1.x. (Google Tag Manager and Google Analytics cookie fix).
    In Magento 2.1.x, enabling Cookie Restriction Mode can cause issues with Google Tag Manager (GTM) and Google Analytics (GA) tracking. Due to a bug (GitHub issue 5596), Magento does not display GA or GTM tracking scripts, even if the user has accepted cookies. Solutions There are several ways to resolve this issue: Deactivate Cookie Restriction Mode This will bypass the issue, but it may not be suitable ifFew readers
  • How do I check the theme / product / extension version and change log?
    You can easily check which version of a WeltPixel product you’re running and whether updates are available. Follow these steps: Step 1: Open the Extension Version section Go to Admin → WeltPixel → WeltPixel Debugger → Extension Version. ⚠️ If this menu is missing, you’re using an outdated version of the WeltPixel extension. Extensionversion1.pngFew readers
  • How to set the search design and Ajax search functionality in Magento 2 using the Pearl Theme
    The Pearl Theme provides flexible, out-of-the-box design options for both the header search and Ajax search results. You can select from multiple layouts and fine-tune them to match your store’s branding. Header Search Design You can choose between two header search versions: Version 1 – Default Magento search Version 2 – Enhanced Pearl Theme search To configure: Admin Store Configuration Custom Header Search Options Search Version Search Version 1 (deFew readers
  • How to customize a page / block with Pearl Theme for Magento 2?
    It’s easy to add simple customizations to pages and blocks in the Pearl Theme by inserting custom CSS and JS in the options provided for each entity. Where breakpoints come from Pearl lets you define responsive breakpoints that your custom CSS can target. Path: WeltPixel → Frontend Options → Breakpoints Set breakpoints for mobile, tablet, and large screens, then write CSS that uses those breakpoints. Add custom CSS/JS to a CMS Page Path: ContFew readers
  • How to customize product labels like New, Sale, 20% OFF, etc..
    The Product Labels extension lets you place labels, ribbons, or tags (e.g., NEW, SALE, 20% OFF) on specific products and show them on Category and Product pages. You can start with a ready-made set of artwork by downloading our sample Product Label images and uploading them, then adjusting as needed. Case: “20% OFF” Sale Campaign In Admin → Marketing → Catalog Price Rule, create a rule that appFew readers
  • How to set up Form Inputs in Pearl Theme Magento 2
    Customizing Form Inputs in the Pearl Theme is quick and easy. Follow these steps: Step 1 — Open Frontend Options From the Admin sidebar, go to WeltPixel → Pearl Theme Options → Frontend Options. Open Pearl Theme Frontend Options Step 2 — Select Store View Choose the Store View where you want to apply changes. Select Store View (https://storFew readers
  • How to use composer and install Pearl Theme or other WeltPixel extensions
    Note: At this time, Pearl Theme and individual WeltPixel extensions are kept in private repositories and Composer installs from our repos are for internal use only. We may automate access for Pearl users in the future. Until then, you can still install via Composer by creating your own private repos that mirror the theme’s modular structure. Overview Pearl is modular (≈20 modules). To install it via Composer, create private repositories in your organization for each PFew readers
  • How to set your store Headings in Magento 2 Pearl Theme
    ! Please make sure your Magento 2 store is in Developer Mode. More details on this topic here. Step 1 Go to Admin sidebar → WeltPixel → Pearl Theme Options → Frontend Options. Step 2 Select your store from Store View. (https://storage.crFew readers
  • How to change the Contact Page version in the Pearl Theme. Edit contact info.
    The Pearl Theme provides 2 contact page designs out of the box: Contact Page V1 (default Magento) Contact Page V2 (WeltPixel contact page) Choose a Contact Page Version Go to: Admin → Store → Configuration → Frontend Options → Contact Options → Contact Page Version Contact Page Version 1 (Default Magento) Change contact details from: Admin → Content → CMS Blocks → contact-us-info → Edit ContactPagev1.png (https://storage.crisp.chat/users/helpdFew readers
  • How to set a different product page in Pearl Theme for Magento 2?
    Step 1 Go to Admin → WeltPixel → Product Page and select the corresponding Store View using the store selector in the upper left corner. Important: If you only update the Default Config, changes will not reflect on your storefront. Step 2 Go to Product View Version → Version and select one of the predefined demo product pages included with the Pearl Theme. All customization options are available in Version 1. Some options may not be available in otheFew readers
  • How to change Store Logo in Magento 2 Pearl Theme
    Using the Pearl Theme, you can set different logos for Desktop and Mobile views. Follow the steps below to change your store’s logo. Change the Desktop Logo Step 1 — Access Design Configuration Go to: Admin → Content → Design → Configuration Magento Admin - Design Configuration page Note: If you have multiple stores, select the desFew readers
  • How to Export / Import configurations - Pearl Theme for Magento 2
    You can export and import Pearl Theme and WeltPixel module configurations via CLI from the root of your Magento installation. 1) Export Pearl Theme configurations First, list available store codes (case sensitive): Run: php bin/magento store:list Then export the configurations for the desired store (replace default with your store code if different): Run: php bin/magento weltpixel:export:configurations --store=default This exports settings for: Frontend OptiFew readers
  • How to translate the Pearl Theme, WeltPixel module or Magento 2 in another language.
    You can translate the Pearl Theme, WeltPixel modules, and Magento 2 into another language using Magento’s built-in translation system. A. Translate Pearl Theme From the root of your Magento installation, run the following command to export all theme and Magento phrases: Locate the generated dictionary.csv file in your Magento root directory. The file contains four columns.Few readers
  • How to become a WeltPixel affiliate and get paid for each referral
    Update The WeltPixel Affiliate Program has been discontinued as of July 3, 2018. We may review and relaunch the affiliate program in the future under a different approach, but for now, the current program is no longer available.Few readers
  • How to customize your header in Magento 2 using Pearl Theme options
    The Header is one of the most important sections of your online store—it’s the first element customers interact with. Pearl Theme allows you to fully customize it to match your brand and business needs. Step 1: Access the Header Settings Go to: Admin → WeltPixel → Pearl Theme Options → Custom Header ➡️ From General Settings → Custom Header → Header StylFew readers
  • How to customize the Rating section for Magento 2 Pearl Theme
    Step 1. Go to WeltPixel → Pearl Theme Options → Frontend Options from the Admin sidebar. Open Pearl Theme Frontend Options Step 2. Select the desired Store View. Select Store View Step 3. Scroll to Ratings and confFew readers
  • How to set a Homepage as the default page for my Magento store?
    Once the Pearl Theme is installed, you can easily switch between the sample homepages. This can be done either manually or using the Demo Settings Import. Option 1: Change Homepage with Manual Setup a) Set the desired Homepage as default Go to: Magento Admin → Stores → Configuration → Web → Default Pages Select your desired homepage (e.g., *HomepageFew readers
  • How to install sample content to look like Pearl Demo store?
    To set up your store with Pearl Theme sample content and make it look like the Pearl Demo Store, follow the instructions in the guide below: How can I restore Pearl Theme default settings? This article provides step-by-step instructions on installing sample data and restoring default Pearl Theme settings so your store mirrors the demo envFew readers

Not finding what you are looking for?

Chat with us or send us an email.

  • Chat with us
  • Send us an email
© 2026WeltPixel Help CenterWe run on Crisp Knowledge.