What is Melios?
Melios — is a free and open-source Magento module that improves built-in Page Builder module. There are two editions of Melios Builder available: free Basic edition, and paid Pro edition. Each feature of Pro edition is marked with special badge across the site.
Requirements
- PHP >= 8.0
- Magento >= 2.4.3
- Magento Page Builder >= 1.7.3
Installation
composer require melios/page-builder &&\
bin/magento module:enable Melios_PageBuilder --clear-static-content &&\
bin/magento melios:tailwind:download
composer config http-basic.meliosbuilder.com &&\
composer config repositories.melios composer https://meliosbuilder.com/api/packages.json &&\
composer require melios/page-builder-pro &&\
bin/magento module:enable Melios_PageBuilder Melios_PageBuilderPro --clear-static-content &&\
bin/magento melios:tailwind:download
We allow the same license key to be used across unlimited development and staging Magento domains. Use your live domain name for all of them. However, you must purchase and use different license keys per each live Magento installation.
Upgrading
composer update "melios/*" -w &&\
rm -rf var/view_preprocessed pub/static/adminhtml
Spotlight popup
With Melios you get a better way to insert content elements — press / hotkey, find the element you need, and paste it in a single click using the mouse or keyboard.
When using keyboard to insert new content from the Spotlight popup, Melios will automatically switch drop location to the recently added element. This approach allows prototyping page layout blazingly fast!
Tailwind CSS
This feature is available since v1.8.0
All of the Tailwind CSS utilities are now available to use in Magento Page Builder. Just add the css class you need, or copy whole tailwind-based designs and they'll just works!
To get started with Tailwind CSS, open the terminal and run the following command:
bin/magento melios:tailwind:download
symfony/process
to run the executable
to generate styles when you'll save the Page Builder content.
That's all! You can now use Tailwind in all Page Builder forms, including third-party modules:
Configuring Tailwind CSS
Usually, you do not need to change the Tailwind configuration.
However, if you want to, you can do so on
Stores > Configuration > General > Content Management > Melios Page Builder
page:
Please note, that changing the configuration will have no effect on previously saved pages. You need to save them again to regenerate styles using the updated configuration.

Disabling Tailwind CSS
Sometimes you may want to turn of the Tailwind for selected page,
or CMS block. In this case you may add melios-tailwind-off
css class name to your existing content.
To disable Tailwind completely, you need to remove tailwindcss executable:
magento_root/var/melios/tailwind/tailwindcss
AI assistant
This feature is available for Melios Builder Pro users since v1.2.0
Improve and translate your texts using AI without leaving the editor!
Melios supports OpenAI and OpenRouter providers.
- OpenAI provides their own models with different capabilities and pricing.
-
OpenRouter provides access to the massive amount of third-party models.
Additionally, this service provides their own
openrouter/auto
proxy model that automatically switches between multiple allowed models to optimize your bills.
To start using AI assistant you need to open Melios settings at Stores > Configuration > Content Management > Melios Page Builder page and fill the API key and AI Model fields:

Now, you can use the assistant! Search for AI icon in every WYSIWYG editor and supported pagebuilder elements:

