JUX Justified Gallery - Joomla Extension

Guide to Configuring and Using JUX Justified Gallery

JUX Justified Gallery is best understood not as a simple "pretty photo block," but as a Joomla module for controlled image output in an even justified grid. In this guide, we'll walk through how to prepare your images, install the module, configure uploads, filters, the popup viewer, styles, site position, and post-publication checks.

This guide is written for site owners, content managers, and webmasters who need to display a portfolio, photo gallery, work showcase, catalog of visual examples, or media display without manually laying out every row. It does not repeat the product's short description. What follows is a practical walkthrough focused on settings, limitations, troubleshooting, and safe implementation choices.

The official documentation describes JUX Justified Gallery as a Joomla module that supports loading images from a folder, adding titles, assigning filter tags, choosing the popup image type, and configuring height, spacing, the number of items shown on first load, the Load More button, search, filtering, popup behavior, styles, and custom CSS. Those capabilities form the basis of this guide.

What problem a justified gallery module solves

The main value of JUX Justified Gallery is not that it simply displays images. Joomla already lets you insert images into articles, but manual placement quickly becomes inconvenient when you have a lot of photos, different dimensions, a need for a consistent grid, themed groups, and a visitor who should be able to find the right set quickly. This module handles the visual layout and the repeatable display logic for you.

A justified grid works like a showcase where images with different proportions are arranged into rows with a consistent visual width. That makes it useful for portfolios, photo shoots, project galleries, studio pages, real estate listings, event reports, collection showcases, or curated visual sets before you build a full catalog. Unlike a rigid grid of identical squares, this format usually preserves more of the character of the original images.

According to the official documentation, the module supports several frontend variations: different gallery styles, output without filtering, custom colors, and a no-gap layout. That matters because in practice, a site owner is not choosing an abstract "gallery" but a specific display mode that fits the page design. A photographer's page benefits from breathing room between images and filters by genre. A promo block on a landing page may work better as a dense gapless grid. A catalog of visual examples benefits from search and tags.

At the same time, this module is not a replacement for a full media catalog, a permission-based archive, or a photo-selling component. It is closer to a modular showcase: prepare a media set, add captions and tags, configure the display, assign a position or output the module through Joomla's module system, then verify the public view. If you need a complex album structure, user uploads, comments, selling features, or a large archive with individual pages for each photo, it makes more sense to compare it with component-based gallery solutions in the related alternatives section.

Practical rule of thumb: JUX Justified Gallery works best when you need to quickly publish a visual set on a specific Joomla page and control its appearance through module settings rather than build a separate media system.

Who JUX Justified Gallery fits - and when it may be unnecessary

Before installing it, define the real use case honestly. The module is especially useful for sites where images are part of the user decision process: a photographer showing work series, a design studio presenting projects, a store or workshop displaying product examples, a travel agency showcasing destinations, a school publishing photo recaps, or a restaurant showing its interior and dishes. In all of these cases, fast visual navigation matters.

Good use cases

If you already have a prepared image set and clear categories, JUX Justified Gallery helps you build a structured block without custom development. Tags can be used as filters, the number of images shown initially helps avoid overloading the page, and the popup viewer gives visitors a convenient way to view an enlarged image or video without leaving the page.

• A portfolio for a photographer, designer, architect, illustrator, or creative studio.
• A service page that needs project examples and quick filters by project type.
• An event photo recap where a load-more button works better than a long wall of images.
• A visual media showcase inside a Joomla template, with the module assigned to a specific position.
• A small image catalog with search by title or tag.

When another solution is a better fit

The module may be unnecessary if you only need to place 3 or 4 images inside a regular article. In that case, the standard editor, template classes, or a lightweight content plugin will usually be simpler. It is also not the best choice for a large archive with hundreds of albums if you need dedicated category pages, metadata import, user uploads, comments, download protection, complex roles, or commercial photo sales.

Performance also deserves serious attention. Any visual gallery depends on image weight, item count, and caching. Load-more functionality helps avoid showing everything at once, but it does not replace proper file preparation. If you upload dozens of heavy originals without compression, visitors will still get a slow page even if the grid itself looks clean.

