Skip to main content
The Divi Portfolio Module

How to add, configure and customize the Divi portfolio module.

Updated over a week ago

The Divi Portfolio Module is an easy way to display your portfolio. It integrates with the native WordPress Projects functionality and displays your projects in an eye-catching design. Use this module on a Portfolio or Project page to showcase your work.

How to Add the Divi Portfolio Module to Your Page

  1. Add a new page or edit an existing page.
    By default, the Standard Gutenberg Editor loads whenever a new post or page is added to WordPress.

  2. Click the purple button underneath the page title. Use The Divi Builder.

Add a page and load the visual builder

Once clicked, the page will be reloaded with the Divi Visual Builder.

As your page reloads, you'll notice three options:

  • Build From Scratch

  • Choose A Premade Layout

  • Build with AI

Build From Scratch

This option loads the Divi Builder with a blank page design. Choose this option if you'd like to start your page design from Scratch.

Choose a Premade Layout

This option lets you choose from our large library of pre-designed Divi layouts. You can choose from premade layouts by Divi, which you've designed and saved to your Divi Library, and existing pages on your website that you can clone.

Build with AI

This option allows you to create an entire page layout using Divi AI. Using your text prompt and information about your website, you can create the perfect page outline, then build it and fill it with content and imagery, bringing it all to life in no time.

Divi Page Flow options

Add the Divi Portfolio Module

  1. Click the green + icon to insert a Row.

  2. Click the gray + icon inside the Row to open the Divi Module Library, which contains all the modules included with the Divi theme.

  3. Find the Portfolio Module module and click on it to load the module.
    The module library is also searchable. Type the module name you want in the search bar at the top.

Add the Divi Portfolio Module

All Divi Portfolio Module Options Explained

Once you’ve added the Divi Portfolio Module, the module settings automatically pop up. This is where this module's content and design styles are configured. These settings are organized into three groups via the tabs at the top of the module: Content, Design, and Advanced.

All Divi Portfolio Module Options Explained

Content Tab

Inside this tab, you’ll find the content options available for the Divi Portfolio Module.

Divi Portfolio Module Content Tab settings

Content

  • Post Count - Define the number of projects you want displayed in the portfolio by typing a numerical value.

  • Included Categories - Choose which project categories you want to include in the portfolio. By default, all categories are displayed. You can choose one category, multiple categories, or all categories.

Divi Portfolio Module Content settings

Elements

This tab shows the project titles, categories, and pagination.

  • Show Title - Toggle this option yes or no to show or hide the project titles that are automatically displayed underneath each project image.

  • Show Categories - Toggle this option yes or no to show or hide the project categories that are automatically displayed underneath the project titles.

  • Show Pagination - Toggle this option yes or no to show or hide pagination displayed at the bottom of the portfolio module, allowing users to page through the portfolio.

Divi Portfolio Module Elements settings

Link

If you would like to apply a clickable link to the entire module, you can do so here.

  • Module Link URL - Paste the URL of the link you would like to apply to this module here. This makes the entire module clickable, and when clicked, it will direct visitors to the URL pasted here.

  • Module Link Target - Defining a link target determines whether the link, when clicked, opens in a new tab or in the same window.

    • In The Same Window - if you want the link to open in the same window

    • In The New Tab - if you want that link to open in a new tab.

Divi Portfolio Module Link settings

Background

In the Background option group, the following options can be set:

  • Background Color

  • Background Gradient

  • Background Image

  • Background Video

  • Background Pattern

  • Background Mask

How to Add a Background Color

  1. Click the first tab, the Paint Bucket icon.

  2. Click Add Background Color and choose from your site's color palette, or use the eyedropper icon to find a new color.

Divi Portfolio Module Background Color settings

How to Add a Background Gradient

  1. Click the second tab, the Gradient icon,

  2. Click Add Background Gradient.
    To change the gradient colors, click on the gradient stops and select a color from your site's color palette or use the eyedropper icon to choose a new color. Gradient stops allow you to add more colors to the gradient. Click anywhere on the range slider to add a new stop.

