Articles on: Magento 2 Pearl Theme User Guide

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 installation


2) Install Magento 2 (optional)

Many hosts provide pre-installed Magento. If not, use this step-by-step Composer guide to install Magento 2 via SSH:

https://support.weltpixel.com/hc/en-us/articles/115004531428-How-to-install-Magento-2-with-sample-data-via-Composer-Step-by-step-guide-



C. Pearl Theme installation


3) Install the Pearl Theme for Magento 2

Use the quick GUI installer to get the theme running fast:

https://www.weltpixel.com/resources/PearlTheme/User-Guide-WeltPixel-Pearl-Theme-Magento2.html#quick-GUI-installation




D. Magento catalog configuration


4) Add/import products and categories

Populate a few products and categories first so you can see real layouts while configuring design options. Official docs by product type:

https://docs.magento.com/m2/ce/user_guide/catalog.html



E. Design configuration with Pearl Theme


5) Set page widths for store sections

You can run a full-width homepage and use a fixed max-width (e.g., 1400px) for category, product, and default pages. Configuration details:

https://support.weltpixel.com/hc/en-us/articles/115003702133-How-to-customize-the-width-for-your-store-sections-in-Magento-2-Pearl-Theme


6) Configure the header and upload your logo

a) Choose a header style (V1–V4) and adjust colors, sticky behavior (desktop/mobile), icons, and more. Demo: https://pearl.weltpixel.com

Guide: https://support.weltpixel.com/hc/en-us/articles/115003628833-How-to-customize-your-header-in-Magento-2-Pearl


b) Upload your logo and apply your brand:

https://www.weltpixel.com/resources/PearlTheme/User-Guide-WeltPixel-Pearl-Theme-Magento2.html#how-to-change-logo


c) Set a global promo or “demo store” message if needed:

https://www.weltpixel.com/resources/PearlTheme/User-Guide-WeltPixel-Pearl-Theme-Magento2.html#general-settings


7) Configure search design (header) and Ajax Search results

  • Header Search: Version 1 (default) or Version 2
  • Ajax Results: Version 1, Version 2 (White / Horizontal), Version 2 (Black / Vertical)

Guide: https://support.weltpixel.com/hc/en-us/articles/360007977453-How-to-set-the-search-design-and-ajax-search-functionality-in-Magento-2-using-Pearl-Theme


Configure the Mega Menu

Create professional, flexible navigation (default/sectioned/boxed/full-width) and set mobile breakpoints. Demo: https://pearl.weltpixel.com

Guide: https://www.weltpixel.com/resources/PearlTheme/User-Guide-WeltPixel-Pearl-Theme-Magento2.html#mega-menu


9) Set up the footer (version/logo/links)

a) Choose Footer V1–V4

b) Configure the Pre-footer

Demo: https://pearl.weltpixel.com

Guide: https://www.weltpixel.com/resources/PearlTheme/User-Guide-WeltPixel-Pearl-Theme-Magento2.html#prefooter-footer


10) Build your homepage with Pearl elements

https://support.weltpixel.com/hc/en-us/articles/115005199487-How-to-set-a-Homepage-as-default-page-for-my-Magento-store-

https://support.weltpixel.com/hc/en-us/articles/360007984653-Add-theme-features-to-homepage-or-any-other-CMS-page-or-block-using-Pearl-Theme


11) Configure category page layout

  • Choose hover details and which elements display
  • Set grid (2/3/4/5 products per row)
  • Configure toolbar and pagination
  • Show/hide item elements (hover and non-hover)

Guide: https://www.weltpixel.com/resources/PearlTheme/User-Guide-WeltPixel-Pearl-Theme-Magento2.html#category-page

  • Enable Quick View (Design V1/V2):

https://www.weltpixel.com/resources/PearlTheme/User-Guide-WeltPixel-Pearl-Theme-Magento2.html#quick-view


12) Configure product page layout

Demo: https://pearl.weltpixel.com

  • Gallery/Info layout (V1–V4 or custom)
  • Tabs/accordion

