How to use the Category Page with Intro template in our themes

Our themes (Mantra since v2.0.4, Parabola since v0.9, all other themes since first release) feature a special page template titled “Category Page with Intro” which allows us to display a category of posts coupled with a custom intro to that category.

To get started, we need to have a category with posts we wish to display an intro to. What we also need to know is the category ID or slug (when we’re using pretty permalinks).

  • We can find the category ID by hovering the Edit or View buttons in the category list; we’ll see the numeric ID in the URL the browser displays
  • We can find the slug by editing the category itself.
Category ID URL
Category slug
This is a page template, so it will show up in the page templates list when we’re creating/editing a page while using one of our themes. What we type into our page content is what WordPress will display as the intro. Selecting the page template
While editing the page we wish to use this template on, we’ll need to add custom fields. If the custom fields are not visible under the page content area, we’ll need to enable them. Enabling custom fields area
After writing in our page (intro) content and enabling the custom fields (if necessary), we’ll have to actually add a custom field for the page. The template supported custom fields are:

  • catid – use the category ID to load the posts
  • slug – use the category slug to load the posts (will only work when using pretty %postname% permalinks)
  • key – type in either the category ID or slug in this field; the template automatically detects what we’ve typed in

We use either the category ID we found out earlier – in this test case 2 – or the category slug – in this test case sample-cat. Only use *ONE* custom field at a time.

Supported custom fields

Category ID custom fieldCategory slug custom field
Once we’re done adding the page content, setting its template to “Category Page with Intro” and setting ONLY one of the custom fields and its value we can publish the page.When viewing the live page on the site, we’ll see the intro text at the beginning and then following it all the posts that are set in the particular category we’ve previously defined to be used. Page preview
More Tutorials This article is part of our WordPress general and theme specific tutorials series. For more useful information check out our tutorials section.


  1. Hello Zed, I have the Category page working in Mantra, but what I actually need is for it to list page-categories.
    I entered the page catid, but it only shows posts from that category.
    Is there a workaround?

    1. The repository theme review team considered this template as not needed and asked us to remove it since similar functionality can be obtained using WordPress’ built-in category description support (and visual editor enabling plugins).

  2. So in the meantime I realized something: most of the pages on this site use “One column, no sidebar” anyway! I switched the default layout for the whole site to One Column, and now the Category page uses that format to snap over to the full width like I needed. I only had to rework a couple of pages to accommodate the size change to another layout. Didn’t need to get into the complication of manual editing the template file, make a child theme, etc. etc….

  3. The Category page is working well for me, once I created a new WP category item specifically for display on that page ๐Ÿ˜‰ I’m wondering if there’s a way to have a full-width page layout without the right column for widgets?

    1. This page template uses the theme’s general layout as configured in the theme’s options. To make it use a different layout you’d need to customize the template file to remove the sidebar call and use the desired layout classname on the wrapper.

  4. Hi Zed, We love Tempera, and Thank You for a great write up. Once we go thru these steps, is it possible to setup the page as ‘THE’ page for the category?
    Currently I have a Tempera Category page ( but if you click on an article and then click on the ‘Library’ breadcrumb up top it goes back to the generic WP category page. Is there a way to get the breadcrumb to return back to my Tempura category page or set the Tempera page as THE page for the category?

  5. Hi. I’m using the Category page with intro and my featured images are showing at full size instead of a thumbnail. My settings are on use expert and a thumbnail image. What am I doing wrong.

    Thank you in advance.

  6. Thanks for the tutorial – this was exactly what I was looking for! But now that I have this category page set up – thanks again! – is there a way to exclude a category from the list of blog posts?

    Now that all my posts in the ‘podcast’ category are on their own page, I really want to Not have those same posts show up in the regular list of blog posts.

  7. Hi Zed

    Thank you so much for this tutorial – the step-by-step was invaluable to me (my skill level is subterranean hehe).

    I noticed someone else had asked the question too – is there a way to specify a separate order for these posts? I wondered if there was something I could pop into the custom CSS area to achieve that?

    Also, I am not sure if I have done something wrong, but in the posts grouped onto that page, the ‘share’ button icons are broken (they show the correct color and circle, but not the logo inside them). To try to work around it, I disabled the ‘show share buttons’ for that page, but that doesn’t remove them. (

    I know I’ve said this before in the Tempera forum, but I shall say it here publicly too: Your theme, support, and awesomeness are well … awesome!

    Thank you Cryout ๐Ÿ™‚

    1. The posts use the default WordPress order (descending by publish date). This should be changeable using plugins.

      I’m not sure why your social buttons display the wrong symbols. Your Jetpack seems to be failing to load its Genericons font.

      1. Zed,

        Thank you so much for pointing me to Jetpack – the sharing buttons were enabled for posts only. I enabled them for pages and it resolved the issue.

        You guys, as always, rock.

        Many thanks for not only the theme, but your support and assistance.

        ~ Wayfarer

  8. Hi, thanks for a wonderful theme. I love it.
    My category page works fine except for that only one post is shown. I would like to see excerpts of all my posts within the category, or at least of a number higher than one. Is there a way for me to change that?

  9. Works well. However few issues:
    1. How can I change the number of posts to display
    2. How can I control the order of display
    3. CONTINUE READING does not get translated.

    I know how to do the above with WP.
    I just prefer simple customization w/o coding.


    1. CORRECTION & One more issue:
      3. CONTINUE READING is translatable via option screen BUT the arrow points to the wrong direction.
      4. Prev Post, Next Post links should be swapped but retaing the arrows direction!

  10. Hello Zed, I have followed your guide to create a custom page with the Category page w/ Intro Template but I am not able to get the desired result… I created the custom field “catid” as you described, set the category id for the custom field (for my page is 6), save the page but it is always appears as a blank page (see I have tried also changing the page template but when I set again the Category Page template, the page always comes back blank… any suggestions about?
    Now I’m using WP 3.5.1 and Mantra
    Many thanks in advance!

Leave a Comment

This site uses Akismet to reduce spam. Learn how your comment data is processed.