What to check before installing it on a Joomla site

Preparation is not just a formality. A gallery module usually touches several parts of the site at once: the Joomla file system, media files, the admin panel, the template position, menu assignment, caching, the public frontend, and sometimes popup scripts. If you check these areas in advance, the initial setup is much faster and does not turn into a hunt for why "nothing is showing."

Compatibility and requirements

The Joomla Extensions Directory listing and the developer page for JUX Justified Gallery indicate compatibility with modern Joomla branches, including Joomla 4, Joomla 5, and Joomla 6. The documentation also lists server requirements: PHP, MySQL, Apache, XML support, Zlib, OpenSSL, and cURL. Some of those requirements are presented as a general JoomlaUX block, so before installation it is worth comparing them against the current requirements of your Joomla version and hosting environment.

Check PHP and server extensions especially carefully if the site has not been updated in a long time or was migrated from another host. The module works with image uploads, media files, and public JavaScript, so issues may not show up during installation itself, but later when uploading files, rendering the grid, or opening the popup viewer.

Permissions, folders, and images

The documentation states that you can choose an image from a folder in the module settings and upload files into the required folder. That means before configuration, you should know where the media set will live and who is allowed to update it. On a live site, it is better not to mix different galleries in one shared folder. Create separate directories for portfolios, events, products, or projects so you do not later confuse files or break an older gallery when updating a new one.

Prepare the images in advance:

• Remove duplicates and stray files that should not end up in the public gallery.
• Compress images to a reasonable weight, especially if the gallery appears on the homepage.
• Use clear file names so editors do not mix up series during upload.
• Prepare titles and tags if you plan to use filtering and search.
• Make sure images with different proportions still look good in a justified grid.

Module position and menu assignment

JUX Justified Gallery is delivered as a module, and with Joomla modules the result depends on the template position and menu assignment. Official Joomla documentation explains that positions are defined by the template and that modules can be enabled or disabled per menu item. So before installation, decide where the gallery should appear: in a template position, on a dedicated page, in a sidebar, after an article, or inside content through Joomla's module-loading mechanism.

If you are not sure about your template positions, enable position preview in the template settings and view the public page with the ?tp=1 parameter. On a live site, it is best to disable that afterward. It is a simple way to avoid assigning the gallery blindly to a position that is not rendered at all in the current template or is hidden on the page type you need.

Installing the module and publishing it for the first time

The installation process for JUX Justified Gallery is typical for Joomla modules: the downloaded package is installed through the admin panel, then the module must be located in the site modules list, configured, and published. The documentation describes the path through the extension installer and the Upload Package File block.

A low-risk installation sequence

If the site is already live, create a backup first and test the extension on a staging copy. That is not a special requirement of JUX Justified Gallery. It is just good practice for any module that adds JavaScript, styles, and frontend output. Then use the standard Joomla installer: open the admin panel, go to extension installation, select the module archive, and upload it through Upload Package File.

1. Install the module package through the standard Joomla installer.
2. Open the site modules list and find the installed JUX Justified Gallery module.
3. Create or open the module instance that will control the specific gallery.
4. Assign a template position or prepare a dedicated position for output inside content.
5. Set the publication status, access level, and menu assignment.
6. Save the module and check the page on the public frontend.

At this stage, do not try to configure every style and filter at once. First make sure the module appears on the correct page with at least a small test set. If it does not display, the issue is much easier to debug before you enable complex effects, custom colors, and a large number of images.

First check after installation

The minimum verification looks like this: the module is published, the selected position exists, the menu assignment includes the target page, the user has access, images have been added to the module, and the public page displays the grid without layout errors. If the gallery is visible but does not look the way you expected, move on to height, spacing, and style settings. If it is not visible at all, first check the position, status, menu assignment, cache, and whether images are actually present.

Short takeaway: installation is only complete when the published module is visible on the intended page and shows test images, not when the archive upload finishes.

Configuring images, tags, and popup types