Guide: https://www.weltpixel.com/resources/PearlTheme/User-Guide-WeltPixel-Pearl-Theme-Magento2.html#product-page


13) Store identity and other settings

  • Button and store colors
  • Fonts
  • Store links
  • Ratings color
  • Breadcrumbs
  • Back to top button

Guide: https://www.weltpixel.com/resources/PearlTheme/User-Guide-WeltPixel-Pearl-Theme-Magento2.html#frontend-options


14) Configure the Contact page and contact info

Two designs included:

  • Contact Page V1 (default Magento)
  • Contact Page V2 (WeltPixel)

Guide: https://support.weltpixel.com/hc/en-us/articles/360007880294-How-to-change-Contact-Page-version-in-Pearl-Theme-Edit-contact-info-


15) Configure the Custom Thank You Page

Included in the Pearl Theme Pack (adds newsletter signup, custom blocks, and more).

https://www.weltpixel.com/custom-checkout-thank-you-page.html


16) Configure store emails

a) Enhanced Emails (Professional Pack) — responsive templates with editor + Gmail markup:

https://www.weltpixel.com/magento-2-email-template-editor-with-gmail-markup-support.html

b) Default Magento emails:

https://docs.magento.com/m2/ce/user_guide/configuration/sales/sales-emails.html



F. Performance and SEO


17) Configure an advanced XML sitemap

Included in the Pearl Pack. Generate sitemaps and control visibility for products, categories, CMS, plus add custom URLs with attributes.

https://www.weltpixel.com/resources/PearlTheme/User-Guide-WeltPixel-Pearl-Theme-Magento2.html#sitemap


18) Enable Rich Snippets

Included in the Pearl Pack. Add Google Rich Results, Open Graph, Twitter Cards, and Pinterest Rich Pins.

https://www.weltpixel.com/resources/PearlTheme/User-Guide-WeltPixel-Pearl-Theme-Magento2.html#rich-snippets


19) Use Ajax Layered Navigation with multi-select

Included in the Pearl Pack. Help customers filter fast (size, color, material, price, etc.) and boost conversion.

https://www.weltpixel.com/resources/PearlTheme/User-Guide-WeltPixel-Pearl-Theme-Magento2.html#layered-navigation


20) Enable Ajax Infinite Scroll or Ajax pagination

Included in the Pearl Pack. Reduce friction and help users browse more products.

https://www.weltpixel.com/resources/PearlTheme/User-Guide-WeltPixel-Pearl-Theme-Magento2.html#ajax-catalog


21) Enable Lazy Loading for images

Included in the Pearl Pack. Load images on scroll across listings, search, PDPs (incl. related/up-sell/cross-sell) to speed up pages.

https://www.weltpixel.com/magento-2-lazy-load-product-extension.html



G. Enhanced analytics and GTM


22) Set up Google Tag Manager & Enhanced Ecommerce

Included in the Pearl Pack. Get full Enhanced Ecommerce tracking with GTM in minutes.

https://www.weltpixel.com/resources/PearlTheme/User-Guide-WeltPixel-Pearl-Theme-Magento2.html#analytics



H. Store setup configuration


23) Country options

https://docs.magento.com/m2/ce/user_guide/stores/country-options.html


24) State options

https://docs.magento.com/m2/ce/user_guide/stores/state-options.html


25) Locale/language settings

https://docs.magento.com/m2/ce/user_guide/stores/locale-options.html


26) Store information

https://docs.magento.com/m2/ce/user_guide/stores/store-information.html


27) Currency setup

https://docs.magento.com/m2/ce/user_guide/stores/currency.html


28) Store email addresses

https://docs.magento.com/m2/ce/user_guide/stores/store-email-addresses.html


29) Taxes

https://docs.magento.com/m2/ce/user_guide/tax/tax-settings-general.html


30) Shipping origin

https://docs.magento.com/m2/ce/user_guide/shipping/point-of-origin.html


