Articles on: Magento 2 Pearl Theme User Guide

License key for local / staging / development environment. Multi-store licensing.

Seeing "license key is invalid" / "license domain X does not match current domain Y"?


License the root (registrable) domain, not a deep host. The license check reduces whatever host your store runs on down to its root domain and validates against that — so a key bound to a full multi-level host (e.g. dev-m2.shop.dev23.yourdomain.com) fails, while a key on the root (yourdomain.com) covers that root and every subdomain under it automatically. The error names the domain to use: it reads ... does not match current domain Y, and Y is exactly the root to license. Go to account.weltpixel.com → My Products → Update Licensed Domain, enter Y, and save. (Do not change your Magento base URL or any Magento configuration to fix this — the fix is in the account portal.)



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://www.yourdomain.com


You can use the same license key for:



Note (IP addresses): Full IPv4 addresses are accepted — enter the complete address (all four octets, e.g. 11.22.33.44) in the Update Licensed Domain field. Do not enter a partial address such as the last two octets. IPv6 is not currently supported.


Note 2: For multiple servers, use DNS records to point different subdomains of the licensed domain to separate servers.



3. Multi-store / multi-domain licensing


If used on the same Magento installation, you can run the product on unlimited domains for different store views. You only need to license the domain associated with the Magento Admin.


Example:



License the main admin domain (e.g., www.yourdomain.com/admin).



4. Using temporary domains


  • a. License the temporary domain. You can change your licensed domain later in your weltpixel.com account.
  • b. Use a subdomain of your licensed domain. Instead of the hosting provider’s temporary domain, assign a subdomain like dev.domain.com or staging.domain.com. The license will work on all test environments.



5. Licensing under an agency domain


  • a. Agencies can purchase a separate license for their domain and use it for client staging environments (e.g., staging-client1.agency.com).
  • b. Alternatively, license under the agency domain temporarily, then transfer to the client’s production domain later.
  • c. Agencies can also license staging/development environments using the rules from sections 1–4 above.



6. Licensing on Magento Cloud


From version 1.7.3 (August 23, 2018) onward, Magento Cloud subdomains are supported. Use the production domain’s license key for integration branches.



If you face issues, ensure you’re using product version 1.7.3 or newer.



7. Licensing if purchased from Magento Marketplace


If you purchased through Magento Marketplace or another reseller, and a license is required:


  1. Create an account on weltpixel.com.
  2. Send a request via the WeltPixel Support Center with:
    • Marketplace name
    • Order number
    • Buyer name and email
    • Product purchased
    • Email used for your weltpixel.com account (ensure your account includes a complete billing address)


Once verified, the product will be assigned to your weltpixel.com account, allowing you to generate the license key.



8. Licensing multiple domains on the same Magento installation


In multi-store or multi-website setups running on the same Magento instance, you only need to license the backend domain. The product will then work across all associated frontend domains.

Updated on: 03/07/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!