The first meaningful section in the documentation is module configuration. There you can choose images from a folder, upload them to the required location, add a title for each image, assign a filter tag, and choose the popup image type. This is where the gallery gets its real purpose - not just which files appear in the grid, but how the visitor can navigate the set.

How to prepare the image set

Approach the gallery as a content block. Do not add images in random order just because they exist in the folder. First decide which groups matter to the visitor. For a portfolio, that might be Portrait, Wedding, Studio. For a remodeling site, Kitchen, Bathroom, Before After. For an education site, Events, Classes, Campus. You do not need to translate the module's real UI labels in an English article, but the titles and tags in the admin area should still be clear and useful for the editor.

If filtering will be enabled, tags should be short and consistent. A common gallery mistake is creating too many nearly identical tags. A visitor should not have to choose between "interior," "interiors," "interior design," and "interior projects" if all of them lead to the same group. Four to seven clear filters are better than a long row of random buttons.

Titles, search, and video

The documentation states that search can find items by image title or tag, and that you can add a URL from YouTube, Vimeo, or mp4 for video. That makes the module more useful than a simple photo grid: within one showcase, you can mix images and video if the use case calls for it. But media mixing should be done carefully. If a visitor expects a photo gallery and some items suddenly open video, the captions should make that clear in advance.

Enable the popup viewer when users need to inspect details. For a small decorative block at the bottom of a page, it may be unnecessary. For portfolios, photography, products, real estate, or architecture, it is almost always helpful: the grid gives a quick overview, and the popup lets visitors inspect a larger file without moving to a separate page.

Checking the content

After adding images, save the module and check the public page. Open several items, test the filter, search, and popup. If one image breaks the visual flow of the grid, check its proportions and file weight. If the filter does not show the expected set, check the tags. If a video does not open, make sure the link is supported and does not require authentication or private access.

Best display settings: height, spacing, load more, and filters

The most important section for daily use is the display settings. In the documentation for Display Options, the listed parameters define the appearance and behavior of the gallery: minimum image height in justified mode, spacing between images, number of items shown initially, number of items added when Load More is clicked, random ordering, last-row display, filter, all filter, search, filter alignment, popup, and popup slider effect.

Image height and spacing between items

Image Height sets the minimum image height in justified mode. This is not just a decorative number. The higher the value, the larger the items and the fewer images fit into the first screen. The lower the value, the denser the grid and the more the gallery behaves like a visual overview strip. For portfolios, a medium height is usually the best choice: visitors can see enough detail, but the page does not turn into an endless list of large frames.

Space Between image controls the spacing between images. For a clean editorial-style grid, keep a small gap. For a dense showcase, you can reduce it close to zero if the documentation and site style support that. But do not forget about mobile screens: spacing that is too tight can hurt readability, especially if images have captions, hover effects, or colored borders.

First screen and the Load More button

Items Display First determines how many items the user sees immediately. Items Load More sets how many more appear after clicking the load-more button. Here you need to balance speed and completeness. Show too few, and the gallery feels weak. Show too many, and the page may load slowly and take up too much space.

For a typical block on a service page, start with 8 to 12 images on first display and load about the same number or slightly fewer afterward. For a large photo series, you can raise the numbers, but only after checking speed and mobile behavior. If the gallery sits near the end of a long article, the first display can be more compact: the visitor has already gone through the main text and should not have to wait for a large media block to load.

Filter, all filter, and search

Show filter enables tag-based filtering, and All filter adds a tab for showing all items. Search lets users look up items by title or tag. Turn on filtering only when you actually have groups that help the visitor. If the gallery contains 10 images with no real division, a filter just adds noise. If the gallery contains 40 works across multiple directions, filtering becomes one of the main usability features.

Filter align sets the alignment of the filter controls. In practice, center alignment works well for promo blocks and portfolios, left alignment fits content-heavy pages, and right alignment is mostly for rare layouts built that way intentionally. After changing alignment, test not only on desktop but also on tablet views, because long tag names can wrap awkwardly.

Random order and the last row

Order Randomize can be useful if the gallery should show different works at the top each time. But for portfolios, case studies, and instructional material, random order is not always a good idea. Editors often arrange images meaningfully - from strongest to secondary, or from overview to details. Enable random order only where sequencing does not matter.

