Joomla Smart Search — Search Index, Filters and Search Results

In this tutorial, you'll learn how to set up and configure Joomla Smart Search — building the search index, creating search filters, customizing the search results page, and replacing the old Search component with the modern Finder-based search.

What You'll Learn

• What Smart Search is and how it differs from the old Search component
• Enabling all Finder plugins and indexing your site content
• Creating search filters to restrict results by content type
• Displaying a search box with the mod_finder module
• Customizing the search results page layout and options
• Viewing search statistics to understand what users are looking for
• Setting up cron-based indexing for automatic updates

Why It Matters

Search is how visitors navigate your site when they cannot find what they need through menus. A poor search experience sends visitors away. The old Search component in Joomla was slow, used basic SQL LIKE queries, and could not handle partial words or advanced filtering. Smart Search uses a pre-built index, similar to how search engines work. It returns results in milliseconds instead of seconds. For sites with hundreds or thousands of articles, the difference is dramatic. Smart Search also gives you tools to understand what users are searching for and improve your content strategy.

Real-World Use

A university website running Joomla has 2,000+ articles, 500 faculty profiles, 300 events, and 100 department pages. The old Search component returned results in 4–8 seconds and frequently timed out. Users complained they could not find anything. After migrating to Smart Search, building the full index, and configuring search filters for each content type, results appear in under 200 milliseconds. The search statistics showed the most common search was "scholarship" — information that was buried in the financial aid category. The university moved that content to a more prominent location, and user satisfaction improved significantly.

Learning Path

flowchart LR
  A["Joomla SEO"] --> B["Smart Search"]
  B --> C["Media Manager"]
  C --> D["Multilingual Sites"]
  D --> E["Joomla 4 vs 5"]

  classDef current fill:#38bdf8,color:#0f172a,stroke-width:2px
  class B current

What is Smart Search?

Smart Search is Joomla's built-in search engine, powered by the Finder component. It was introduced in Joomla 3.x and became the default search system in Joomla 4.x, replacing the legacy Search component.

Unlike the old Search, which ran SQL queries against the content database, Smart Search builds a search index. The index is a separate set of database tables optimized for full-text search. When a Visitor searches, Smart Search queries the index, not the content tables. This is much faster and supports:

• Partial word matching
• Exact phrase matching
• Taxonomy-based filtering
• Search term boosting
• Search suggestions
• Content type filtering

Enabling Smart Search

Smart Search requires several plugins to work. Let us enable them step by step.

Enable All Finder Plugins

1. Go to Extensions > Plugins
2. Search for "Finder"
3. You should see these plugins:

Enable all of them. Each plugin tells Smart Search how to index a specific type of content.

Install the Content Plugin

1. Search for Smart Search Content plugin
2. Enable it — this plugin updates the search index when content is saved

Install the Taxonomy Plugin

1. Search for Smart Search Taxonomy plugin
2. Enable it — this plugin indexes taxonomy terms (categories, tags)

Creating the Search Index

Once the plugins are enabled, you must build the search index:

1. Go to Components > Smart Search > Index
2. Click Index to start the indexing Process

The indexer processes all your content and stores it in the search tables. Depending on how much content you have, this may take a few seconds or a few minutes.

Reindexing

You need to reindex when:

• You add new content
• You update existing content
• You install new Finder plugins
• You change search filter settings

To reindex, click Index again. Smart Search automatically detects what has changed and only reindexes new or modified content.

Index Statistics

After indexing, the Smart Search dashboard shows:

• Total indexed items
• Items in each content type
• Last index date
• Index size

Search Filters

Search filters let you organize search results by content type. They work like categories for search.

Creating a Search Filter

1. Go to Components > Smart Search > Search Filters
2. Click New
3. Give the filter a name, such as "All Articles"
4. Select the content types to include:

5. Set Published to Yes

Using Search Filters in Modules

The mod_finder module (search box) can be configured to use a specific filter:

1. Go to Extensions > Modules > New > Smart Search (mod_finder)
2. In the Advanced tab, select a Search Filter
3. When users search, results are restricted to that filter's content types

Search Results Module (mod_finder)

The mod_finder module displays a search box on your site. It supports autocomplete and advanced options.

Setting Up mod_finder

1. Go to Extensions > Modules > New > Smart Search (mod_finder)
2. Configure:

3. Assign the module to the menu items where you want it to appear
4. Save and close

The search box appears on your site with autocomplete suggestions as the user types.

Advanced Search Options

When the user clicks the advanced search link, they see:

• Search term input
• Filter by content type (checkboxes)
• Filter by category (dropdown)
• Date range filter
• Sort by relevance, date, or title

Search Results Page

The search results page shows when a user submits a search query. You can customize how results are displayed.

Configuring Search Results

1. Go to Components > Smart Search > Options
2. Configure these tabs:

Result Layout tab:

Query tab:

Suggestions tab:

Search Statistics

The Statistics section shows what your users are searching for.

