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
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
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!
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.
- 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
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.