Last row display affects how the final row of the justified grid looks. This is especially noticeable when the image count does not naturally fill a row. If the last row looks too stretched or too empty, try another setting and see whether adding or removing 1 or 2 images from the set gives a better result.

Styles, custom colors, and safe CSS adjustments

The Item Style Options tab lets you choose an image output style and enable design customization. The documentation mentions support for five styles, plus the ability to override item styles through Customize design. For most sites, that is enough: choose a ready-made style first, then fine-tune colors, borders, background, or caption behavior if needed.

The main mistake here is enabling customization immediately without understanding the result. Ready-made styles help you quickly see which visual language fits the page. Only then does it make sense to adjust colors and spacing. If the site already uses a strict palette, do not turn the gallery into a separate bright block. If the site's design is calm and restrained, colorful filters or borders may look out of place.

How to choose a style without endless rework

First test 2 or 3 options on the same image set. Do not compare styles using different sets, or you will be judging the photos rather than the style itself. Then check the result in three states: the normal grid, a hovered item, and the open popup. If captions are hard to read, adjust not only text color but also background, overlay darkness, size, and spacing.

For a work gallery, avoid overly aggressive effects. Visitors should look at the images, not the animation. A promo block can support a more expressive style, but it still needs to match the overall site design. When in doubt, choose the calmer option and make only the filters or captions more pronounced.

A small CSS tweak through Advanced

The documentation for Advanced lists Custom CSS and Module Class Suffix. That is a safe place for small adjustments because you are not editing the Joomla core, template files, or the module itself. First give the module a clear suffix such as jux-gallery-portfolio, then add CSS that applies only within that instance.

The example below does not rely on internal module classes that may change. It works around your suffix and carefully scopes images, links, and buttons inside the block. If your version outputs different markup, keep only the rules that actually affect the target elements.

.jux-gallery-portfolio img {
  border-radius: 6px;
}

.jux-gallery-portfolio a {
  outline-offset: 3px;
}

.jux-gallery-portfolio button,
.jux-gallery-portfolio .btn {
  border-radius: 4px;
  font-weight: 600;
}

After adding the CSS, save the module, clear the cache, and check the page. If the tweak does not work, make sure the class suffix was actually applied to the module. If it affects other blocks, your selector is too broad or the suffix was assigned incorrectly. Rolling it back is simple: remove the CSS from Custom CSS or temporarily remove the suffix.

How to place the gallery exactly where you need it on a Joomla page

Because JUX Justified Gallery is a module, its visibility depends on more than its own gallery settings. You need to connect it properly to the Joomla template, the position, the menu item, and the access level. This is a separate working scenario and a common source of errors: the module is configured, images are added, but nothing appears on the page.

Template position

A position is the place where a template outputs modules. In one template, top may be a wide area under the menu; in another, a small header zone; and in a third, it may not exist at all. So you cannot rely only on the position name. Use position preview or your template documentation.

If the gallery should be part of the main page content, choose a wide position where the grid will not be squeezed into a narrow column. Width matters especially for a justified gallery: the layout algorithm needs horizontal room, and in a narrow zone the effect can look much worse. A sidebar is only suitable for small sets, such as 3 to 6 images without complex filtering.

Menu assignment

In Joomla, a module can appear on all pages, only selected menu items, or all except selected ones. For a gallery, precise targeting is usually best: a portfolio page, a service page, a dedicated "Work" section, a product page, or an article with a project recap. If you assign the module to all pages, it may show up where visitors do not expect it, which hurts both usability and speed.

After changing the assignment, open the public page through the regular menu, not only through a direct URL from the admin panel. Joomla ties module output to menu items, so the same piece of content can behave differently depending on how the visitor reached it. If the gallery is missing, check whether the page has a proper menu item and whether that item matches the module assignment.

Output inside article content

If you need to place the gallery in the middle of an article or page, use Joomla's standard approach for loading modules by position or name, if that is enabled on the site. In that case, create a dedicated position that is clear to editors, such as portfolio-gallery, assign it to the module, and insert the corresponding Joomla syntax into the content. Do not use a random system position that is already occupied by other blocks.

