Getting Started

Welcome to the Landing Page Documentation. Whether you are a new or an advanced user, you can find some useful information here.

First of all, we recommend you check the following link:

How to install extension

How to install the extension

Backup your store's database and web directory.
Login to your server's SSH console and navigate to the root directory of the Magento 2 store.
Copy the installation instructions from the page My Downloadable Products into the SSH console and press ENTER.

Run the command below to enable the extension:

    php -f bin/magento module:enable Mirasvit_LandingPage

Run the command below to install the extension:
```
    php -f bin/magento setup:upgrade
```
Run the command below to clean the cache:
```
    php -f bin/magento cache:clean
```

Deploy static view files:

    rm -rf pub/static/frontend/*; rm -rf pub/static/backend/*; rm -rf var/view_preprocessed/*;
    php -f bin/magento setup:static-content:deploy

Manage Landing Pages

This section describes how to create and edit landing pages.

To create a new landing page, go to the Content -> Landing Pages -> Pages section and press the button New Page. The landign page that will appear is divided into four sections:

General Information

Option	Description
Is Active	Enable / disable landing.
Name	Internal name of the page
Store View	Defines where the landing page will be displayed.

Search Engine Optimization

Option	Description
URL key	Defines URL for your landing page.
Page Title	The Title (H1) of the Landing Page. If the field is empty, the title will display Name of Page.
Meta Title	Defines the meta title for the landing page.
Meta Keywords	Defines meta keywords for the landing page.
Meta Description	Defines the meta description for the landing page.
Robots	This directive controls page visibility by search engines' crawlers. There are four available variants: NOINDEX, NOFOLLOW, NOINDEX, FOLLOW, INDEX, NOFOLLOW, INDEX FOLLOW.

Content

This section allows configuring the content of the landing page .

Option	Description
Description	Defines Landing page's description.
Top CMS block	Defines a static block to display at the top of the landing page. Blocks should be added in Content -> Elements -> Blocks. Not applicable for the Products only display mode.
Bottom CMS block	Defines a static block to display at the bottom of the landing page. Blocks should be added in Content -> Elements -> Blocks. Not applicable for the Products only display mode.
Layout Update XML	Defines Layout Update XML for the landing page

Products

This section defines how products for the page will be selected

Option	Description
Categories	Defines the categories from which products will be displayed.
Search Term	Defines the search term. If specified, only products that match the search term will be displayed
Filters	Configure attributes and their values to use them as filters for selecting products

The extension supports any combinations of these configurations to filter products

Disabling the Extension

Temporarily Disable

To temporarily disable the extension please follow the following steps:

Run the command below to disable the extension:

    php -f bin/magento module:disable Mirasvit_LandingPage

Removing the Extension

To uninstall the extension, please follow these steps:

Run the command below to remove the extension:

    composer remove mirasvit/module-landing-page

1.1.1

(2026-04-01)

Improvements

New settings in Stores > Configuration > Mirasvit > Landing Page > SEO let you independently enable or disable canonical link tags and hreflang alternate tags on landing pages.

1.1.0

(2026-03-06)

Features

Related Landing Pages — automatically display links to related landing pages on product and category pages, powered by a new indexer that maps products to landing pages
New admin configuration section for enabling related pages and customizing the block title

Improvements

⚠️ New DB table mst_landing_page_product and new indexer mst_landing_page_product — reindex required after upgrade
Admin notification prompts reindex when the Related Pages feature is enabled

1.0.27

(2026-01-19)

Fixed

Fixed type error when loading a landing page with a non-integer page ID in the URL

1.0.26

(2026-01-05)

Fixed

Fixed type error in filter repository when the page ID was passed as a string instead of an integer

1.0.25

(2025-11-11)

Features

Canonical and hreflang tags — landing pages now automatically include canonical URLs and hreflang links for better SEO in multi-store setups

Fixed

Products on landing pages with a search term are now sorted by relevance instead of default sort order

1.0.24

(2025-10-27)

Fixed

Fixed search term condition not being properly applied when filtering products on a landing page

1.0.23

(2025-09-10)

Fixed

Improved product filtering accuracy when a search term is configured on a landing page
Fixed DI configuration conflict with the BlogMX module

1.0.22

(2025-08-29)

Fixed

Landing page filters now display correctly in layered navigation even when category filter display is disabled in store settings

1.0.21

(2025-07-28)

Improvements

Subcategory products are now automatically included when a parent category is selected in landing page settings

1.0.20

(2025-07-17)

Features

Landing page URL suffix — new configuration option under Stores > Configuration to set a custom URL suffix for landing pages (e.g., .html)

1.0.19

(2025-06-17)

Features

Landing page image — upload and display a featured image on landing pages

Improvements

Reorganized column positions in the admin landing pages grid

1.0.18

(2025-04-10)

Fixed

Fixed PHP 8.4 compatibility issue with nullable parameter types

1.0.17

(2025-03-27)

Fixed

Fixed URL matching to work with the latest Seo Filter URL format changes

1.0.16

(2025-02-25)

Features

Automatic redirect to landing page — when a visitor browses the all-products page with filters that match a landing page, they are automatically redirected to the landing page URL. Enable per page with the new "Redirect" toggle

Improvements

⚠️ New redirect column added to mst_landing_page and mst_landing_page_store tables
Fixed potential SQL injection in URL parser query

1.0.15

(2025-01-23)

Features

Multi-store content support — configure different page titles, URLs, descriptions, meta data, CMS blocks, and search terms per store view, with "Use Default" toggles for each field

Improvements

⚠️ New DB table mst_landing_page_store for store-level overrides — existing pages will use default values until overridden per store

1.0.14

(2024-12-27)

Fixed

Fixed inability to assign a landing page to multiple store views
Improved admin page titles to show "Landing Page" instead of generic "Page"
Added translation file (en_US.csv) for admin interface strings

1.0.13

(2024-07-11)

Fixed

Fixed meta title not being applied — page title was shown as the browser tab title instead of the configured meta title

1.0.12

(2024-06-17)

Fixed

Removed empty description container from rendering when no description is set
Fixed page meta title not being applied correctly in the browser tab
Registered landing page as a layout page type so it can be used with widget layout updates

1.0.11

(2024-05-29)

Fixed

Fixed inactive landing pages still being accessible via their URL

1.0.10

(2024-04-15)

Fixed

Fixed landing page URL routing to correctly match pages assigned to specific store views instead of showing pages from other stores

1.0.9

(2024-04-09)

Fixed

Fixed page description not rendering correctly on the frontend — improved layout and template handling for the description block

1.0.8

(2024-04-04)

Fixed

Fixed description field not being editable with Page Builder in the admin panel
Fixed swatch filter URLs containing incorrect parameters on landing pages

1.0.7

(2024-02-21)

Improvements

Improved URL routing to use exact matching instead of partial matching, preventing false matches with similar URL paths

1.0.6

(2024-02-16)

Fixed

Fixed filter attribute options not loading in the admin form when "Add Secret Key to URLs" is enabled

1.0.5

(2024-02-09)

Fixed

Fixed conflict with Search Ultimate causing "Request name doesn't exist" error

1.0.4

(2024-02-01)

Fixed

Fixed "Call to a member function getCategories() on null" error on brand pages when no landing page is active

1.0.3

(2024-01-31)

Fixed

Fixed landing page content not displaying correctly with horizontal navigation bar layout
Removed category filter interference from landing page product filtering

1.0.2

(2024-01-29)

Improvements

Page title and breadcrumbs now fall back to the page name when no page title is set, instead of showing "Landing"
Renamed admin form section from "Appearance" to "Content"

1.0.1

(2024-01-29)

Features

Seo Filter compatibility — landing page URLs now work correctly with Mirasvit Seo Filter module
Fixed PHP 8+ compatibility issue in router

1.0.0

(2024-01-19)

Features

Landing Pages for Magento — create custom landing pages with filtered product listings based on categories, search terms, and attribute filters
Admin interface for managing pages with SEO settings (meta title, description, robots), CMS content blocks, and layout updates
Configurable layered navigation filters per landing page
Multi-store support with store view assignment
Breadcrumb navigation on landing pages