Portfolio Grid

With this element you can add portfolio grids to your page. You can learn more about TheGem portfolio in this chapter

Check this demo pages showing different portfolio grid style presets available in TheGem:







Note: all this styles can be easily customized to meet your individual design needs. No coding needed.

You can find “Portfolio Grid” element in editing panel of WPBakery in “TheGem” group

Portfolios & Layout

Grid ID

Specify the unique ID for the grid. Grid ID is used for example for grid filtering via the Grid Filter element.



Select to show selected portfolio items or projects, related to the current portfolio page/project. If selecting “Related”, next you need to select the “Related by” taxonomy (in case you have created your own custom taxonomy for portfolio items/projects, it will automatically appear in “Related by” control.


You can show portfolio items from selected portfolio categories and/or manually select portfolio items. To manually select portfolio items, activate “Portfolio Items” checkbox and simply start typing the names of the respective portfolio items in “Select Portfolio Items” control.

Order By, Sort Order

Specify the sort order of the items in grid.


Here you can displace or pass over the first items in grid by specifying the number of such items to pass over.


Using exclude control you can exclude portfolio items from being displayed in portfolio grid. You can manually specify the items to exclude OR you can exclude the current portfolio page (where you are inserting the portfolio grid) OR you can exclude projects by taxonomy term – in this case simply start typing for example the name of the portfolio category, which items should be excluded from being shown.

Disable Link to Portfolio Page

If you don’t want that clicking on the projects /portfolio items load the respective portfolio page, you can use this setting to disable link to portfolio page



Specify layout of portfolio grid. You can choose between grid and creative grid layouts


select number of columns to display in portfolio grid: for desktop, tablet and mobile. In case of selecting 100% width your portfolio grid will be automatically stretched to the 100% width of the page and you will get an additional option “100% Width Columns” to specify the number of columns for 100% width grid for screen resolutions greater than 1920px. Please note: 100% width doesn’t appear as 100% width in Elementor edit mode as the element is always limited by section/column’s width settings. However on the front end the gallery grid will take the full 100% width.


In case “Grid” is selected as “Layout”, here you can choose the grid style: justified grid, masonry grid or metro style grid.

Image Size

You can choose to display thumbnails, generated by theme for portfolio grids, or original featured images, uploaded in portfolio items (full size)

Image Ratio

With this setting you can specify the custom image aspect ratio to display in portfolio grid. Specify a decimal value, i.e. instead of 3:4, specify 0.75. Use a dot as a decimal separator. Leave blank to show the original image ratio.

Better Thumbnails Quality

This control helps to increase the quality of the generated portfolio item thumbnails – this could be useful in case of using Portfolio Grid in fullwidth sections.



Caption Position

In TheGem portfolio grid caption can be shown below image, on image or on image hover. Here you can specify the position of caption.

Hover Effect

Select between multiple different hover effects. You can then customize the colors in the “Style” tab.

Hover Icons

With this setting you can hide all icons, which appear on image hover, in one click.

Title & Description

Options to show/hide project titles and descriptions in grid.


Options to show/hide different project meta elements in grid. Using Additional Meta control you can specify to show taxonomy or custom fields on or below the image. “Click behavior” helps to determine, what should happen once the page visitor clicks on this additional meta in grid’s portfolio item.

Project Details

Options to show/hide project details in grid.

Check this example of using custom fields in grid:


You can learn more about custom fields in this chapter .

Following settings are available:

  • Fields LayoutSelect between vertical or horizontal (inline) layout for displaying custom fields
  • TitleSpecify the title/label of the custom field
  • TypeYou can select between TheGem Custom Fields (see description in chapter “Custom Fields” ), ACF/Toolset custom field groups, taxonomies and project details (for portfolio items, see description in chapter “Portfolio”).
  • Select Field/Taxonomy: Choose the custom field or taxonomy to be displayed in the item’s caption
  • Field Type: Select between “text” and “number” field type. The “number” field type helps to auto-format the number values when displaying in grid using the current WP Locale (see description on chapter “Custom Fields”).
  • Prefix/SuffixOptionally add prefix/suffix to the “number” value
  • Icon: Optionally select an icon for the selected project detail/custom field/taxonomy.


Here you can optionally enable the “Read More” button with the respective settings.


This section is for selection of pagination type of portfolio grid.

Items per page

select, how many portfolio items should be visible in grid on one page


enable/disable pagination for portfolio grid

Pagintaion Type

select type of pagination.

  • Numbers: classic numbered pagination
  • Load More Button: additional items will be loaded by clicking on load more button
  • Infinite Scroll: additional items will be automatically loaded while scrolling down

In case “Load More Button” type is selected, you can further optionally activate the “Show all on load more” setting to load all portfolio items at once after clicking on “Load more” button.

Next page preloading

If enabled, items for the next page will be preloaded on the current page to speed up the paginating.

Reduce HTML Size

Using this option it is possible to reduce the HTML size of the web page by specifying the number of portfolio items to load on initial page load. The rest will be loaded on user scroll.

Example: Let’s say you wish to show 100 items at once on one page. The initial HTML size of the web page will cover all this 100 grid items thus resulting in the large HTML size of the document. However, by activating the “Reduce HTML size” option you can specify, that on the initial page load only 10 grid items should be included – thus significantly reducing the HTML size which increases the performance and page speed.


Grid Image Style

In this section you can control gaps between portfolio items in grid and customize items images.

In Grid Images Style section you can also enable shadow. By default, shadow is applied only on image container. By activating “Apply shadow on caption container” setting you can enable a common shadow for image container and caption container.

Caption Style

Here you can customize the style and typography of caption elements: title, description, date etc.

Project Details

In this section you can customize the appearance of project details in portfolio grid.

Caption Container Style

Settings to customize the appearance of caption container. Note: this section appears only in case if “Caption Position” is set to “Below Image” in Content tab – Caption section.

Preset: here you can select between 4 different color presets for caption container, which can be further customized with additional settings.

Filters & Sorting


TheGem comes with two types of portfolio filters: default filter and extended filter.

The default AJAX filter allows you to filter the items using the terms of the selected taxonomy (by default: filter by portfolio categories). The default filter comes in three pre-designed filter styles, which can be selected in “Filter & Sorting Style” control. Using the “Query Type” field you can activate the multiple choice filtering by selecting the “AND” option.

Check this example of using default filter in grid:


Additionally to the default filter, you can take an advantage of the extended filter, which can be selected in “Filter Type” field. Extended filter allows you to add different multiple filter attributes and doesn’t limit it only to one selection as in case of the default filter.

Check this example of using extended filter in grid:


Extended filter has three styles you can choose from: horizontal filter, sidebar filter and hidden sidebar filter.

In the “Filters” setting you will find a repeater control for adding multiple different filter attributes. Following settings are available:

Title: Specify the filter’s title

Filter By: Choose between taxonomies, project details, TheGem Custom Fields (see description on chapter “Custom Fields”) and ACF/Toolset custom field groups

Select Field/Taxonomy: Choose the project detail, custom field or taxonomy for filtering

Field Type: Select between “text” and “number” field type. The “number” field type helps you to display slider control (like price range slider) in filter:


Here you can optionally activate the AJAX search in portfolio grid. You can display the search in grid as a search icon or as a search input. You can activate the live search for displaying the search results instantly while typing the search term. And you can select the data source for searching: search by content or search by meta fields (including project details and custom fields).


This section helps you to make additional adjustments.

Loading Animation

Here you can enable lazy loading animation of portfolio items in portfolio grid and select animation effect in “Animation Effect” select box.

Ignore Highlighted Items

in TheGem you can specify some projects to be emphasized in portfolio grid – this projects will be shown in double size compared to the other projects. You can make it in page options of the respective project/portfolio page with this setting

This is a cool way of attracting visitors attention to some project highlights and to make creative grids.By activating “Ignore Highlighted Items” control this project emphasizing will be ignored and all highlighted projects will be displayed as normal projects.

AJAX Preloader Type

You can select between two types of AJAX preloader in grid.