Check this setup especially carefully: the article, module, and menu must work as a single chain. If an editor duplicates the article while the module is still tied to the old menu item, the gallery may disappear or show up in an unexpected place.

Practical example: a studio portfolio with filters and load more

Let's look at a concrete scenario: a studio needs to display 36 portfolio images on a service page. The visitor should see a clean grid, quickly filter works by type, open a large image, and avoid waiting for all files to load at once. This is a typical use case for JUX Justified Gallery because it includes justified layout, tag filtering, search, a popup viewer, and load more.

Goal and preparation

The goal is to create a single module on the "Portfolio" page where the first images open quickly, filters group the work, and the remaining items load on demand. Before configuring it, prepare the image folder, optimize the files, divide the work into 4 or 5 groups, and draft short titles in advance. For this example, use the groups Interiors, Branding, Events, Products.

Configuration steps

1. Create a new JUX Justified Gallery module instance or open an existing installed one.
2. Add images from the prepared folder and give each item a clear title.
3. Assign the tags that will be used by the filter. One tag should represent one clear group.
4. In the display settings, choose a moderate Image Height so the grid feels like a portfolio rather than a strip of thumbnails.
5. Set a small Space Between image if the page design supports a tighter grid, or leave more air for a premium-style portfolio.
6. Enable Show filter, All filter, and, if needed, Search.
7. Configure Items Display First so the first screen is not overloaded, and Items Load More so each click adds a noticeable batch of work.
8. Enable Enable Popup if visitors need to inspect large images.
9. Assign the module to a wide template position and link it to the portfolio page menu item.
10. Save, clear the cache, and check the public page in a regular browser.

Expected result and nuances

A clean visual grid should appear on the page. The filter buttons should show only items with the selected tag, search should find images by title or tag, the popup viewer should open a large preview, and Load More should add the next images without forcing the full set to appear immediately.

The nuance is that the quality of the result depends on more than the settings. If the images vary too much in size, some rows may look uneven. If tags are assigned inconsistently, the filter will feel broken. If the page is cached too aggressively, module changes may not appear right away. So after every meaningful change, run a short check: save, clear the cache, refresh the public page, test the filter, open the popup, click load more.

Configuration patterns for different page types

The same module can behave very differently depending on where it is displayed. That is not a flaw but a normal feature of Joomla modules: a service page, portfolio, event recap, and homepage all serve different goals. If you copy one set of settings across every page, the gallery will end up too heavy, too thin, or overloaded with filters. Below are practical ways to choose settings without inventing features or editing code.

Portfolio or work page

For a portfolio, the main goal is to show quality and range. The justified grid should be large enough for visitors to evaluate the images before opening the popup. If Image Height is too small, the work looks like technical thumbnails. If it is too large, the page turns into a long row of oversized frames. Start with a medium height and check how many rows fit into the first screen.

Filters are almost always useful for a portfolio, but only if the groups help users choose work. Good filters answer the visitor's question: "show me a similar type of project." Bad filters reflect the editor's internal folder structure. For example, on an interior studio site, grouping by room type or style is clearer than technical tags such as folder-01 or set-a.

For Items Display First, choose a number that gives visitors a strong sample of quality before they need to click Load More. If the first 6 images look too similar, visitors may not understand the range of the work. If the first 30 load at once, the page may become too heavy. It is better to intentionally curate the first items and leave load more for deeper browsing.

Event photo recap

An event recap differs from a portfolio because visitors often want to browse many shots, but not necessarily in a perfect sales-oriented sequence. A denser layout, smaller spacing, and an active load-more button can work well here. Filtering is useful if the event breaks naturally into clear sections: Stage, Guests, Workshop, Backstage. If filters do not help, a clean grid plus search is usually better.

The popup viewer is useful for event recaps, but check whether the source files opened there are too heavy. Visitors may open many images in a row, so file preparation before upload matters. If video clips are included, mark them with a separate tag or a clear title so users understand they are not standard photos.

