Skip to content
RT-Theme 19 WordPress Theme

Portfolio List / Post

A portfolio is made of portfolio items. You can group the items by category and show them on an overview page, called a portfolio listing page. You manage the items under Portfolio in the WordPress admin.

The Portfolio screen in the admin, with arrows to the Portfolio menu, the Add New link and the Add New button

The Portfolio post type comes with the RT-Theme 19 Extensions plugin, so keep that plugin active.

  • To show a list of portfolio items on a page, add the portfolio shortcode or the Portfolio Posts element of WPBakery Page Builder to that page.

  • You can create as many portfolio listing pages as you like, each with its own shortcode or element.

  • The settings of the shortcode or the element decide how the items are listed.

  • Every portfolio item needs at least one category, and it can belong to more than one.

  • When you open a portfolio category, it lists all items in that category with the theme’s default portfolio settings.

  • You can add portfolio categories to your menus under Appearance › Menus.

  • A portfolio item can have several images. By default they appear in a slider; you can switch to an image gallery.

  • To add a featured image, click Set featured image in the Featured Image box.

    The Featured Image box in the editor with the Set featured image link

  • To add gallery images, click Add New Images in the Image Gallery box.

    The Image Gallery box in the editor with the Add New Images button

  • A portfolio item has its own Portfolio Options that only this post type has.

    The Portfolio Options box of a portfolio item with the Portfolio Format choice and the image format options

Add your portfolio items with the Portfolio post type:

  1. In the WordPress admin, go to Portfolio.
  2. Click Add New in the menu, or the Add New button at the top of the list.

The Portfolio menu in the admin with the Add New link and the Add New button

  • Every portfolio item needs at least one category, and it can belong to more than one.

  • You can add portfolio categories to your menus.

  • To add a featured image, click Set featured image in the Featured Image box.

  • To add gallery images, click Add New Images in the Image Gallery box.

  • The images appear as a slider or as a gallery. You choose this in the Portfolio Options of the item.

  • You can turn off the links and the lightbox for each item.

  • The Portfolio Options apply only to this post type.

    The Portfolio Format option with the Image, Video and Audio choices

You can also change the global design settings, such as the backgrounds and background colours of the body and the left and right side areas, on each single portfolio item.

The portfolio item editor has many options. The numbers below match the screenshot.

The Add New portfolio item screen with numbered markers: title (1), content (2), Portfolio Options (3), Featured Image Options (4) and the sidebar boxes (5 to 10)

  1. The title of the portfolio item.

  2. The content of the portfolio item.

  3. Portfolio Options:

    • Set the format to Image, Video or Audio.
    • Hide the featured image on the single portfolio page.
    • Show the image, video or audio in a full-width row on the single page.
    • Short Description: the description shown on portfolio listing pages.
    • Remove all links from the item on portfolio listing pages.
    • Disable the lightbox for the image on portfolio listing pages.
    • External Link: make the item link to another site from listing pages.
  4. Featured Image Options: change the height, width and cropping of the featured image.

    The Featured Image Options box with the width, height and crop settings for this item

  5. Featured Image: the image used for the item on listing pages.

  6. Image Gallery: add more images to show as a gallery.

  7. Portfolio Categories: put the item in a category.

  8. Publish: make the item visible on your site, or change its date or visibility, save it as a draft or preview it.

  9. Backend Editor: switch to WPBakery Page Builder to add its elements, or stay in the Classic Editor and add shortcodes or text the usual WordPress way.

  10. Screen Options: choose which boxes appear on the editing screen of this post type.

The Image format has these settings:

The image format options: gallery usage, gallery cropping and maximum image height

  • Show the attached images as a slideshow or an image gallery.
  • Crop the gallery images.
  • The maximum height of the images.

The Video format has these settings:

The video format options: MP4 file URL, WEBM file URL and Vimeo or YouTube URL

  • The URL of a self-hosted MP4 file.
  • The URL of a self-hosted WEBM file.
  • The URL of a Vimeo or YouTube video.

The Audio format has these settings:

The audio format options: MP3 file URL and OGG file URL

  • The URL of a self-hosted MP3 file.
  • The URL of a self-hosted OGG file.

When the content and settings are complete, publish the item. It then appears in every portfolio list whose page has the portfolio shortcode or the Portfolio Posts element in the place where you want the list.

Every portfolio item has a Design Options section that overrides the global Customizer styling, such as backgrounds and colours, for that item only. View the abilities of the Design Options

To set up a portfolio listing page:

  1. Create your portfolio items.
  2. Create a page.
  3. Add the portfolio shortcode to the page, or add the Portfolio Posts element with WPBakery Page Builder.

Go to Pages › Add New and create the page that will hold the portfolio.

The Pages screen with the Add New button for creating a new page

Adding the Portfolio Posts element (WPBakery Page Builder)

Section titled “Adding the Portfolio Posts element (WPBakery Page Builder)”
  1. In WPBakery Page Builder, click Add element (the + sign).

    The empty WPBakery Page Builder editor with arrows to the + icon and the Add element button

  2. Choose Portfolio Posts.

    The Add Element window in WPBakery Page Builder with the Portfolio Posts element marked

  3. A window opens with all the settings of the element.

    The Portfolio Posts element settings window in WPBakery Page Builder

  4. Adjust the settings. You can always edit them later if you don’t like the result.

  5. Click Save changes in the window. The page editor now shows the element:

    The Portfolio Posts element placed in the page in the WPBakery Page Builder editor

Click Shortcodes in the admin bar, or the shortcode icon in the Classic Editor toolbar. In the Theme Shortcodes window, select Portfolio Posts, adjust the example to your needs, and copy and paste the shortcode into the page where you want the portfolio to appear. The numbers below match the screenshot.

The Theme Shortcodes window: the Shortcodes buttons (1), Portfolio Posts in the list (2), the portfolio_box example (3) and the parameter explanations (4)

  1. The Shortcodes buttons.
  2. The Portfolio Posts shortcode.
  3. The example shortcode. Adjust it, then copy and paste it into the page content.
  4. The explanation of each parameter. Use it to adjust the parameters in the example from step 3.

In the page, the shortcode can look like this:

The portfolio shortcode pasted into the content of the page

If the page needs a look that differs from your Customizer settings, change its Design Options. View the abilities of the Design Options

When you are done, click Publish and view the page on your site. It might look like this:

A finished portfolio listing page on the site