Back to Community
Home / Community / Core → Installing wordpress

How to Add Code to Your WordPress Header and Body Without a Plugin

8 threads Sep 16, 2025 Core → Installing wordpress

Content

Many WordPress users need to insert custom code snippets into their website's <head> or <body> sections. This is a common requirement for adding tracking scripts, like Google Analytics or Google Tag Manager, or for including custom CSS and JavaScript. While plugins exist for this, some users prefer a more direct, code-based approach to avoid adding another plugin to their site.

This guide will walk you through the correct, safe method for adding code to these sections using your theme's functions.php file.

Why You Should Use a Child Theme

Before you edit any theme files, it is highly recommended to use a child theme. A child theme allows you to make modifications without affecting the parent theme. This means your custom code will not be erased when the main theme receives an update. If you haven't set up a child theme yet, you should do that first.

The Correct Way: Using WordPress Action Hooks

WordPress provides specific action hooks that allow you to inject code at precise locations in your site's HTML output. Directly editing theme template files (like header.php) is not recommended, as it's error-prone and your changes will be lost on updates.

The three primary hooks you need are:

  • wp_head: Used to insert code just before the closing </head> tag.
  • wp_body_open: Used to insert code immediately after the opening <body> tag.
  • wp_footer: Used to insert code just before the closing </body> tag.

Step-by-Step Code Implementation

Add the following code to your child theme's functions.php file. Replace the example scripts with your own code.

// Add code to the <head> section
add_action('wp_head', function() {
    ?>
    <!-- This is an example script in the head -->
    <script type="text/javascript">
        console.log('Script in head section');
    </script>
    <?php
});

// Add code right after the <body> tag opens
add_action( 'wp_body_open', function() {
    ?>
    <!-- Google Tag Manager (noscript) example -->
    <noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-XXXXXX"
    height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
    <?php
});

// Add code to the footer (before the closing </body> tag)
add_action('wp_footer', function() {
    ?>
    <!-- This is an example script in the footer -->
    <script type="text/javascript">
        console.log('Script in body/footer section');
    </script>
    <?php
});

Troubleshooting Common Issues

  • White Screen of Death (Fatal Error): This usually occurs if there is a syntax error in your code, like a missing semicolon or bracket. Copy your code into a PHP validator to check for errors before adding it to your site.
  • Code Doesn't Appear: Ensure your theme supports the wp_body_open() function. This function must be present in your theme's header.php file right after the opening <body> tag. Many modern themes include it, but if yours does not, you may need to add it manually to the parent theme's header.php file, which negates the purpose of a child theme. In that case, using the wp_footer hook is a more reliable alternative for body scripts.
  • Use Unique Handles: If you are enqueuing styles or scripts, make sure to give them a unique name to avoid conflicts with other themes or plugins.

By following this method, you can cleanly and safely add any necessary code to your WordPress site's critical sections while keeping your theme update-proof.

Related Support Threads Support