WeltPixel Help Center
  • English
Go to website
Back
Articles on:Magento 2 User Guide
General knowledge and how-tos for the Magento 2 platform.

Categories

  • Magento 2 Pearl Theme User Guide
  • Magento 2 User Guide
  • Google Analytics 4 User Guide
  • Versioning & Updates
  • FAQs
  • Troubleshooting & Common Issues
  • Migrating from manual SSH installation to Composer Installation
    Starting with version 1.16.0 of all of our products, we've introduced Composer Installation. This has become the sole available installation method for all WeltPixel Products, including the Google Analytics 4 integration, the Pearl Theme and all other extensions. This means products and new updates will no longer be provided via zip files. If you already have your WeltPixel product installed via SSH (in the app/code/WeltPixel directory), you'll need to migrate to Composer Installation. ThereFeatured
  • How to reindex your Magento 2 store from admin or SSH / CLI
    a. Reindex from Magento Admin Sometimes not all indexers are reindexed using the admin reindex option. Always verify via SSH. Go to System Index Management and check indexer statuses. Select the items marked as Reindex required, then go to Actions Update on schedule. This will trigger a reindex for the selected indexers. Important: Sometimes not all indexers are reindexed using Admin reindex, even if the time and date are updated. Double-check using the SSH/CLISome readers
  • How to fix PayPal Instant Payment Notification (IPN) Warning [SOLVED]
    Fixing the PayPal Instant Payment Notification (IPN) Warning is important to ensure your store processes payments correctly. If you’ve ever run into this issue, you’ve likely received the following message from PayPal: “Please check your server that handles PayPal Instant Payment Notification (IPN). IPNs sent to the following URL(s) are failing: http://yourstore.com/paypal/ipn/ If you do not recognize this URL, you may be using a service provider that is using IPN on your behaSome readers
  • How to redirect to Shopping Cart Page after adding a product to the cart
    How to redirect to Shopping Cart Page after adding a product to the cart Magento has a built-in setting that lets you redirect customers straight to the Shopping Cart page after they add a product. This option disables the Ajax Add to Cart feature, ensuring users land in the cart immediately. How to enable the redirect: In the Admin Panel, go to: Stores → Configuration → Sales → Checkout → Shopping Cart Find the setting *After Adding a Product Redirect to Shopping CartSome readers
  • How to uninstall and remove a Magento 2 extension ( manual vs composer )
    Depending on the installation method, you need to uninstall the extension manually or via composer. Both methods are explained below. A. Manual Uninstall Step 1: Connect via SSH to the root of your Magento installation (this is the folder that has the app folder in it) and check the list of all modules including their enable/disable status: Step 2: Disable the module by executing the commands below:Some readers
  • Magento 2 issue Checkout error - region could not be converted to string [solution]
    A recurring Magento 2 checkout issue can throw the error “region could not be converted to string” when the shipping/billing region is empty or not mapped correctly. A simple workaround is to install a small module that gracefully handles the missing/invalid region so checkout can proceed. magento2-checkout-region-could-not-be-converted-to-string-error.png WhSome readers
  • How to set Magento 2 Developer and Production Mode via SSH
    How to Set Magento 2 Developer and Production Mode via SSH Switching between Developer and Production mode in Magento 2 is often necessary for development, debugging, or optimizing performance in a live environment. Here’s how to manage it via SSH. 1. Connect via SSH Use an SSH client to connect to your server. Your hosting provider will supply the SSH credentials. 👉 If you run into connection issues, make sure your IP is whitelisted. 2. Navigate to Your Magento Root DirecSome readers
  • How to minify, merge, bundle of HTML / CSS / JS - Magento Cloud vs. Magento Admin
    Magento offers a few ways to control minification, merging, and bundling for HTML, CSS, and JavaScript. The approach differs between Magento Commerce Cloud and a standard install configured via the Magento Admin. 1) Configure HTML/CSS/JS on Magento Commerce Cloud (ECE/B2B) On Cloud, these settings are committed as configuration rather than toggled only in the Admin. Step 1 — Export environment configuration From the root of your Magento ECE project (over SSH):Few readers
  • How to create a Magento configurable product [ Tutorial ]
    In this tutorial, you’ll learn how to create a Magento Configurable Product. Configurable products let customers choose options such as color or size on the product page, and each selection is tied to a simple product behind the scenes. Step 1: Create a New Attribute Log in to your Magento Admin and go to: Catalog → Attributes → Manage Attributes magento-manage-attributes.png (https://storage.crisp.chat/users/helpdesk/website/-/e/5/0/b/e50b1af3210e300/a6388698-873d-485b-9eFew readers
  • Paypal not showing in Checkout after upgrading to Magento 2.1.8 or later
    This issue is not related to WeltPixel extensions but rather to a Magento 2 upgrade problem we've documented. Everything usually works well when installing an extension on a clean Magento setup. However, upgrades can introduce issues. Since Magento releases regular updates for security, performance, and features, upgrading is necessary—but it can also be challenging as core functionalities change. One of the common issues encountered is PayPal disappearing from the Magento 2 checkout page afteFew readers
  • How to create a Multi-Language Store in Magento [ Tutorial ]
    In Magento, a website contains one or more stores, and each store can have multiple store views. Store views are often used to provide different languages. For example, if you want your store in English and German, you can use one store and create two store views, each with its own language. 1. Install Magento Language Packages Visit the Magento marketplace to download the required language package: Magento Localization Packages (https://www.magentocommerce.com/magFew readers
  • How to Change Email Logo in Magento 2
    Your Magento 2 store often uses emails as the first touchpoint with customers, so these should match your brand. Here’s how to replace the default email logo with your own. Steps In the Magento Admin, go to Content → Design → Configuration → (select your Store View) → Edit → Transactional Emails. magento2-email-logo-config-path Upload your logo under LFew readers
  • How to show best selling products in Magento 2 admin or store carousel
    Best selling products are determined based on Magento statistics. 1. Show best selling products in Magento admin In order for best selling products to show up in your Magento dashboard go to Reports Refresh Statistics, select all items, then click Refresh Lifetime Statistics → Submit. refreshlifetimestatistics.png Once statistics are refreshed, best seFew readers
  • How to add related products, up-sell products, cross-sell products in Magento 2
    Step 1. Go to Catalog Products and select the product you want to edit. Step 2. In the Related Products, Up-Sells, and Cross-Sells tab, you'll find three sections where you can add products for each type. add-related-products-magento2.png Step 3. Save the product. Step 4. Go to System Index Management and, if necessary, reindex yourFew readers
  • How to change placeholder images in Magento 2 admin
    You can update the default Magento 2 placeholder images directly from the Admin Panel. Steps to change placeholder images: Go to Admin Stores Settings Configuration. In the left menu, expand Catalog Catalog. Scroll down to the Product Image Placeholders section. Upload your custom placeholder images for: Base Image Small Image Thumbnail Click Save Config. Flush Magento cache to apply the changes:Few readers
  • How to enable template path hints in Magento 2
    You can use the Template Path Hints diagnostic tool in Magento 2 to add notations showing which template paths are used on a page. This is helpful for debugging and customizing your store. 1. Add Your IP Address to Developer Restrictions To avoid disrupting your customers' shopping experience, you should first add your IP address to the Developer Restrictions allow list. If you don’t know your IP, search for it online. Path: Admin -Stores -Settings -Configuration -AdvancFew readers
  • How to install an extension in Magento 2 - WeltPixel Guides
    install-magento2-extension-guide-banner What Magento is (quick refresher) Magento is an open‑source ecommerce platform written in PHP. It uses frameworks like Laminas and Symfony and is licensed under OSL v3.0. Magento 2 editions at a glance Magento Open Source – free and fully customizable. Magento Commerce – enterprise featuresFew readers
  • How to insert a CMS block in different sections of your store using a Magento widget
    Step 1. Create a CMS Block. If you already have the CMS block created, skip this step. Step 2. Add the HTML in the Content section. Step 3. Create a new widget. (https://storage.crisp.chat/users/helpdesk/website/-/6/e/3/6/6e366da715Few readers
  • How to configure Flat Rate shipping in Magento 2
    Flat Rate shipping lets you charge a fixed shipping cost, either per order or per item. It’s simple to configure and works with any carrier since no carrier integration is required. Customers will see Flat Rate as an option on the checkout page. To configure Flat Rate shipping, go to: Admin → Stores → Settings → Configuration → Sales → Delivery Methods → Flat Rate Flat Rate Settings Enable → Yes / No Turn Flat Rate on or off at checkout. Title SetFew readers
  • How to fix PayPal Magento 2 checkout issues - transaction refused invalid argument token error
    Overview Upgrading Magento is essential for security and performance, but it can surface payment flow issues. One common PayPal problem appears after upgrading from Magento 2.1.6 → 2.1.11, especially with downloadable/virtual products: PayPal completes the charge, but the customer hits a blank page or HTTP 500 instead of the success page. The logs show:Few readers
  • How to Enable/Disable Breadcrumbs in Magento 2
    Sometimes, your customers can end up getting lost in your store, especially if they've navigated through a few pages. Breadcrumbs can serve as a navigational aid to let them know exactly where they currently are, and allow them to return to a previous page at the click of a button. Hansel and Gretel weren't joking around! Enabling Breadcrumbs on your Magento 2 instance is quite easy, and can be done directly via the Admin Options. Here's how you can do that: Head into your Magento Admin panelFew readers
  • How to set up reCAPTCHA on Magento 2
    Google reCAPTCHA is a security service that prevents fraud and abuse on your website. Starting with Magento 2.3.x, Google reCAPTCHA is included by default in the Magento Core, meaning that it only needs to be configured in order to be ready for use. To enable and configure it, follow the steps below: In order to enable the reCAPTCHA from Google, you need a pair of API keys. Important: For reCAPTCHA to be enabled, valid Google API Website Key and Google API Secret Key fields are reFew readers
  • How To Set Favicon In Magento 2
    A favicon is the tiny icon that appears in the browser tab and bookmarks. It helps users recognize your site when many tabs are open and reinforces your brand. Steps In the Magento Admin, go to Content → Design → Configuration. Click Edit for the Global scope or the specific Store View you want to update. Expand HTML Head and find Favicon Icon. Upload your favicon image (use a square image for best results). Click Save Configuration. GoFew readers
  • How to upgrade Magento 2 to a newer version and install latest security patches
    How to upgrade Magento 2 to a newer version and install latest security patches Note: Make sure to back up your store and database before performing a Magento upgrade. Note 2: Backup your .htaccess file, as it will be overwritten when you upgrade. Step 1: Run upgrade commands via SSH Connect to your server via SSH and run the following commands from the root of your Magento installation:Few readers
  • How to set default List / Grid view in Magento 2 catalog
    Go to Stores Configuration Catalog Catalog Storefront List Mode and choose how you want products to be displayed in the catalog: Grid (default) / List List (default) / Grid Grid only List only This is standard Magento functionality and works out of the box. If you're using the Pearl Theme, it follows Magento's default behavior, so no additional theme-specific settings are required. Selection012.png (htFew readers
  • How to Set Home Page in Magento 2
    Changing the default Home Page in Magento 2 is quick and simple. Follow the steps below to set it up: 1. Create a New Home Page Head into: Content -Elements -Pages -Add New Page Here you can create your custom Home Page with the desired layout and content. Magento 2 create new CMS page 2. Assign the Home Page Once your page is created, assiFew readers
  • How to configure Table Rates shipping in Magento 2
    The shipping Table Rates method uses a data table to calculate shipping rates based on conditions like weight, price, or item count. Here's how to configure it in Magento 2. 1. Configure Table Rates in Magento Admin Go to Admin → Stores → Settings → Configuration → Sales → Delivery Methods → Table Rates. Available Settings: Enable Yes / No → Turn the method on or off. Title → Change the default title shown on Checkout. Method Name → The name displayedFew readers
  • How to mark the backend important updates pop-up / notification as read
    Mark admin announcement pop‑ups as read to stop them from reappearing until a new message arrives. Step 1 — Close the current pop‑up magento-admin-close-notification-popup Step 2 — View all messages From the Dashboard, click See All Messages. magento-admin-see-all-messages-link (https://storage.crisp.chat/users/helpdesk/website/-/6/c/8/a/6c8a6b3b2011640Few readers
  • Web Wizard Installation - Check Component Dependency error
    We're aware of an issue that occurs when trying to install extensions though the Web Wizard via the Magento Marketplace. This issue is not specific to WeltPixel modules, and seems to be a more general issue related to the Marketplace. Here's an example of what you may see when trying to install extensions this way: dependency.png This is currently being looked into by theFew readers
  • How to set admin user session lifetime in Magento 2
    Go to Admin Stores Configuration Advance Admin Security. From this section, you can define the admin session lifetime. By default, the session lifetime is set to 15 minutes for security reasons. Admin session lifetime (seconds): Specify the number of seconds until the current admin session expires and you need to log in again. adminsessionlifetime.pngFew readers
  • How to Create a New Admin User and Configure User Roles in Magento 2
    Sometimes, you may find yourself needing to create new Magento Admin users for different members of your organization, in order to provide them access to your store's backend, so they can complete their tasks. Magento allows you to do this, while also setting different permission levels for each, allowing you to control the content each user can access and edit. There are a couple of ways to go about creating a new Admin User in Magento 2: Directly via the Magento Admin Via the command lFew readers
  • How to Configure Distance Priority Algorithm for In-Store Delivery in Magento 2
    How to Configure Distance Priority Algorithm for In-Store Delivery in Magento 2 The Distance Priority Algorithm allows Magento to calculate and suggest the nearest source location to ship an order based on the customer’s shipping address. This ensures faster and more efficient deliveries. Step 1: Navigate to Inventory Settings In your Magento Admin Panel, go to: Admin → Stores → Settings → Configuration → Catalog → Inventory Step 2: Configure Distance Provider fFew readers
  • How To Add Store Code To URLs In Magento 2
    Adding the store code to URLs in Magento 2 can be very useful for multi-language setups. This way, customers know exactly which version of the store they're browsing. For example, if you have English and French Store Views, URLs will look like this: https://mystore.com/en https://mystore.com/fr 1. Enable Store Code in URL Options To show the store code in your store’s URLs: Head into Admin -Stores -Configuration -WebFew readers
  • How to set multi-session user in Magento 2 - Someone logged into this account from another device session is terminated
    Because of security reasons, Magento disables admin login session sharing by default. This means if someone logs into the same admin account from another device, the first session is terminated. To enable multi-session admin users: Go to Admin Stores Configuration Advanced Admin Security Change the value of Admin Account Sharing to Yes Additionally, you can define the admin session lifetime in this section. By default, the session lifetime is set to 15 minutes fFew readers
  • How to configure shipping / delivery method in Magento 2
    A wide range of shipping/delivery methods are built into Magento 2, alongside integrations for major carriers. Below are the native methods you can configure without creating third-party carrier accounts. To configure any shipping/delivery method, go to: Admin → Stores → Settings → Configuration → Sales → Delivery Methods Methods available by default Flat Rate — Single, fixed shipping fee per order or item. How-to: https://support.weltpixel.com/hc/en-us/articles/360017747179-Few readers
  • How to Add a Configurable Product in Magento 2
    Creating a Configurable Product in Magento 2 is simple. It allows you to combine multiple Simple Products into a parent product with selectable options, such as size or color. Step 1. Login to your Magento Admin Panel and navigate to Catalog -Products. Click the arrow next to Add Product and select Configurable Product. configurable.png Step 2. ChFew readers
  • How to Set Store Logo in Magento 2
    Purpose Add or update your storefront logo so it matches your brand everywhere it appears. Where to make the change In the Magento Admin, go to Content → Design → Configuration. Click Edit on the Store View you want to change (or Global if you want one logo across all views). Open the Header section. Upload and configure the logo Logo Image Upload: Upload a PNG/JPG/GIF of your logo. Logo Image Alt: Enter meaningful alternative text (helpFew readers
  • How to disable WYSIWYG editor in Magento 2 and reasons not to use it.
    WYSIWYG (What You See Is What You Get) may sound convenient, but in Magento 2 it can often cause issues. The editor tends to insert unwanted spaces or alter formatting, which can break layouts when editing existing pages or blocks. To avoid these problems, you can disable the WYSIWYG editor and work directly with clean HTML code. How to Disable WYSIWYG in Magento 2 Log in to your Magento Admin Panel. Navigate to Stores Configuration General Content Management. FindFew readers
  • How to fix Integrity constraint violation when upgrading Magento from 2.1.x to 2.2.x
    This issue isn’t related to WeltPixel extensions; it’s a Magento core upgrade problem that can appear when moving from Magento 2.1.x → 2.2.x. Error you may see during setup:upgrade This happens when the upgrade step attempts to insert empty/duplicate rowsFew readers
  • How to display layered navigation on category page?
    To display Layered Navigation on the category page in Magento 2, follow the steps below: Step 1: Enable Layered Navigation Layout In the Magento Admin, go to: Catalog → Categories Select the desired category. Open the Design tab. From the Layout dropdown, choose 2 Columns Left (this ensures the left sidebar is displayed where layered navigation appears). Save the category and check the frontend. enable-layered-navigation-layout.png (Few readers
  • How to display Simple product image instead of Configurable Product image in Mini-cart and Cart in Magento 2
    Below are the steps to display the image from the simple product in Cart and Mini-cart when you have configurable products or grouped products in your catalog. Step 1. Go to Admin sidebar → Stores → Settings → Configuration → Sales → Checkout Step 2. Expand Shopping cart section Step 3. Set Grouped Product Image and Configurable Product Image to: Product Thumbnail Itself ProductThumbnail.png (https://storage.crisp.chat/users/helpdesk/website/-/a/f/2/a/af2Few readers
  • How to enable SSL in Magento 2
    First, you need to contact your hosting provider to install the SSL certificate. Once it’s installed, you’ll need to enable it in Magento. To enable SSL on your Magento installation, head into: Admin -Stores -Settings -Configuration -Web -Base URLs (Secure): magento2-enable-ssl-base-urls.png 1. Edit the URL in Secure Base URL from http to httpFew readers
  • How to configure Free Shipping in Magento 2
    Free Shipping in Magento 2 can be configured in two main ways: Based on a minimum purchase amount As a cart price rule when certain conditions are met ⚠️ If both the Minimum Order Amount and Cart Price Rule apply to the same order, the Minimum Order setting takes priority. How to Configure Free Shipping in Magento 2 Navigate to Admin -Stores -Settings -Configuration -Sales -Delivery Methods -Free Shipping Free Shipping Settings:Few readers
  • How to set Captcha in Magento 2
    Having a Captcha on your store is quite important. Captcha or Completely Automated Public Turing test to Tell Computers and Humans Apart is a technique to distinguish between humans and computers. Captcha is mainly used as a security check to ensure only human users can pass through. To set it up, follow the below steps: 1. Set CAPTCHA for Admin Store For extra security, you can add CAPTCHA to the Admin Sign-in page. magento-2-captcha-admin.png (https://storage.crisp.chatFew readers
  • How to change category layout in Magento 2 ?
    Changing the category layout in Magento 2 is simple and can be done directly from the Admin panel. Steps to Change Category Layout In the Admin sidebar, go to Products -Categories. Select the category you want to edit. Open the Design tab. Choose the desired option from the Layout dropdown. magento2-change-category-layout.pngFew readers
  • How to set the number of products in Magento 2 category page
    Go to Admin -Store -Configuration -Catalog -Catalog -Storefront Here you can configure: Products per page on Grid / List (default value), e.g. 20 Products per page on Grid/List allowed values in dropdown on Category page, e.g. 20, 40, 60 products-per-page-category.pngFew readers
  • How can I set a product as "New" or "Sale" in Magento 2
    1. How to Mark a Product as "New" in Magento 2 Step 1. Go to Catalog Products and select the product you want to edit. Step 2. In the General tab, locate the fields Set Product as New from Date and Set Product as New to Date. Fill in the desired dates and press Save. magento2-set-product-as-new.png Step 3. Go to System Index ManaFew readers
  • How to import Listing Hover Images
    During the default Magento Product Import process, or when updating product images, you may want to add Listing Hover Images. This feature is specific to the Pearl Theme. Follow the steps below to configure them correctly. Step 1. Upload Images to Server Upload the images you want to use as Listing Hover Images to your server in a specific folder. Example: var/import Step 2. Export Products In the Magento Admin, go to System -Data Transfer -ExportFew readers
  • How to install Magento 2 via Composer
    First of all, what is Magento 2? Magento is an online store platform based on open-source technology. Magento is a content management platform for your online store that allows you to control the website settings, plugins, display, and functionalities. Magento provides powerful marketing tools, search engine optimization, and catalog management tools. Using Magento to create an online store has the following benefits: SEO administration, for better indexing in search engines PersonaliFew readers
  • How to Add a New Source for In-store Delivery in Magento 2
    Adding new sources in Magento 2 allows you to manage inventory and order fulfillment from multiple locations. Each source represents a physical location where stock is held, and you can assign products, update quantities, and even enable customer pickup. Steps to Add a New Source for In-store Delivery in Magento 2 In the Magento Admin, go to: Stores -Inventory -Sources -Add New Source magento2-manage-sources.png (https://storage.crisp.chat/users/helpdesk/website/-Few readers
  • How to print packing slips in Magento 2
    The packing slip is a document that provides a detailed list of items included in a package. It can include information such as weight, SKU numbers, size, order details, and more, depending on your store setup. To print a packing slip in Magento 2, follow these steps: Navigate to Admin -Sales -Orders Select the order you want Click the arrow button next to Actions Select Print Packing Slips Open with your browser Print the document magento-admin-priFew readers
  • How to configure category page with / without sidebar
    Pearl Theme follows Magento’s default category page layout (Luma). You can configure the category layout (with or without sidebar) using the default Magento catalog options. From the Magento Admin dashboard, navigate to: Products -Categories and select the desired category. Set Enable Category → Yes Set Include in Menu → Yes Category Page with Sidebar category-page-with-sidebar.png (https://storage.crisp.chat/users/helpdesk/website/-/d/f/6/6/df66a7d5dfb5e000Few readers
  • How to configure In-Store Delivery in Magento 2
    The customer can select a source during checkout where they can pick up the order. To configure In-Store Delivery, navigate to Admin -Stores -Settings -Configuration -Sales -Delivery Methods -In-Store Delivery. Before setting up In-Store Delivery, check these two settings: Ensure you have a non-default stock and source. For details about configuring a source as a pickup location, see this article: How to Add a New Source for In-store Delivery in Magento 2 (/knowFew readers
  • How to set up 301 URL Redirects via the Magento 2 Admin
    How to set up 301 URL Redirects via the Magento 2 Admin Sometimes, your products or page URLs may change, depending on various factors. However, the old URLs can remain indexed in Google and begin negatively impacting your SEO score because they lead to a 404 "Not Found" page. To fix this, the best solution is to set up a 301 URL Redirect from the old URL to the new URL. Here’s how: Step 1: Log in to your Magento Admin and head into: Marketing -SEO & Search -URL Rewrites mageFew readers
  • Composer Installation Fails: Repository Authentication or Module Access Error
    Composer Installation Fails: Repository Authentication or Module Access ErrorFew 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.