1. Go to Components > Smart Search > Statistics
2. You can view:

• Popular Searches — the most common search terms
• Popular Results — the most clicked results
• Empty Searches — searches that returned no results
• All Searches — a complete log of search queries

Empty searches are especially valuable. They show you what users expect to find but cannot. If many users search for "refund policy" and get no results, you know you need a refund policy page.

Search Term Matching

Smart Search supports several matching modes:

Configure this in Components > Smart Search > Options > Query tab under Match Type.

Taxonomy Boost

You can boost search results based on taxonomy. For example, articles in the "Featured" category can be boosted to appear higher in results. Configure this per filter.

Cron Indexing

Smart Search can reindex automatically via a cron job. This is essential for sites where content changes frequently.

Setting Up Cron Indexing

# Run Smart Search indexer via cron
# Add this to your crontab to run every hour
0 * * * * /usr/bin/php /path/to/joomla/cli/finder-indexer.php

# Or use the Joomla CLI
/path/to/joomla/cli/joomla.php finder:index

For Joomla 5, use the built-in task scheduler:

1. Go to System > Scheduled Tasks
2. Click New
3. Type: Finder Index
4. Set frequency (e.g., hourly)
5. Enable the task

Replacing the Old Search Component

Joomla 4 deprecated the old Search component. Joomla 5 removed it entirely. If you still have the Search component enabled:

1. Go to Extensions > Manage > Manage
2. Search for com_search
3. Uninstall or disable the Search component
4. Ensure Smart Search is configured as the default search

Search URL

Smart Search uses this URL format:

https://yoursite.com/component/finder/search?q=search+term

If you configured a menu item for Smart Search, the URL will be:

https://yoursite.com/search?q=search+term

Search Filter Module

You can also display a search filter module on the search results page, letting users filter results by content type after they search.

1. Go to Extensions > Modules > New > Smart Search Filter (mod_finder_filter)
2. Configure which content types to show
3. Assign to the search results page

Common Mistakes

1. Not indexing after enabling Smart Search: The index is empty by default. You must go to Components > Smart Search > Index and click Index before any search will return results.

2. Forgetting to enable all Finder plugins: If you only enable the content plugin but not the categories plugin, category pages will not appear in search results. Enable all Finder - * plugins.

3. Not reindexing after content changes: New or updated articles will not appear in search results until you reindex. Set up Cron Jobs or use the task scheduler for automatic reindexing.

4. Using the old Search component in Joomla 5: Joomla 5 removed the old Search component. If your site still references it, search will fail. Disable com_search and use Smart Search exclusively.

5. Ignoring search statistics: Empty searches are a goldmine of content opportunities. If users search for something and find nothing, you can create that content and improve their experience.

Practice Questions

1. How does Smart Search differ from the old Search component? Answer: The old Search runs SQL queries against content tables on every search — slow and limited. Smart Search builds a pre-indexed database optimized for full-text search. It returns results in milliseconds, supports partial words, taxonomy filtering, and search suggestions.

2. What plugins must be enabled for Smart Search to work? Answer: The Finder - Smart Search Content plugin (indexes articles) and Finder - Smart Search Taxonomy plugin (indexes categories/tags). For other content types, enable Finder - Smart Search Contacts, Categories, News Feeds, Tags, and Users plugins.

3. How do you set up automatic reindexing in Joomla 5? Answer: Go to System > Scheduled Tasks, create a new task of type Finder Index, set the frequency to hourly or daily. Alternatively, set up a cron job that runs php /path/to/joomla/cli/finder-indexer.php on a schedule.

4. Challenge: Set up Smart Search on a Joomla site with at least 50 articles across 10 categories. Create three search filters (Articles only, Categories only, All Content). Install mod_finder with autocomplete on the site header. Search for various terms and note the results. Check search statistics to see what terms were used. Write a one-page analysis of what the search data tells you about your content.

FAQ

Mini Project

Your task is to implement a complete Smart Search setup for a Joomla site.

Create a Joomla installation with at least 30 articles across 5 categories, 10 contacts, and some tags. Perform the following:

1. Enable all Finder plugins (content, categories, contacts, news feeds, tags, users)
2. Build the full search index
3. Create three search filters: "Articles Only", "People" (contacts + users), and "Everything"
4. Add the mod_finder module to the site header with autocomplete enabled
5. Create a menu item for the search results page
6. Configure the results layout to show description, date, and URL
7. Enable search statistics
8. Set up cron indexing via the Scheduled Tasks component
9. Search for several terms and verify results appear correctly
10. Review the statistics data

Document each step. This exercise mirrors a real-world implementation for a content-heavy site.

What's Next

Now that your search is configured, learn how to manage media files:

Continue to Lesson 32: Joomla Media Manager — Upload, organize, and edit images and documents.

Related lessons:

• Joomla SEO — Drive traffic to your searchable content
• Joomla Multilingual Sites — Search across multiple languages