Mobile testing is especially important for this kind of page. Event recaps often include many vertical images, and on a narrow screen the filter and search can take up more space than the grid itself. If the filter bar becomes too long, reduce the number of groups or use shorter tag names.

Homepage block

On a homepage, the gallery usually should not expose the full archive. Its job is to provide visual proof of quality and send the visitor onward - to the portfolio, a service page, or a projects section. That is why the homepage usually benefits from fewer initial items, no unnecessary search, and only the clearest filters - or no filter at all.

If the gallery appears above the middle of the page, treat it as a performance-sensitive element. The first screen should not wait for dozens of images. In this setup, Items Display First is usually lower, Load More may be hidden or replaced by a regular link to a dedicated page next to the block, and the gallery itself should sit in a wide position with clean spacing.

Do not use random order on the homepage if the first images are supposed to build trust. Choose the strongest work manually first, then decide whether rotation is actually needed. Random order can sometimes create a lively effect, but it can also put a weak or repetitive series in the most important part of the site.

Gallery inside an article or guide

If the gallery is inserted into article content, it should support the text rather than compete with it. In that scenario, it is better to keep the image set small, disable complex filters, and use the popup only for images that truly need larger inspection. Loading a module inside content is convenient, but it requires discipline: a dedicated position, a clear module name, and precise menu assignment.

In a guide or instructional article, images often need to stay in a specific order. Do not enable Order Randomize here, or the logic of the steps disappears. If you need to separate visual blocks, create several small modules instead of one general gallery with filters. That way, the reader sees each image group next to the explanation it belongs to.

The key scenario-based setting: for portfolios, larger first-screen visuals and filters matter most; for event recaps, load more and comfortable browsing matter most; for the homepage, speed and a strong curated selection matter most; for articles, order and connection to the text matter most.

Checking the result: what to review after publishing

Verification is not just about confirming that the module "exists on the page." A gallery is both a visual and interactive element. It should load quickly, reflow correctly, avoid breaking the template, stay usable on mobile devices, and not interfere with the main content of the page.

Frontend review

Open the page as a regular visitor. Do not rely only on administrator mode, because access rules, caching, and menu behavior may differ. Check the first screen: the gallery should not jump during loading, take up unexpectedly large space, or overlap nearby blocks. Then click several filters, try search, and open 2 or 3 items in the popup viewer.

• The grid should look even, without large empty gaps or randomly stretched images.
• Filters should show the expected groups and should not leave the user on an empty result without a clear reason.
• The Load More button should add the next batch of items and should not duplicate images that are already visible.
• The popup viewer should open, close, and switch items without conflicting with the template.
• On mobile, the filter and search should remain readable and should not break the page width.

Speed review

If the gallery appears on an important page, check performance before and after adding the module. You do not need to expect a perfect score from every media-heavy page, but image weight, initial display, and load more should all be reasonable. The most common cause of a slow gallery is not the module itself, but oversized source files.

Compare two states: a first visit without cache and a repeat visit after cache warm-up. If the first visit is slow, reduce the number of initially shown items, optimize the images, and check whether large originals are loading where thumbnails should be used. If the repeat visit is still slow, review caching settings, third-party script conflicts, and the total page weight.

SEO, accessibility, and media handling

The official documentation mentions SEO-friendly behavior, but that should not be treated as a promise of ranking growth. Search engines care about more than the module itself: page context, image quality, captions, alt text, speed, heading structure, and the absence of technical errors all matter. The gallery helps present visual material, but the SEO outcome depends on the page as a whole.

How to make the gallery useful for both visitors and search

Start with the text around the gallery. If the module is placed after a projects section, explain what the set shows and how to use the filters. You do not need a long description for every image, but a short introduction before the gallery helps both visitors and search engines. Image titles and tags should be clear, distinct, and not stuffed with keywords.

For accessibility, interactive elements should be readable, high-contrast, and easy to operate. Check the color of filters and buttons against the page background. If you change the style through custom colors, do not make text too pale or too small. If the popup viewer is used for viewing important details, make sure the user understands how to close it and return to the page.