Clicking the AI icon will activate persistent chat with AI model. This chat preserves the local history on your computer, so you can continue your work where you left off.
Clicking the chevron near AI icon will show you the commands dropdown. You can instanty run selected command for the content of the active section or for selected part of the text. These commands create temporarily chats that are destroyed once you accept the answer or close the chat.
All commands are multilingual, so you can run them for any language!
The following commands are available:
- Fix grammar — fixes grammar errors.
- Fix grammar and improve writing — fixes grammar and improves text readability and clarity.
- Expand content — adds more details and richness to the original content.
- Shorten content — summarizes the text keeping the main ideas.
- Translate to ... — this command is created for each locale used by the frontend stores.
CodeMirror
Melios integrates CodeMirror editor into HTML components and "View Source Code" mode of WYSIWYG elements. CodeMirror provides stunning experience for reading and editing html content directly in Magento admin panel:
- Syntax highlighter.
- HTML validation and error highlighting.
- Search and replace.
- Hotkeys — nearly everything from your favorite code editor!
- Light and Dark theme toggler — choose your favorite colors!
- Fullscreen mode — comfortable work with large HTML texts.
- SVG image preview — reduces markup noise when working with HTML content. You can double click the preview icon to view raw content.
The list of available CodeMirror Hotkeys:
Command
|
PC hotkey
|
Mac hotkey
|
---|---|---|
Search and replace | ||
Find | Ctrl+F | Cmd+F |
Find next | F3 | F3 |
Find prev | Shift+F3 | Shift+F3 |
Replace | Ctrl+H | Cmd+H |
Stop search | Esc | Esc |
Selection | ||
Select next occurance | Ctrl+D | Cmd+D |
Skip and select next occurance | Ctrl+K Ctrl+D | Cmd+K Cmd+D |
Select line | Ctrl+L | Cmd+L |
Add cursor to next line | Ctrl+Shift+Down | Ctrl+Shift+Down |
Add cursor to prev line | Ctrl+Shift+Up | Ctrl+Shift+Up |
Split selection by line | Ctrl+Shift+L | Cmd+Shift+L |
To uppercase | Ctrl+K Ctrl+U | Cmd+K Cmd+U |
To lowercase | Ctrl+K Ctrl+L | Cmd+K Cmd+l |
Line | ||
Delete line | Ctrl+Shift+K | Ctrl+Shift+K |
Duplicate line | Ctrl+Shift+D | Cmd+Shift+D |
Indent less | Shift+Tab | Shift+Tab |
Indent more | Tab | Tab |
Insert line after | Shift+Enter | Shift+Enter |
Insert line before | Ctrl+Shift+Enter | Cmd+Shift+Enter |
Join lines | Ctrl+J | Cmd+J |
Swap line down | Ctrl+Shift+Down | Ctrl+Cmd+Down |
Swap line up | Ctrl+Shift+Up | Ctrl+Cmd+Up |
Toggle comment | Ctrl+/ | Cmd+/ |
Scroll | ||
Scroll line down | Ctrl+Alt+Down | Ctrl+Alt+Down |
Scroll line up | Ctrl+Alt+Up | Ctrl+Alt+Up |
Fullscreen | ||
Toggle fullscreen | Ctrl+Shift+F | Ctrl+Cmd+F |
Exit fullscreen | Esc | Esc |
Global hotkeys
- Alt+0 — open PageBuilder.
- / — open Spotlight to insert new content.
- Enter or mouse Double Click — edit hovered element.
- Ctrl+Enter to accept changes and close edit popup.
- Delete or Backspace — delete hovered element.
- Ctrl+Shift+M — switch between Desktop and Mobile views.
Image upload
Melios adds ability to upload modern image formats: webp and avif.
Since this feature can't affect Page Builder module only, you also get modern images support for any other admin page that uses Media Gallery component. For example:
- Product image upload.
- Category image upload.
- Third-party modules that use Media Gallery.
Copy-paste
Melios builder uses buffer from your operation system for copy, cut, and paste oparations. This allows working with different page builder instances and different tabs of your browser.
Please note, that copy-pasting the entire page is available in both versions while copy-pasting hovered elements is limited to the pro version only.
- Ctrl+C — copy hovered element into the clipboard.
- Ctrl+X — cut hovered element into the clipboard.
- Ctrl+V — paste copied element at the bottom or after the hovered element.
- Ctrl+Shift+V — paste copied element at the top or before the hovered element.
Quick save
Live preview
Live preview — is an awesome companion to the Quick save feature. Combined, these features will save you tons of time! No need to leave Page Builder, switch the tab and refresh the page manually — stay focused!
When activated, Melios Builder will automatically reload storefront page right after you save the content using Ctrl+S hotkey!
Turn any page into live preview page!
It's also possible to turn any existing page into livereload page! For example, when editing CMS block that's used as a part of category description, you can do the following:
- Open CMS block in backend.
- Click "Live Preview" button in top panel — Melios will open the live preview page.
- This page will have a
?livereload=RES_ID&token=TOKEN
parameters in the address bar. Copy them. - Open the category page, where this CMS block is used.
- Add copied parameters to the current URL and reload the page.
- Now your category page is a live preview page! Save the CMS block using Ctrl+S hotkey, and Melios will reload this page.
Columns
Image
Images (including background images) are well known causers of performance issues. To provide users with fast and reliable shopping experience you must optimize your images carefully. Melios provides a few features to fix image issues on CMS pages:
- Ability to upload modern image formats: webp and avif.
- Ability to set image dimensions attributes.
- Ability to set loading and fetchpriority attributes.
- Ability to preload selected image.
Loading mode includes image lazy load, preload, and fetchpriority attribute — must have features for modern website.
Here is a guide on how to choose proper loading mode:
- Lazy — use for all images that are not visible on initial page load.
- Preload — use for image that creates LCP to reduce it and improve pagespeed score. We recommend having up to 3-4 preloaded images per page. A larger number will negate the possible boost.
- Default, fetchpriority="low" — use for images that close enough to the visible viewport and browser loads them despite of having the lazy attribute.
Background
We bet you want background-image to have the same loading mode control as the image has. We've done a good job on this, and you can set the background image as lazy, or you can preload it to improve the LCP score!
Here is a guide on how to choose proper loading mode:
- Lazy — use for all background-images that are not visible on initial page load.
- Preload — use for background-image that creates LCP to reduce it and improve pagespeed score. We recommend having up to 3-4 preloaded images per page. A larger number will negate the possible boost.
- Default — use for background-images that close enough to the visible viewport.

Responsive styles
This feature is available since v1.3.0
Melios adds additional styles configurable per mobile view breakpoint:- Margins and paddings.
- Border width and radius.

HTML component
This feature is available since v1.5.0
Edit HTML content like a pro! CodeMirror integration greatly improves content management and decreases chances to save broken markup.
WYSIWYG editor
- Add WYSIWYG menu because sometimes you need these items.
- Integrates CodeMirror editor into "View Source Code" popup.

Marquee
Available in MeliosPro v1.4.0
Create stunning pages with Marquee elements! You may also know it as infinite scroller. Melios provides the following Marquee options:
- Appearance: Image or HTML.
- Scroll speed, pixels per second.
- Scroll direction, default or reversed.
- Pause on hover.
- Fade Marquee edges. Works for dark and light themes!
- Gap between items.
- Global and per-item border and border radius styles.