Background Gradient options

  • Gradient Type - You can change the gradient type by clicking the dropdown menu and selecting the desired one.

  • Gradient Direction - You can change the direction of the gradient by dragging the range slider or typing in a numerical value.

  • Repeat Gradient - Toggle this option to yes if you want the gradient to repeat.

  • Gradient Unit - The gradient unit changes how the gradient stop points are calculated. Select the dropdown to change the unit.

  • Place Gradient Above Background Image - If a background image is applied, you can place the gradient above the background image by toggling this option to yes.

Divi Portfolio Module Background Gradient settings

How to Add a Background Image

  1. Click the third tab, the Image icon.

  2. Click the gray + icon to bring up the Media Library, where you can select an already uploaded photo from your library or upload a new one.

Background Image options

  • Use Parallax Effect - To apply a parallax effect to the image (where the image scrolls faster than the foreground content, giving the illusion of a 3D effect), then toggle this option to on. By default, this setting is set to off.

  • Background Image Size - Choose the size of your background image by selecting a size from the dropdown menu.

  • Background Image Position - Choose the position of the background image by selecting a position from the dropdown menu.

  • Background Image Repeat - Choose if and how the background image repeats by selecting an option from the dropdown menu.

  • Background Image Blend - Choose how the background blends with other layers in the module by selecting an option from the dropdown menu.

Divi Portfolio Module Background Image settings

How To Add a Background Video

  1. Click the fourth tab, the Video icon.

  2. Click the gray + icon to bring up the media library, where you can select an already uploaded photo from your library or upload a new one.

Background Video options

  • Mp4 vs WebM. - We recommend uploading both a mp4 version and a webm version of the video because not all browsers support WebM video formats. Uploading both file types ensures your video will play on all devices and browsers.

  • Background Video Width - Set the video's width by typing in a numerical value.

  • Background Video Height - Se the height of the video by typing in a numerical value.

  • Pause Video When Another Video Plays - If you'd like the background video to pause when another video is playing, toggle that option to yes. By default, the video will pause when not in view. If you want the video to continue, toggle this option to no.

Divi Portfolio Module Background Video settings

How to Add a Background Pattern

  1. Click the 5th tab, the Pattern icon

  2. Click Add Background Pattern

  3. Choose the pattern type you want from the dropdown

Background Pattern options

  • Pattern Color - Select the pattern color from your site's color palette or use the eyedropper icon to find a new color.

  • Pattern Transform - Transform the pattern horizontally or vertically, rotate it, or invert it.

  • Pattern Size - Pattern size is where you can select the pattern size: the actual size, cover, fit, stretch to fill or custom size. If you select custom size, the following options will appear: pattern width and pattern height. Drag the range slider or type in a numerical value to define those options.

  • Pattern Repeat Origin - Select the origin from which the pattern repeats.

  • Pattern Horizontal and Vertical Offset - Adjust the horizontal and vertical offsets for the pattern.

  • Pattern Repeat - Choose how the pattern repeats – horizontally, vertically, and more.

  • Pattern Blend Mode - Defines how the pattern layer interacts with the layers beneath it. Select from one of the 16 blend modes available from the dropdown.

Divi Portfolio Module Background Pattern settings

How to Add a Background Mask

  1. Click the 6th tab, the Mask icon

  2. Click Add Background Mask

  3. Select the mask type you want via the dropdown menu

Background Mask options

  • Mask Color - Choose the mask color from your site's color palette, or use the eyedropper icon to find a new color.

  • Mask Transform - Transform the mask horizontally or vertically, rotate it, or invert it.

  • Mask Aspect Ration - Set the aspect ratio of the mask. The aspect ratio of an image is the ratio of its width to its height.

  • Mask Size - Select the mask size: the actual size, cover, fit, stretch to fill or custom size. If you select custom size, the following options will appear: mask width and height. Drag the range slider or type in a numerical value to define those options.

  • Mask Blend Mode - Defines how the mask layer interacts with the layers beneath it. Select from one of the 16 blend modes available from the dropdown.

Divi Portfolio Module Background Mask settings

Admin Label

The Admin Label is where you can give the module a name only visible to you to assist in keeping things organized and easy to understand on the back end. By default, the admin label will be the name of the module. You can change the text of the admin label to reflect what you'd like.

Divi Portfolio Module Admin Label settings

Design Tab

Inside this tab, you’ll find all the design styles and settings for the Divi Portfolio Module.

Divi Portfolio Module Design Tab settings

Layout