31) Shipping methods/rates

https://docs.magento.com/m2/ce/user_guide/shipping/methods-basic.html


32) Payment methods

https://docs.magento.com/m2/ce/user_guide/payment/payment-methods.html


33) Favicon

https://docs.magento.com/m2/ce/user_guide/design/favicon.html


34) Welcome message

https://docs.magento.com/m2/ce/user_guide/design/welcome-message.html


35) Copyright notice

https://docs.magento.com/m2/ce/user_guide/design/copyright-notice.html



I. Speed optimizations


36) Disable unused features & use Advanced Bundling (Speed Optimization module)

https://support.weltpixel.com/hc/en-us/articles/360007965373-Improve-Magento-store-speed-Disable-unused-Pearl-Theme-extensions-and-Design-Elements


37) Follow the Magento 2 speed guide

https://support.weltpixel.com/hc/en-us/articles/115003450474-How-to-speed-up-your-Magento-2-store-and-increase-performance-



J. Extra features


38) Multi-Store, Multi-Brand

Included in the Pearl Pack. Show Brands/Languages in the header and allow seamless cross-store purchasing.

https://www.weltpixel.com/multi-store-multi-brand-language-magento-2.html


Also see:

https://support.weltpixel.com/hc/en-us/articles/115003645074-How-to-use-Pearl-Theme-on-multiple-store-views-Important-update-install-instructions


39) Smart Product Tabs

Included in the Pearl Pack. Dynamically add tabs on PDPs based on attribute values (no code).

https://www.weltpixel.com/smart-product-tabs.html


40) Instagram integration

Included in the Pearl Pack. Showcase your Instagram feed anywhere.

https://www.weltpixel.com/instagram-widget-advanced-for-magento-2.html


41) CMS Block Scheduler (Professional Pack)

Schedule/target CMS content (blocks, banners, promos, events).

https://www.weltpixel.com/magento2-cms-block-scheduler.html


42) Full Page Scroll (Professional Pack)

Create immersive presentation pages with full-page sections and optional landscape sliders.

https://www.weltpixel.com/full-page-scroll-for-magento-2.html


43) Enhanced Quick Cart

Included in the Pearl Pack. Upgrade the mini cart UI/UX and send customers straight to checkout to lift conversions.

https://www.weltpixel.com/magento-2-quick-cart-checkout.html



K. Useful extras


44) Debug conflicts with 3rd-party extensions

https://support.weltpixel.com/hc/en-us/articles/360000609633-How-to-debug-use-WeltPixel-Debugger-and-fix-Magento-2-extension-conflicts


45) Check product versions

https://support.weltpixel.com/hc/en-us/articles/360007254073-How-do-I-check-the-theme-product-extension-version-and-change-log-


46) Upgrade the Pearl Theme

https://support.weltpixel.com/hc/en-us/articles/115004480528-How-can-I-upgrade-update-Pearl-Theme-to-latest-version-


47) Upgrade Magento & apply security patches

https://support.weltpixel.com/hc/en-us/articles/360007827854-How-to-upgrade-Magento-2-to-a-newer-version-and-install-latest-security-patches


48) Customize the theme (.css / .xml / .phtml / .js)

Examples and best practices:

https://support.weltpixel.com/hc/en-us/articles/115000705293-How-to-customize-css-xml-phtml-js-files-in-Magento-2-examples-Tutorial-


49) Insert a CMS block via widget (various locations)

https://support.weltpixel.com/hc/en-us/articles/360000620554-How-to-insert-a-CMS-block-in-different-sections-of-your-store-using-magento-widget


50) Store maintenance & custom development

End-to-end services across design, development, hosting, payments, fraud, feeds, and analysis—built on Magento Open Source/Commerce.

https://www.weltpixel.com/magento-migration/magento-development.html


weltpixel-wesupply-funnel-signature.png

Updated on: 17/09/2025

Was this article helpful?

Share your feedback

Cancel

Thank you!