Create Your First WordPress Child Theme from Scratch (with Code Samples)

Many beginners use theWordPressWhen building a website, you want to personalize it without breaking the original theme. At this point.Child Theme It's just the safest and most flexible solution. Here's a step-by-step guide on how to create your first child theme.

First, what is a WordPress child theme

A child theme is a theme that is dependent on the main theme (Parent Theme), it inherits the mainthematicfeatures and styles, but are free to modify some of the files without affecting the main theme. When the main theme is updated, the customized content in the child theme will not be overwritten, which is ideal for websites with long-term maintenance.

Simple to understand:
Main Theme = Basic Functionality
Subthemes = Custom extensions

II. Preparation before creating sub-topics

Before you begin, please have the following ready:

1. Access to WordPress backend and FTP or hosting file management.
2. The name of the main theme folder (e.g. blocksy,astra,twentytwentyfour).
3. A text editor (e.g. VS Code, Notepad++).

III. Creating sub-theme folders

Access to the Web Catalog wp-content/themes/, create a new folder here with the usual naming format:

Subject name-child

For example, your main theme is woodmartThat.subthemeThe folder is then named:

woodmart-child

This allows the system to automatically recognize paternity and is also easy to manage.

Fourth, the preparation of style.css file

exist woodmart-Child. folder, create a new folder named style.css file, and then write the following code:

/*
Theme Name: Woodmart Child
Template: woodmart
Author: Your Name
Version: 1.0
Description: This is a child theme of Woodmart Theme.
*/Woodmart

Description:

• Theme Name: The subtopic displays the name.
• Template: The name of the catalog for the main theme, which must be filled in correctly.
• Other information can be customized.

After saving.WordPressIt is only then that sub-themes can be recognized.

V. Loading the main theme style

Once the child theme is created, you also need to make it inherit the CSS styles from the main theme.
In the child theme directory create a new functions.php file and add the following code:

<?php
function astra_child_enqueue_styles() {
    wp_enqueue_style('parent-style', get_template_directory_uri() . '/style.css');
}
add_action('wp_enqueue_scripts', 'astra_child_enqueue_styles');
?>

Role:
This code lets the child theme automatically load the main theme's style files to ensure a consistent page appearance.

VI. Enabling sub in the backgroundthematic

Go back to the WordPress backend → Appearance → Themes to see the child theme you just created "Woodmart Child".

Click "Enable", then the child theme is officially effective. The appearance of the site will not change, but you can freely modify the template files or styles in the child theme, without affecting the main theme.

VII. Customizing child theme content

Once enabled, you can start customizing the operation:

1. ModificationsCSStype

directly in the style.css Write new styles in with a higher priority than the main theme. Example:

h1 {
    font-size: 28px; color: #0073aa; h1 {
    color: #0073aa.
}

2. Modification of template documents

Want to modify the page structure, copy the files from the main theme to the child theme folder. Example:
make a copy of header.php Just go to the child theme directory and modify the code in it.

3. Adding functional functions

In the subtopic's functions.php Add customizations such as adding a new navigation menu or modifying the login page logo.

VIII. Testing and maintenance

fulfillmentsubthemeAfterward, be sure to test it:

• Open the website page and confirm that the style and functionality are correct;
• Check the console for reported errors;
• Regularly update the main theme to ensure compatibility.

Recommendation:
Backup the child theme files before each modification to avoid misuse.

Nine, advanced skills: adding customized templates

If you want to use a special layout for a certain page, you can create a new custom template file in the child theme.
For example, creating page-custom.php, write:

<?php
/*
Template Name: Custom Page Layout
*/
get_header(); ?>

<h2>This is the custom template page</h2>

<?php get_footer(); ?>

This template can then be selected when creating new pages in the backend to quickly implement different page layouts.

X. Summary of advantages of sub-themes

1. High security: The main theme update will not affect customized content.
2. Easy maintenance: Code clarity and hierarchical management.
3. Flexible Expansion: Function functions can be added or modified.
4. structurally independent: Easier to troubleshoot problems.

A child theme is not only the first step for beginners to get started, but also a core tool for professional developers to create a personalized website. In just a few simple steps, you can make yourWordPressMore controllable and maintainable.

Contact Us
Can't read the tutorial? Contact us for a free answer! Free help for personal, small business sites!	Customer Service
① Tel: 020-2206-9892
② QQ咨询：1025174874
(iii) E-mail: [email protected]
④ Working hours: Monday to Friday, 9:30-18:30, holidays off