Image optimization

Prepare the files before uploading them into the module. Use reasonable dimensions, compression, and consistent naming. For a portfolio, you do not always need to keep the source file at maximum resolution: visitors should be able to inspect the work, but they should not have to download a tens-of-megabytes original. If the site uses a separate image optimization tool, check first that it does not break the popup viewer or load-more behavior.

For pages with many images, do not rely on cache alone. Cache helps repeat visits, but the first visitor still downloads the actual files. That is exactly why Items Display First and Items Load More are useful - they give the editor control over the first screen and the later loading behavior.

Limitations and settings worth questioning

Any gallery module looks simple only until it is placed on a real site with a specific template, caching, third-party scripts, and different user groups. That is why it is important to understand not only the capabilities of JUX Justified Gallery, but also the boundaries where it is better not to overcomplicate the setup.

Commercial model and support

The JED listing and developer page describe JUX Justified Gallery as a paid JoomlaUX extension. This article should not lock in a specific price because pricing can change, and access, support, and update terms depend on the developer page. The practical takeaway is different: before using it on a working site, make sure you have access to the current package, documentation, and updates, especially if the site runs on a newer Joomla version.

Video inside the gallery

The documentation states that you can add video URLs from YouTube, Vimeo, or mp4. That is useful when the gallery is genuinely mixed - for example, work photos plus short process videos, property walkthrough clips, or a presentation video. But do not turn a photo gallery into a random media mix. If video matters, separate it with a tag, add clear titles, and test the popup viewer on mobile.

Custom CSS and updates

Custom CSS is best kept small and tied to a specific module instance. Do not override global Joomla or template classes just to change one gallery. Do not edit the module files, because an update can overwrite your changes. If you need serious visual changes, use the built-in style settings, Module Class Suffix, Custom CSS, and a staging copy of the site.

How JUX Justified Gallery behaves with caching and updates

The changelog for JUX Justified Gallery mentions a fix for duplicates when Progressive caching mode is enabled, and the related JUX Photo Gallery also includes a similar Progressive Caching fix. That is an important signal for administrators: gallery modules with load more and filtering need to be tested together with caching, not separately from it.

Official Joomla documentation explains that under progressive caching, modules for non-logged-in users may be cached differently than under conservative mode. So after changing gallery settings, tags, item counts, or styles, always clear the cache and check the public page as a guest. If the issue appears only for regular visitors while everything looks fine in an admin session, cache should be one of the first things you investigate.

Practical cache-check sequence

1. Save the module and open the page normally.
2. Clear the Joomla cache and the cache of any external optimizer, if one is used.
3. Check the page in a private browser window as a logged-out visitor.
4. Test the filter, search, popup viewer, and Load More.
5. If duplicates or stale items appear, temporarily compare the behavior under less aggressive cache settings.

Do not draw conclusions from a single page refresh. With an interactive gallery, you need to test several actions in sequence, because some problems only appear after filtering or loading more items.

Why the gallery may not work - and how to find the cause

Troubleshooting is best done from simple to complex: first Joomla module visibility, then gallery content, then display settings, then cache and script conflicts. Below are common symptoms for this kind of module and safe checks that do not require editing the Joomla core or extension files.

The module is installed, but the gallery is not visible

Symptom: the module exists in the admin panel, images have been added, but the gallery does not appear on the public page.

First check the publication status, template position, access level, and menu assignment. Then open the page through the specific menu item the module is assigned to. If the current template does not render that position, the module will not appear no matter how its own settings are configured. If access is restricted, guests will not see it either.

How to fix it

Assign the module to a confirmed wide position, temporarily show it on the required menu item or on all pages for testing, save, and clear the cache. If the gallery appears, restore the precise assignment and continue configuring it. If it still does not appear, check whether the module actually contains items and whether the block is being hidden by template CSS rules.

The filter shows an empty result

Symptom: the filter button is present, but after selecting a category the images disappear or the wrong set is shown.

The likely cause is that tags are missing, misspelled, or inconsistent across items that should share the same tag. Check the image entries in the module settings. If search also returns nothing, look at the titles and tags, because those are the fields used for searching and filtering.

