Paint Layouts

By Liam Coltman posted on 06 Mar 2010

What is it?

The best way to think of a Paint Layout is a Design File for your page content.  These are particularly useful when you have several assets that you wish to display in an identical way, for example if you had staff profiles or interviews and wanted them to look consistent. When combined with a Metadata Schema a Paint Layout can become a very powerful tool.

How do I do it?

  1. Create a new Paint Layout
  2. Acquire the locks and select which type of assets you would like to customise then click commit
  3. If you acquire the locks again you can select another asset to customise. This is useful if you have several different types of assets setup in a tree type structure. For example you store all your profiles in different folders and want all the folders to list the profiles stored within and then want the profiles to display identically
  4. Expand out the layout then expand the Type Formats
  5. Right click on the asset type you'd like to customise and then right click and go to edit contents
  6. Set up the page content as you need and commit when you are finished. Any keywords such as Paint Layouts will be regenerated for each asset the Paint Layout is applied to.  Remember to include the keyword to print the actual information stored within the asset itself.
  7. When you are finished navigate to the area in the tree where you would like to start the cascade, right click on it and go to Lookup Settings.
  8. Acquire the locks and apply the Paint Layout to the Layout area and then commit the changes. (NOTE: you can create different user defined layouts and change the look and feel of assets just as you would with a design)
    Applying a Paint Layout screenshot

If you have problems viewing Paint Layouts across different URLs you need to check the URL Specific Definitions to see if they have been applied across all the site URLs

Conditional Keywords

If you were paying attention when editing the contents of the Type Format you would have noticed something different about Paint Layouts. They have the ability to have Conditional Keywords applied to them.

As the name suggests Conditional Keywords allow you to control what the user can see of the asset contents based on certain conditions being met.  Two of the most useful conditions are Regexp and logical, which allow you to do pattern matching and obtain a true/false. So if you stored lots of optional interview question values as metadata but only wanted them to display if they had been answered you would create a logical condition on that metadata field. Then within the contents of your Type Format you would start the condition, print the appropriate question and answer if it was true and simply leave the contents blank if it wasn't.


  1. Avatar
    07 Jun 2013 1:06pm Andy
    This is really helpful! Thanks.

    I've been looking for information on dynamic paint layouts as well but can't find anything.

    Maybe this could be an idea for a new tutorial?
    1. Avatar
      07 Jun 2013 1:06pm Liam
      Thanks for the feedback Andy, great to know you found it useful. Over the coming weeks we will be releasing some more articles so I will add this in to our list.
      1. Avatar
        03 Aug 2013 8:12pm Lucy
        I di'dnt know where to find this info then kaboom it was here.
Post a new comment Post a new comment

Build your own search

By Ladoo posted on 20 Oct 2011

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.

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.

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

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.

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

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

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.

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.


By Ladoo posted on 23 Feb 2012

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