Get all the training! Join today and get access to 2981 training videos and books: Start Learning Now!

How to Use Drupal's Search Module


A lot of things are simple in Drupal ... once you know how.

The Search module is a perfect example of something that is initially confusing to set up, but simple once you know how to do it correctly.

This week we had several questions from our members about the Search module, so we wrote this tutorial to help them out.

There are several confusing elements to the Search module. Let's address them one-by-one:

Confusion #1: Indexing isn't instant

When you write a new content item for your Drupal site, it appears on your site:


However, when you search for the content, it can't be found:


So here's the first point of confusion: your content will not be indexed instantly after it has been added to the site.

Confusion #2: How to re-index the site

After users have tried and failed to find their new content, they often head to Configuration > Search settings. This is a logical step. Even when you visit this page, the information seems helpful.

In the image below, I see that there is 1 new item that needs to be indexed:


However, if you click the "Re-index site" button, it won't produce the result you helped for.


So that's the second point of confusion: Configuration > Search settings isn't very helpful.

The correct way to get your site's content indexed is to go to Configuration > Cron.

Drupal's Search module requires a cron job to run correctly.

Inside Configuration > Cron, click on the "Run cron" button.


Now the Search module will successfully index your new content:

Confusion #3: When cron runs

On the Configuration > Cron screen, you can tell your site to run cron regularly. This should index your content automatically, but it's not always easy to tell when this will happen.

The cron job will be triggered by the first users who visits your site after the time period is up. So, even if you have the cron set to run every 3 hours. it won't run until the next visitor arrives.

This is one reason why people can become confused by using the Search module on development sites where vistiors are rare.


About the author
Steve is the founder of OSTraining. Originally from the UK, he now lives in Sarasota in the USA. He was a teacher for many years before starting OSTraining. Steve wrote the best-selling Drupal and Joomla books.

Get all the training! Join today and get access to 2981 training videos and books: Start Learning Now!

(+1) 678-830-2168
| | Contact us

Get free, weekly updates
from the OSTraining Newsletter


© 2015 | Open Source Training LLC |
All Rights Reserved