Build your own search

By Ladoo posted on 20 Oct 2011

Build your own Search screencast

Creating your own, personal Search Page will help you find an asset, just like it does for users of your website, without having to expose the page to the public

Quick Search

See that box in the top right of the Administration Interface?


It's more useful than you think! To jump directly to an asset, in the Quick Search box, enter:

  1. An asset ID (just the number, no "#")
  2. URLs (e.g.
Or enter some search terms in the Quick Search box to have Matrix return a list of all the matching assets. Matrix will find assets with your keywords in the name of the asset, its contents, or in its metadata.

Build your own Search Page

As your system grows, Quick Search may become less useful. This is because the Quick Search isn't restricted to just your section of the system: it returns results from any other site or folder. On large systems, a search could return dozens or hundreds of matching results.

Creating your own, personal Search Page will help you find an asset, just like it does for users of your website, without having to expose the page to the public. Search Page assets are far more flexible than the Quick Search, as they can be configured to your exact requirements. Search Pages can be set up to:

  • search for live assets only;
  • find assets that haven't been updated recently;
  • search for assets in a specific part of the system.
Here's how you can create your own Search Page. In this example, we'll create one just for Standard Pages. In a particular site:
  1. Create a Search Page asset and on the Details screen:
       a. Set Root Nodes to the Site asset to be searched.
       b. Set Asset Types to Search for to "Standard Page".
       c. Select all the Search Statuses.

    Create Search

  2. On the Search Fields screen:
       a. Set Allow Empty Searches? to "Yes".
       b. Add a New Search Field Name called "search-field".
       c. Add a Data Source of type "Include All".

    Search field

  3. On the Edit Contents screen of the "Initial Search Page Layout" (which is a child of the Search Page asset):
       a. Use the -select keyword- drop down to insert "Input field for search-field".
  4. On the Edit Contents screen of the "Default Format" asset (which is a child of the “Type Formats” Folder) click the "<>" button, and replace the existing HTML with:
<a href="%asset_url%/_admin/?SQ_BACKEND_PAGE=backend_section&am_section=edit_asset&assetid=%asset_assetid%&asset_ei_screen=contents&SQ_BACKEND_PAGE=main" target="sq_main">Work more efficiently with Matrix</a>

Once the Search Page asset is set up, simply preview the asset and enter a search term. Clicking on any of the results links will take you directly to the Edit Contents screen for that asset. Alternatively in the URL substitute asset_ei_screen=contents for asset_ei_screen=details to go to the Details screen.


  1. Avatar
    07 Jun 2013 12:54pm Scott Hall
    Hey Guys

    Might want to review this code example. I haven't double checked but I think there are two issues with it at the moment...

    1. You've hard-coded the asset id, this should be asset_assetid. Users who implement this example will get an error if this asset does not exist or all search results will go to the same asset it does.

    2. This example will not load the asset into admin with it located and expanded within the asset map tree. Instead of using /_admin at the start of the HREF use asset_url

    So valid code example including ability to locate is asset map would be...

    <a href="asset_url/_admin/?SQ_BACKEND_PAGE=backend_section&am_section=edit_asset&assetid=asset_assetid&asset_ei_screen=contents&SQ_BACKEND_PAGE=main>Work more efficiently with Matrix</a>

    Nice work by the way.


  2. Avatar
    07 Jun 2013 12:54pm Scott Hall
    OK, looks like my keywords and code example there were handled as one might expect, my bad. What I was saying is use asset url keyword replacement before /_admin and where the asset id exists in the query replace with asset id keyword replacement.
  3. Avatar
    07 Jun 2013 12:54pm Anton Babushkin
    Hi Scott,

    Thanks for letting us know. I've updated the code block appropriately.

    P.S. The asset_url keyword isn't actually required thanks to the assetid parameter.
  4. Avatar
    07 Jun 2013 12:54pm Scott Hall
    Hey Anton

    As per my original comments, the use of asset url keyword before /_admin means that the asset map will load, expand, and locate the asset within the asset map tree so you have context of where that asset sits within the tree structure. Without this I think you'll find matrix will load the correct asset screen but the asset map will just show the site asset.


Post a new comment Post a new comment

Output content to a file

By Ladoo posted on 17 Nov 2011

As well as HTML and text, Matrix can be configured to directly output XML, iCal, RTF and even Word and Excel documents, so that users can directly download and work with these files.

Release notes for Matrix 1.2

By Anton Babushkin posted on 16 Jul 2013

You can create your own personal Search Page to assist with locating and editing the content you look after. This can be especially helpful in larger systems where quick search becomes less accurate.

Squiz Matrix Keyboard Shortcuts

By Nathan Cram posted on 18 May 2009

Keyboard shortcuts can save you time when working in the administration interface by helping you quickly move around the asset map.

Unfolding the Asset Map

By Nathan Cram posted on 16 May 2009

The Asset Map shows the hierarchy of the assets that comprise your website and allows you to manage them.

Comment all you want

By Liam Coltman posted on 08 Sep 2011

Using a combination of an Asset Builder and an Asset Listing in Mysource Matrix can allow you to create a comment area in your website and can be used for blogs.

Sharing content

By Ladoo posted on 29 Apr 2012

An examination of the pros and cons of different sharing techniques within Squiz Matrix.

Use fewer design customisations

By Ladoo posted on 26 Jun 2012

Matrix Design and Design Customisations offer a great degree of flexibility in how an HTML design can be created and modified. They are so powerful in fact, they tend to be overused and can become real roadblocks for productivity when best practices for using Designs are not followed.

Hiding web paths

By Ladoo posted on 24 Jan 2012

If you have a group of assets that only exist for the purpose of appearing in a list, you ideally don't want these assets to be accessible to the public at all.


By Ladoo posted on 23 Feb 2012

Most content management systems only offer basic search functionality, and Matrix is no exception.

Pretty as a picture Image Gallery

By Liam Coltman posted on 13 Nov 2010

Image Galleries can help to add a bit of colour to your website. With a little bit of tinkering you can make an image gallery that will rival the Louvre

Paint Layouts

By Liam Coltman posted on 06 Mar 2010

The best way to think of a Paint Layout is a Design File for your page content.

News delivered to your doorstep

By Liam Coltman posted on 10 Sep 2010

With users becoming more and more demanding on their news and website updates RSS provides the perfect option to keep readers up to date with what is happening on your site.

Matrix PHP API - Creating Standard Page Assets

By Anton Babushkin posted on 28 Feb 2011

Using the Matrix PHP API can allow you to do more than you previously would have thought possible. This article will teach you how to create Standard Page assets as well as give you some insight into when you could utilize the PHP API in the real world.

Dynamic Asset Listings

By Liam Coltman posted on 14 Aug 2010

Learn how to make you asset listings dynamic so they can be reused across multiple pages on your site

Trigger happy images

By Liam Coltman posted on 23 Aug 2010

Triggers are a very powerful feature in MySource Matrix. Learn how to set up a trigger to create image varieties