How to fix it

Reduce the tag set to clear groups, review every item, save the module, and clear the cache. If your version includes an option to show or hide the filter for items without tags, check that separately: the developer changelog mentions that capability being added in updates.

The Load More button duplicates items or does not add images

Symptom: after clicking Load More, items repeat, do not appear, or behave differently for administrators and guests.

Start with the item counts: Items Display First and Items Load More should be logically configured. Then check caching. The JUX Justified Gallery changelog includes a fix for duplicates under progressive caching, so an older package or aggressive cache behavior may be the actual cause.

How to fix it

Update the module to the latest available package, clear the Joomla cache, temporarily compare behavior under a different caching mode, and test the page as a guest. If the issue disappears when a specific cache layer or optimizer is disabled, set an exclusion for the gallery page or discuss compatibility with the developer.

The popup viewer does not open or conflicts with the template

Symptom: the image is visible in the grid, but the large preview does not open, opens blank, or breaks the page.

Check whether Enable Popup is turned on, which popup image type is selected for the items, and whether third-party template scripts are conflicting. The documentation mentions image and video lightbox support, and the changelog mentions a jQuery conflict fix for Joomla 5, so a JavaScript conflict is a real possibility.

How to fix it

First test it on a clean page without nearby extra modules. Then temporarily disable aggressive JavaScript minification or script combining if those features are enabled in an optimizer. Do not edit the module files. If the issue depends on a specific template, it is better to contact support with the page URL and a description of the steps.

The grid looks uneven or the images are too small

Symptom: the gallery is visible, but the rows look odd, the images are too small, the last row is stretched, or there is too much air between items.

Check Image Height, Space Between image, Last row display, and the width of the module position. Sometimes the issue is not the module itself, but the fact that the gallery was placed in a narrow column where a justified layout does not have enough width to work well.

How to fix it

Move the module to a wider position, increase or decrease the image height, adjust the spacing, and review the last row with different item counts. If specific images break the visual rhythm, replace them, crop the source, or move them into a different set.

How to expand the gallery safely after launch

Once the gallery is live and working, you do not need to complicate it immediately. A better strategy is to add features gradually and check the result at each step. Start with a stable grid and the correct position, then add filters, then search, then the popup viewer, then colors and CSS. That makes it much easier to understand which setting caused a problem if one appears.

Working with multiple galleries

If the site needs multiple galleries, create a separate module instance for each scenario. Do not try to use one module to serve every page through chaotic image swapping and menu reassignment. A portfolio page, an event page, and a homepage block usually need different settings for height, item count, and filtering.

For each instance, create a separate image folder and a separate Module Class Suffix if you plan to style them differently. That reduces the risk that CSS written for the portfolio unexpectedly changes the gallery inside an article or on the homepage.

Localization of captions and editorial discipline

If the site is multilingual, do not forget about image titles and tags. A filter with English technical tags on a Russian page will feel out of place if visitors can see those tags. In that case, create separate modules for each language version or use the Joomla multilingual approach already adopted on your site.

Do not rename tags without checking older filters. If an editor changes a tag, a filter may become empty or split one logical group into two. For larger galleries, it helps to maintain a short list of approved tags in the site's editorial documentation.

When JUX Justified Gallery is the right choice

JUX Justified Gallery is a strong choice for a Joomla site when you need a controlled visual grid with filters, load more, search, popup viewing, and style settings, and when the task fits the module format. It is especially useful for portfolios, studio work showcases, event photo recaps, project collections, and pages where visual content helps the visitor make a decision.

Before publishing, check compatibility, prepare the images, think through the tags, choose a wide position, tune the initial display and load more behavior, enable filtering only when it is genuinely useful, and after saving always test the public page as a regular visitor. If everything works reliably, you can download JUX Justified Gallery and test it on your page using a safe site copy or on a live project after creating a backup.

The simplest selection rule is this: if you need a fast, clean visual block in Joomla, this module fits. If the task has grown into a large media catalog with its own separate logic, it is better to look toward component-based galleries and plan the structure in advance.