You can choose the layout you'd like your portfolio module to display - as a grid or full width.

  • Fullwidth - Select this option if you'd like the portfolio to display fullwidth with the projects displayed one after the other.

  • Grid - Select this option if you want your portfolio to display as a grid. By default, this displays as a 4-column grid.

Divi Portfolio Module Layout settings

Overlay

When a cursor hovers over an image, an overlay and overlay icon appear. In this tab, you can specify which color you'd like for the overlay and icon.

  • Zoom Icon Color - The zoom icon color refers to the icon displayed on top of the photo when a cursor hovers over the project's image. You can select a color from the site palette or click the eyedropper icon to search for a new color. To make the icon transparent, click the transparent circle on the right with the red slash through it. Doing so means the icon will not be visible, and only the overlay color will show.

  • Hover Overlay Color - You can select the color for the photo overlay when a cursor hovers over the project's image. You can select a color from the site palette or click the eyedropper icon to search for a new color. If you want no overlay color to display, click the transparent circle on the right with the red slash.

  • Hover Icon Picker - Select the icon you would like to use as the hover icon here.

Divi Portfolio Module Overlay settings

Image

This is where you can style the portfolio images.

  • Image Rounded Corners - Type in a numerical value. The higher the number, the rounder the corners will be. The corner values are automatically linked (as seen by the highlighted blue chainlink in the middle); however, if you'd like to have different values for each corner, click the blue chainlink to unlink the values. If the values are automatically linked, they will always have the same value and update automatically if one value is changed.

  • Image Border Styles - Add a border to your portfolio images. You can add a border to all sides of the image or individual sides (top, right, bottom, and left).

  • Image Border Width - Set the width of the border. For a thicker border, increase the number. The border width must be at least 1px to show.

  • Image Border Color - Choose the border's color. You can select a color from your default site color palette that is already displayed or click on the eyedropper icon to find a new color.

  • Image Border Style - Select what border style you'd like: solid, dashed, dotted, double, groove, ridge, inset, outset, or none.

  • Image Box Shadow - Control the horizontal position of the drop shadow, the vertical position, the strength of the shadow blur, and the spread of the shadow. You can also pick the shadow color by choosing from your site's palette or using the eyedropper icon to search for a new color. You can also select the box-shadow position: outer shadow or inner shadow.

  • Image Hue - Adjust the image's hue by dragging the range slider and inputting a numerical value in the textbox.

  • Image Saturation - Adjust the image saturation by dragging the range slider to input a numerical value in the textbox.

  • Image Brightness - Adjust the brightness by dragging the range slider and inputting a numerical value in the textbox.

  • Image Contrast - Adjust the contrast by dragging the range slider of inputting a numerical value in the textbox.

  • Image Invert - Invert the colors of the image by dragging the range slider and inputting a numerical value in the textbox.

  • Image Opacity - Adjust the image's opacity by dragging the range slider of inputting a numerical value in the textbox.

  • Image Blur - Adjust the image blur by dragging the range slider and inputting a numerical value in the textbox.

  • Image Blend Mode - Select the image blend mode via the dropdown: normal, multiply, screen, overlay, darken, lighten, color doge, color burn, hard light, soft light, difference, expulsion, hue, saturation, color, or luminosity.

Divi Portfolio Module Image settings

Text

This sets the overall text styles for this module.

  • Text Alignment - Choose the text's alignment: left, center, right, or justify.

  • Text Color - Select this module's default text color palette: light or dark. The default light color palette and dark color palettes can be configured in the Divi Theme Options.

  • Text Shadow - Add a shadow to the text in the module here. There are options to adjust the shadow’s horizontal length, vertical length, shadow blur strength, and shadow color.

Divi Portfolio Module Text settings

Title Text

