PX Editor is a Joomla editor plugin: one flowing writing page with a "/" menu and a + insert panel for images, galleries, video, tables, layout blocks and templates, saving clean HTML. Choose it in Global Configuration or per user.

PX Editor replaces the default Joomla editor with one flowing writing page: you type, press / or the + button to add an image, a gallery, a video, a table or a layout block, and what is saved is clean HTML that passes Joomla's text filters. It works wherever Joomla shows an editor: articles (administrator and front-end form), Custom modules, category descriptions. PX Editor is free.

  • Fast writing: a one-row toolbar, a searchable insert panel, the "/" menu, a selection bubble and Markdown shortcuts.
  • Media first: drag, paste or upload images, captions typed in place, galleries with a lightbox, YouTube and Vimeo as click-to-play posters.
  • Layout blocks: tables, columns, callouts, buttons, collapsible sections, share buttons.
  • Templates: 12 ready-made article skeletons, a category of site templates, and "My templates" saved with each author's account.
  • Safe with existing content: opening and saving an article does not change its markup; what the editor cannot edit visually is kept as an HTML block.
  • Light on the site: styles and script load only on pages with PX Editor blocks; no iframe or script is stored in the article.
Try it first: the PX Editor demo lets you write and edit articles with PX Editor in the front-end form of a plain Joomla 6 site (reset every night).

System requirement

  • Joomla 5.4 or Joomla 6 (the installer accepts Joomla 5.2 and later)
  • PHP 8.2 or later
  • A current Chrome, Edge, Firefox or Safari for authors; published pages work in every current browser

Install the package

  1. Download pkg_pxeditor_v1.0.0.zip from the PX Editor page (a free thepixel.dev account is enough).
  2. In your Joomla administrator go to System → Install → Extensions and upload the file.

The package installs three plugins, enabled on the first install:

PluginWhat it does
Editor - PX EditorThe editor itself, in the administrator and in the front-end article form.
Content - PX EditorLoads the styles, the lightbox and the video player on your site; post-format tags and share buttons when you turn them on.
Sample Data - PX EditorDemo articles, a menu and the user guide (English and Vietnamese).

PX Editor has no component. It creates one small table for the authors' personal templates, removed again when the editor plugin is uninstalled.

Choose PX Editor

Installing does not change the site's editor. Choose it yourself:

  • For the whole site: System → Global Configuration → Site, set 1Default Editor to Editor - PX Editor and save.
  • For one user (good for trying it first): Users → Manage, open the account, tab Basic Settings, set Editor to Editor - PX Editor. A user's own choice wins over the site default.
Default Editor set to Editor - PX Editor in Global Configuration
System → Global Configuration → Site.

Open an article (Content → Articles → New) and start typing. The toolbar stays on one row: 1the highlighted + (insert panel), 2Template and Read more, then undo / redo, text style, bold, italic, underline, link, colours, lists, alignment, More (strikethrough, inline code, indent, subscript, superscript, clear formatting), 3HTML source and full screen. The bar at the bottom counts words and characters.

The PX Editor writing screen with its toolbar
An article in PX Editor: one flowing page, the Read more marker in place.

An empty article shows a hint and four quick buttons: Template, Image, Video and Table.

An empty article with the quick buttons Template, Image, Video, Table
A new article.

The + insert panel

