Lists documentation

Lists - Post Types engine documentation

Lists allow you to create repeated content based on the same template and automatically display them with components like the grid list. A list is a combination of 2 parts: the single item and the archive page the show all items, every item has a dedicated page. Lists are very easy to use and can be used for all your contents of the same type, for example, you can use a list to create: portfolio, team, blog posts, travels or everything you can imagine.

Create a Post Type with the Lists

This example shows you how to create, show and manage a list.

1. Create the Post Type
  • Go to WordPress menu > Lists and click on Add new
  • On the top box select the icon and insert the name (ex. Travels) , singular name (ex. Travel) and the ID (ex. travels) with the text you want. Name and singular name must be the same name in plural and singular version. ID must not contain special characters
  • Click right on the blue button: Publish

2. Create the item template
  • On the same page (Lists > Travels) you can see the editor area where you can create your template
  • Click on + button and add the contents you want
  • The template save everything: components with its settings and contents
  • The template editor does not have a preview feature, so the best way to build your template is to create a temporary page or travel and use it to create the template. When you are done save the page as template, go back to the template editor (Lists > Travels) and load the template
  • Another way to load the template is to set composer mode to classic, copy the content, go back to template editor and paste the content with composer mode classic

3. Create the archive page
  • On the same page (ex. Lists > Travels) click on the blue button Edit archive
  • This is the main archive page but you can add all the archives you want as standard page
  • To show the items you can use the following components: Grid list - Post types, Masonry list - Post types, Slider - Post types, Coverflow - Post types
  • To view the page, save the changes and go back to Lists > Travels page and click View archive
  • A complete documentation for the archive and post type components is available below

4. Add the items
  • You can now add your items from WordPress menu > Your list > Add new (ex. WordPress menu > Travels > Add new)
  • On the right box you can see the global items contents: Image, excerpt text, extra 1, extra 2 and icon. These contents are used in all the post type components. Image and excerpt text are required.

Lists components


Translate the lists require WPML, go to translations documentation for more details.
If WPML is active, follow these steps to translate the lists:
  • Open an item of the list (WordPress menu > Your list > item)
  • Scroll the page to the bottom and you will see the box Multilingual Content setup
  • Check the Make 'Your list' translatable, click apply and wait a second
  • Save the item by clicking on the blue button on the top right: Update
  • Now the list is translatable, you can create the translated version of the item by clicking on + blue button of WPML

Category translations

  • Go to WPML > Translations options
  • Scroll to the bottom to Custom taxonomies area and select the category of the list, ex. portfolio-cat, and click on Save.
  • Go back to the categories page and you will be able to translate them.

Options and extra

Custom content for single item
All items of your list are based on the same template but you can insert custom content for every single item. To do this, open the item you want to edit and click two times on the top right lock icon .

Delete and create again the Post Type
If there is an error or problem, you can delete a list and create it again. The items will not be deleted, but the new list must use the same ID.

All lists support the categories. You can manage them from WordPress menu > Your list > Categories. To assign a category to a single item open the item and select the category on the bottom right box. You can select multiple categories. All post type components support the categories. If you get a Page Not Found error on category pagination, go to Settings > Reading and set the post numbers with number < 10.