These are the specific styling and configuration settings for the project title text only.

  • Title Heading Level - Choose the heading level assigned to this text: h1, h2, h3, h4, h5, or h6.

  • Title Font - Choose the font you want to use for the title text. The default font is automatically selected; however, you can choose a different font or upload a custom font by clicking the dropdown box.

  • Title Font Weight - Select the boldness of the title text font.

  • Title Font Style - Defines the style of the title text font:

    • Italicized

    • Capitalized

    • Small Capitals

    • Underlined

    • Strike-through

  • Title Text Alignment - Choose the text alignment specifically to the title text only:

    • Left

    • Center

    • Right

    • Justify

  • Title Text Color - Choose a specific color for the title text. Select from your site’s color palette or click the eyedropper icon to find a new color.

  • Title Text Size - Choose the font size of the title text by dragging the range slider or typing in a numerical value.

  • Title Letter Spacing - Choose the letter spacing of the title text by dragging the range slider or by typing in a numerical value. Letter spacing is the space between each letter. The higher the number, the more space.

  • Title Line Height - Choose the line height of the title text by dragging the range slider or by typing in a numerical value. The line height is the amount of space between each line of text. The higher the number, the more space.

  • Title Text Shadow - Add a drop shadow to the title text. Once a style is selected, you can configure the direction of the shadow (horizontal and vertical), the strength of the drop shadow blur, and the shadow color.

Divi Portfolio Module Title Text settings

Meta Text

These are the specific styling settings and the metatext configuration only. The meta text is the text underneath the project title that displays the project category.

  • Meta Font - Choose the font you want to use for the meta text. The default font is automatically selected; however, you can choose a different font or upload a custom font by clicking the dropdown box.

  • Meta Font Weight - Select the boldness of the meta text font.

  • Meta Font Style - Choose the style of the meta text font:

    • Italicized

    • Capitalized

    • Small Capitals

    • Underlined

    • Strike-through

  • Meta Text Alignment - Choose the text alignment specifically to the meta text only:

    • Left

    • Center

    • Right

    • Justify

  • Meta Text Color - Choose a specific color for the meta text. Select from your site’s color palette or click the eyedropper icon to find a new color.

  • Meta Text Size - Choose the font size of the meta text by dragging the range slider or typing in a numerical value.

  • Meta Letter Spacing - Choose the letter spacing of the meta text by dragging the range slider or by typing in a numerical value. Letter spacing is the space between each letter. The higher the number, the more space.

  • Meta Line Height - Choose the line height of the meta text by dragging the range slider or by typing in a numerical value. The line height is the amount of space between each line of text. The higher the number, the more space.

  • Meta Text Shadow - Add a drop shadow to the meta text. Once a style is selected, you can configure the direction of the shadow (horizontal and vertical), the strength of the drop shadow blur, and the shadow color.

Divi Portfolio Module Meta settings

Pagination Text

These are the settings for specific styling and configuration for the pagination text only. The pagination text is displayed at the bottom of the portfolio module, allowing users to go through the portfolio.

  • Pagination Font - Choose the font you want for the pagination text. The default font is automatically selected; however, you can choose a different font or upload a custom font by clicking the dropdown box.

  • Pagination Font Weight - Select the boldness of the pagination text font.

  • Pagination Font Style - Defines the style of the pagination text font:

    • Italicized

    • Capitalized

    • Small Capitals

    • Underlined

    • Strike-through

  • Pagination Text Alignment - Defines the text alignment specifically to the pagination text only:

    • Left

    • Center

    • Right

    • Justify

  • Pagination Text Color - Choose a specific color for the pagination text. Select from your site’s color palette or click the eyedropper icon to find a new color.

  • Pagination Text Size - Choose the font size of the pagination text by dragging the range slider or typing in a numerical value.

  • Pagination Letter Spacing - Choose the letter spacing of the pagination text by dragging the range slider or by typing in a numerical value. Letter spacing is the space between each letter. The higher the number, the more space.

  • Pagination Line Height - Choose the line height of the pagination text by dragging the range slider or by typing in a numerical value. The line height is the amount of space between each line of text. The higher the number, the more space.

  • Pagination Text Shadow - Add a drop shadow to the pagination text. Once a style is selected, you can configure the direction of the shadow (horizontal and vertical), the strength of the drop shadow blur, and the shadow color.

Divi Portfolio Module Pagination settings

Sizing

  • Width - Defines the width of the module. For more information, please check out the official documentation.

  • Max Width - Defines the maximum width of the module. For more information, please check out the official documentation.

  • Module Alignment - If a Width or a Max Width value is set, the module alignment can be set using the three options:

    • Left Aligned

    • Center Aligned

    • Right Aligned

  • Min Height - Defines the minimum value for the module's height. For more information, please check out the official documentation.

  • Height - Define the height of the module. For more information, please check out the official documentation.

  • Max Height - Defines the maximum height value the module can have. For more information, please check out the official documentation.