Press +: the search field has the focus, type a few letters and press Enter to insert the first result. Blocks are grouped as Media, Layout and blocks and Joomla (Joomla's own editor buttons: Article, Module, Contact, Field, Menu, Page break). A block is inserted at the cursor; on an empty line it replaces the line, inside a column, callout, collapsible section or table cell it goes inside it.

The insert panel with Media, Layout and blocks and Joomla groups
The insert panel.

The "/" menu

On an empty line (or after a space) type /. Keep typing to filter (/image, /video, /table, /template), choose with the arrow keys, insert with Enter or Tab, close with Esc.

The slash menu open on an empty line
The "/" menu.

Selection bubble and shortcuts

Select words and a small bar appears with bold, italic, underline, strikethrough, link, Heading 2, Heading 3 and quote. Links are edited in place (Ctrl+K, Mac ⌘K).

Selected text with the formatting bubble above it
The selection bubble.
TypeResult
## + spaceHeading 2 (### Heading 3 … up to 6)
- / 1. + spaceBulleted / numbered list
> + spaceQuote
---Divider
**text**, *text*, text between backticksBold, italic, inline code
Alt+F10Toolbar of the current block (image, video, gallery, table, callout); Esc returns to the text

You save with Joomla's usual Save and Save & Close buttons.


Insert an image four ways: drag a file into the article, paste it, + → Image → Upload from computer (several files at once), or Choose from Media / an image address. Uploads go through Joomla's Media Manager and its permissions; the folder is set in the editor plugin.

Image panel: Choose from Media, Upload from computer, Image address
+ → Image.

Type the caption on the line under the image (Enter continues below). Hover or click the image for its bar: float left, normal, float right, wide, full width, ALT (a warning shows while the alternative text is empty), link, enlarge on click, replace and remove.

The image toolbar above an image
The image bar.

Galleries: + → Gallery, add images from Media or upload several, choose 2, 3 or 4 columns, drag to reorder, click an image for its alternative text and caption. On the site a click opens the lightbox (arrow keys, swipe, Esc); the lightbox script is downloaded at the first click only. Phones show two columns.

A three-column gallery in the editor with its toolbar
A gallery in the editor.
The gallery on a Cassiopeia article page
The same gallery on the site.
The lightbox open on a gallery image
The lightbox.

YouTube and Vimeo: paste the video address on an empty line, or + → Video. Watch pages, youtu.be links, Shorts (9:16), live streams, a start time (?t=42) and unlisted Vimeo videos are recognised.

The video panel with a YouTube address
+ → Video.

The article stores a poster image that links to the video, not an iframe: the page does not load the player until a visitor presses play, nothing is sent to YouTube or Vimeo before that, and Joomla's text filter (which removes iframes for Authors, Editors and Publishers) keeps it. The poster can be copied to your own site (images/pxeditor/posters). The block bar sets the ratio (16:9, 4:3, 1:1, 9:16), changes or removes the video.

A YouTube video block with its ratio toolbar
A video block in the editor.
The video poster with a play button on the site
On the site: the player loads on click, from youtube-nocookie.com.

Files: + → File. Video (mp4, webm, ogv, mov) and audio (mp3, m4a, ogg, wav) become players with the browser's controls (a video can have a poster); other files become a download link with type and size, for example "quote.pdf (PDF, 1.2 MB)". Joomla accepts only the file types allowed in Content → Media → Options.


  • Tables: choose the size on a 6 × 6 grid; a new table has a header row. With the cursor in the table a second bar adds or deletes rows and columns, toggles header rows and columns, merges and splits cells. Tab moves to the next cell (and adds a row in the last one).
  • Columns: 1-1, 1-2, 2-1 or 1-1-1; going from three columns to two moves the third column's content into the second. Columns stack below 768px.
  • Callouts: Info, Success, Warning or Danger, with paragraphs, lists and images inside.
  • Buttons: text, address, style (Primary, Secondary, Outline), new tab. A button is an ordinary link.
  • Collapsible sections: the standard HTML details element, no JavaScript needed on the site.
  • Share buttons, divider, page break (page title and table of contents label) and Read more (one marker per article, always between two top-level blocks).
A table in the editor
A table.
Columns and callouts with the callout type bar
Columns and callouts; the bar switches the callout type.

HTML source and HTML blocks

1HTML source on the toolbar shows and edits the article's HTML. Markup PX Editor cannot edit visually (an iframe, a script, a form, a table with a caption, elements with onclick…) appears as an HTML block: a card that shows the code as text and saves it exactly as it was. Edit HTML changes it.

HTML source view of an article with a gallery and a callout
HTML source: the gallery and the callout are plain figure and div elements.

Press 1Template (or type /template): the template is inserted at the cursor. Three sources:

  • Ready-made: 12 skeletons in English and Vietnamese (by the administrator language): news article, announcement, step-by-step guide, top list, product review, comparison, video article, interview, case study, event, recipe, questions and answers. Hide them with Offer ready-made templates.
  • Templates of this site: choose a category in the editor plugin's Template category; its published articles become templates for every author (access and language are respected).
  • My templates: Save this article as a template at the bottom of the panel. Stored with the user's account (available in any browser after signing in), visible only to that user, up to 50, filtered like an article on save.
The Template panel with the ready-made templates and the save field
The Template panel.

System → Plugins, search for "PX Editor".

Editor - PX Editor

OptionDefaultMeaning
Minimum height (px)350Smallest height of the writing area (150 to 1200).
Accent colour#34C759Colour of the + button, active buttons and the focus ring. Empty follows the administrator template.
Show the credit lineYesThe product name in the bar under the editor; never written into your content.
Upload folderEmptySubfolder of the Media Manager image folder for dropped and pasted images.
Store video posters locallyYesCopies YouTube and Vimeo posters into pxeditor/posters in the Media Manager.
Offer ready-made templatesYesThe 12 shipped templates in the Template panel.
Template categoryNonePublished articles of this category become shared templates.
Options of the Editor - PX Editor plugin
Editor - PX Editor.

Content - PX Editor

Works on the site and when an article is saved; it never changes the article text.

  • Load on every page (No): styles and script normally load only on pages with PX Editor blocks. Turn it on when a module or template override prints content without running content plugins.
  • Post formats: a tag for articles with video, with a gallery and with audio (added or removed on save, other tags untouched), and a custom field that receives video, gallery, audio or standard. Use the tags in a Tagged Items menu item or the Articles module.
  • Share buttons: add to every article (above, below or both; off by default), networks (Facebook, X, LinkedIn, Pinterest, WhatsApp, Telegram, email, Copy link, the device's Share…), style, the word "Share", categories, blog and featured lists, Open Graph tags (on; tags set by another extension are kept).
Share buttons tab of the Content - PX Editor plugin
Content - PX Editor → Share buttons.

Share buttons are plain links: no script from a social network is loaded, nothing is sent until a visitor presses a button. Each article shows buttons from one source only: placed by the template (renderShare() in an override) wins over a Share buttons block in the article, which wins over the automatic buttons. The HTML can be overridden in templates/<template>/html/layouts/pxeditor/share.php.


  • Opening and saving an article does not change its HTML. Classes, ids, styles and data-* attributes are kept; b stays b, strong stays strong; module codes such as {loadmoduleid} stay text. The only normalisations: loose text at the top level is wrapped in a paragraph and extra white space between blocks is dropped.
  • Joomla's text filter: the HTML PX Editor writes passes the default filter for Authors, Editors and Publishers (no iframe, no script, no unusual elements).
  • Next to another editor: articles are just HTML, so they open in TinyMCE, JCE or CodeMirror and back.
  • Uninstall PX Editor Package in System → Manage → Extensions: articles are not touched and stay readable (images, tables, video posters as links, collapsible sections still work; columns and floats lose their layout). Choose another default editor first. Uploaded images and posters stay in the Media Manager; personal templates are deleted with the editor plugin.

On the administrator home page, Sample Data → PX Editor Demo → Install adds demo articles for every block (formatting, images, galleries, video, tables, layout blocks, Read more), a "PX Editor" site menu, and the user guide as articles in English and Vietnamese. Running it again creates nothing twice and refreshes the guide.

PX Editor Demo in the Sample Data module
Home Dashboard → Sample Data.

  • Still the old editor? PX Editor never makes itself the default: choose it in Global Configuration or the user's Basic Settings (a user's own choice wins).
  • Blocks without styling on the site? Check that Content - PX Editor is enabled; turn on Load on every page for content printed without content plugins; clear the cache.
  • A video does not play? The owner may not allow embedding, or a Content Security Policy blocks youtube-nocookie.com / player.vimeo.com (allow them in frame-src).
  • Uploads refused? The account needs the Create permission in Media, the file must fit upload_max_filesize / post_max_size, and its type must be allowed in Media's options.
  • An iframe disappears after saving? That is Joomla's text filter, not PX Editor. Use the Video block for YouTube and Vimeo.
  • Accessibility: the toolbar is a keyboard toolbar (arrow keys), every button has a label, Esc closes panels and returns the focus; works on Atum light and dark and on phones.