Setting a Custom Divi Homepage with Your Child Theme

Written by Dan Mossop

When developing websites with Divi, setting up a customized homepage as a standard across multiple projects can optimize your workflow significantly. By utilizing a child theme with a pre-configured homepage, you can ensure a consistent and professional starting point for every new Divi site. Here’s a step-by-step guide on how to use the Divi Builder to create a custom homepage and set it as the default when activating your child theme.

Step 1: Create and Retrieve Your Custom Divi Homepage Layout

Craft your homepage layout in a new page using the Divi Builder. Once you're satisfied with the design, you can capture the layout's shortcode for later use by utilizing WordPress's revisions feature.

  1. While in the Divi Builder, save your layout.
  2. Click the "Edit Post" link in the admin bar at the top to open your page in the backend editor
  3. Now click on the 'Revisions' link under the 'Publish' section on the right of the editor.
  4. In the 'Revisions' screen, navigate to the latest revision.
  5. Retrieve the Divi Builder shortcode, which represents your layout from this revision.

Step 2: Set Up the Homepage Insertion in Your Child Theme

Add the following snippet to your child theme's functions.php file, ensuring you replace the $content variable's value your actual layout's shortcode: This way, when the child theme is activated, it will automatically create a new page with your custom design and set it as the homepage.

if (get_option('custom_homepage_inserted') != 'yes') {

    $content = '[et_pb_section][et_pb_row][et_pb_text]My custom page[/et_pb_text][/et_pb_row][/et_pb_section]';

    $args = array(
        'post_type'    => 'page',
        'post_content' => $content,
        'post_title'   => 'Home',
        'post_status'  => 'publish',
        'meta_input'   => array(
            '_et_pb_use_builder' => 'on' // Enable Divi Builder on page
        )
    );

    // Insert the post
    $post_id = wp_insert_post($args);

    // Check if the post was successfully inserted
    if (!is_wp_error($post_id) && $post_id != 0) {
        // Set page as homepage
        update_option('page_on_front', $post_id);
        update_option('show_on_front', 'page');

        // Set the flag to indicate the code has run
        update_option('custom_homepage_inserted', 'yes');
    }
}

Step 3: Activate Your Child Theme

Once the above snippet is in place, proceed to activate your child theme on your Divi website. The code will run a check for the homepage. If it isn’t already present, it’ll automatically create it with your custom layout and prompt you to edit it in the Visual Builder.

This streamlined approach ensures that each new Divi site can start with the same uniform, beautiful homepage, tailored by you, and ready for immediate customization.

Unlock the Full Potential of Shortcodes in Divi!

Empower your Divi site workflow with the Divi Shortcode Enabler. Seamlessly integrate your custom homepage layouts and other custom elements using shortcodes within various Divi module fields. Enhance functionality and streamline the setup process with ease.

About Dan Mossop

Dan is a Scottish-born web developer, now living in Brisbane with his wife and son. He has been sharing tips and helping users with Divi since 2014. He created Divi Booster, the first Divi plugin, and continues to develop it along with 20+ other Divi plugins. Dan has a PhD in Computer Science, a background in web security and likes a lot of stuff, 

0 Comments

Submit a Comment

Comments are manually moderated and approved at the time they are answered. A preview is shown while pending but may disappear if your are cookies cleared - don't worry though, the comment is still in the queue.

Your email address will not be published. Required fields are marked *.

We may earn a commission when you visit links on our website.

Latest From Divi Booster

Fix Divi Text Module "Regular" Font Weight Not Working

Are you encountering an issue where the font weights in Divi's Text Module don't seem to apply as expected? In particular, you might find that when you set the text module's body text font weight to "Regular", your font is actually assigned a weight of 500 instead of...

Make the Divi Gallery Module Swipeable

The Divi Gallery Module comes with a slider mode that lets you display images in a slider with clickable left/right arrows to scroll through the images. For mobile / touchscreen users, you can improve the user experience by allowing your user to swipe to navigate to...

How to Use Divi Dynamic Content in Woo Modules Product Selector

Divi's Dynamic Content is a powerful feature that lets you populate your Divi modules and theme builder templates with data pulled in various sources, such as custom fields. This allows for efficient organization and maintenance of your sites.Unfortunately, Divi's...

Removing Gaps in Divi Builder Layouts

Designing a seamless, professional-looking website is often about managing space effectively. Gaps in Divi Builder - particularly excessive white space between sections, rows, or modules - can disrupt your layout, leading to a fragmented and less engaging user...

Random Divi Posts