Divi Portfolio Module Sizing settings

Spacing

You can add margins or spacing to this module by typing numerical values.

Margin adds space outside the module, and padding adds space inside the module. To lock in ratios and keep the values the same, click the chainlink icon between the values you want to always be identical (ex, top and bottom).

  • Default margin values for the module are 0.

  • Default padding values for the module are 0.

Divi Portfolio Module Spacing settings

Border

Add a border to the module. You can add a complete border or a border to only one side of the module. Adjust the width via the range slider and select a color. Choose a border style by clicking the dropdown.

  • Rounded Corners – Type in a numerical value for round border corners. The higher the number, the rounder the corners will be. The corner values are automatically linked (as seen by the highlighted blue chainlink in the middle); however, if you’d like to have different values for each corner, simply click the blue chainlink to unlink the values. If the values are automatically linked, they will always have the same value and update automatically if one value is changed.

  • Border Styles – Add a border to all sides of the module or individual sides (top, right, bottom, and left).

  • Border Width - Set the width of the border. For a thicker border, increase the number. The border width must be at least 1px to show.

  • Border Color – Choose the color of the border. You can select a color from your default site color palette that is already displayed or click on the eyedropper icon to find a new color.

  • Border Style – Select what border style you’d like: solid, dashed, dotted, double, groove, ridge, inset, outset, or none.

Divi Portfolio Module Border settings

Box Shadow

Add a drop shadow to the entire module. Once a shadow style is clicked, you can customize the following options:

  • Box Shadow Horizontal Position - Defines the horizontal position of the drop shadow.

  • Box Shadow Vertical Position - Defines the vertical position of the drop shadow.

  • Box Shadow Blur Strength - Defines the strength of the shadow's blur. The higher the value, the bigger the blur and the wider and lighter the shadow becomes.

  • Box Shadow Spread Strength - Defines the spread strength of the blur. Increasing the spread strength will increase the density of the box shadow. Higher density results in a more intense shadow.

  • Shadow Color - Defines the shadow's color.

  • Box Shadow Position - Defines the shadow's position. It can be inside the module or outside the module.

Divi Portfolio Module Box Shadow settings

Filters

Adjust the module's filters:

  • Hue - Defines the hue angle of a color.

  • Saturation- Defines how intense the color saturation should be.

  • Brightness - Defines how bright the colors should be.

  • Contrast - Defines how distinct bright and dark areas should be.

  • Invert - Invert the hue, saturation, and brightness by the specified value.

  • Sepia - Defines a warmer, more yellow/brown appearance.

  • Opacity - Defines how transparent or opaque the background (color, gradient, image, etc.) should be.

  • Blur - Defines the amount of Gaussian Blur applied to the module.

The Blend Mode refers to how the module blends with the layers beneath it. By default, normal will be selected.

Divi Portfolio Module Filters settings

Transform

  • Scale

  • Translate

  • Rotate

  • Skew

  • Origin points

Tab through to access each option. Configure each option by inputting numerical values or dragging and expanding the box or circle.

You can lock in these values to always be identical by clicking the chain link icon at the bottom right.

Divi Portfolio Module Transform settings

Animation

Set the module's animation. Once you choose a style, you can adjust the following options:

  • Animation Duration - Defines the length of time that an animation takes to complete one cycle.

  • Animation Delay - Define the amount of time to wait from applying the animation to an element before beginning to perform the animation. The animation can start later, immediately from its beginning, or immediately and partway through the animation.

  • Animation Starting Opacity - Define the starting opacity value.

  • Animation Speed Curve - Define the easing method of your animation. Easing your animation in and out will create a smoother effect than a linear speed curve.

  • Animation Repeat - By default, animations will only play once. If you want to loop your animation continuously, choose the Loop option here.

Divi Portfolio Module Animation settings

Advanced Tab

Within the Advanced tab, you will find options that more experienced web designers might find useful, such as custom CSS.

Here, you can apply custom CSS to your module. You can also apply custom CSS classes and IDs to the module, which can be used to customize the module's styles with more advanced CSS properties or to apply custom CSS code using the module's CSS class.

Divi Portfolio Module Advanced Tab settings

CSS ID & Classes

Assign a specific CSS ID or Class to this module. This is helpful when applying custom CSS to a module by using your child theme's stylesheet.

Divi Portfolio Module CSS ID and Classes settings

Custom CSS

  • Free-Form CSS - Write free-form CSS using the keyword selector to target this module. Example: selector h1 {color: red;}

  • Module Elements - You can also apply custom CSS to this module by pasting it in this tab. When you click on the Module Elements tab, you'll see individual sections where you can add custom CSS properties.

Divi Portfolio Module Custom CSS settings

Conditions

The Display Conditions allow you to choose when to display this module based on a set of conditions, like when a user is visiting the page if they've already purchased from your company before, what browser they are using, what operating system they're using, and more.

You can add one condition or multiple conditions.

Divi Portfolio Module Display Conditions settings

Visibility

  • Disable on - Defines the visibility of the module. You can disable it (hide it from view) when the display window is a Phone, Tablet, or Desktop by clicking the corresponding checkbox.

  • Horizontal Overflow - Defines what shows when content overflows a block-level element's left and right edges. This may be:

    • Visible - The content will show if the module's content overflows its height.

    • Scroll - If the module's content overflows its height, a vertical scroll bar will be used to scroll through its content.

    • Hidden - If the module's content overflows its height, the part of the content that overflows will be hidden.

    • Auto - The browser will decide whether a scroll bar will be shown.

  • Vertical Overflow - Defines what shows when content overflows a block-level element's top and bottom edges. This may be:

    • Visible - The content will show if the module's content overflows its height.

    • Scroll - If the module's content overflows its height, a vertical scroll bar will be used to scroll through its content.

    • Hidden - If the module's content overflows its height, the part of the content that overflows will be hidden.

    • Auto - The browser will decide whether a scroll bar will be shown.

Divi Portfolio Module Visiblity settings

Transitions

This controls the hover animation's transition duration, delay, and speed curve.

  • Transition Duration - Defines the duration (in milliseconds) of the transition of the hover animation.

  • Transition Delay - Defines the transition delay of the hover animation (in milliseconds).

  • Transition Speed Curve - Defines the transition speed curve of the hover animation.

Divi Portfolio Module Transition settings

Position

  • Position - This defines the position of the module:

    • Relative (default value) - The module is positioned according to the normal flow of the document, and then offset values are relative to itself based on the values of Vertical Offset and Horizontal Offset. The offset does not affect the position of any other elements; thus, the space given for the module in the page layout is the same as if the position were default (static).

    • Absolute - The module is removed from the normal document flow, and no space is created for the element in the page layout. The module is positioned relative to its closest positioned ancestor (if any) or the initial containing block. The Location options determine its final position

    • Fixed - The element is removed from the normal document flow, and no space is created for the element in the page layout. The module is positioned based on the location options in relation to the browser window. This can be used to create a sticky module.

  • Vertical Offset - Defines the module's vertical position.

  • Horizontal Offset - Defines the module's horizontal position.

  • Z-index - Defines the order of the module in the page layout. Modules with a higher z-index number overlap modules with a lower z-index.

Divi Portfolio Module Position settings

Scroll Effects

This section defines the module's behavior when the user scrolls the page. You can make the module sticky to the top, bottom, or both and decide if the module should transform as the user scrolls.

Additionally, you can enable vertical motion on this module, which allows you to adjust the scrolling speed of the element without affecting the surrounding elements.

The Motion Trigger Effect feature lets you choose when the scroll effect you just applied is triggered. You can trigger the effect when the element's top, middle, or bottom is in view.

Divi Portfolio Module Scroll Effects settings

Save Your Design

Once you are finished styling and configuring the number counter module, click the green arrow at the bottom right of the module to save your design. If you close the module without saving, your work will be lost.

Next, Save the Page Design

To save the page design, you can type CMD + S on a Mac or CTRL + S on a PC. You can also use the bottom Divi toolbar to save your page design by clicking the circle purple icon with the three dots to expand the toolbar and then clicking the green Save button at the bottom right.

Exit the Visual Builder

Now that all your changes are saved, click Exit Visual Builder on the admin toolbar at the top to exit the Visual Builder.

Continue Learning

Did this answer your question?