Beginner-friendly ways to add custom code to WordPress
There are times you might want to add a code snippet to your WordPress site. It’s important you do this is a way that is both safe (not likely to break your site) and maintainable (easy to return to and fix). For example, such tweaks shouldn’t be placed into a (parent) WordPress theme or directly into a plugin, as they’ll be overwritten come update time.
The safest, most beginner-friendly, and maintainable ways to make changes or add custom code to WordPress sites are:
- Manage your custom code with the Code Snippets plugin
- Place your custom code in your child theme’s functions.php file
Add Custom Code to WordPress Sites
1. Use the Code Snippets Plugin
The Code Snippets plugin is a great way to add custom code to WordPress sites. Once installed, it allows you to add as many separate code snippets as you like.
Some nice features of the plugin include:
We find that the nicest feature of the Code Snippets plugin is that it will save you from your own mistakes. If you write and activate a snippet that breaks your site, Code Snippets will allow you to go back to the last point at which the site was still working without having to do open-heart surgery on your site.
Once you install the plugin, a new “Snippets” menu is added to your site, which lets you name and add new snippets. Each snippet will have room for the code and a description.
You can then enable and disable your code snippets just like plugins (which makes for very easy debugging). Sometimes custom snippets cause conflicts or issues with plugins or themes, so deactivating them is helpful for targeting issues.
2. Use your child theme’s functions.php file
This is a step up the difficulty and risk ladder from the previous approach.
functions.php is an important and central file in WordPress, given that it’s linked to your theme. If there’s a syntax error in the code, it could disable the theme itself and make your site inaccessible. So you’ll need to be careful, and we’ll discuss how.
Step 1: Locate functions.php for your theme
Log into your WordPress dashboard and go to “Appearance->Editor”.
This will bring you to a page where you can edit your theme files. These files are listed on the right-hand side. Your current theme is selected by default. Locate the file labeled “Theme Functions” and click it.
This will open up
functions.php in the textbox on the left-hand side.
Step 2: Verify there’s no closing ?> tag
Scroll all the way down. If you see a
?> symbol at the very end of the file, delete it.
Step 3: Format the code you intend to paste into functions.php
Most importantly, ensure that the code you’re copying is not enclosed in tags, such as
<?php. If it is, you’re going to have problems and your site will crash.
Once your code is clean, we’re ready to paste.
Step 4: Paste your code into functions.php
Paste your code at the very bottom.
Save your changes and you’ve successfully added code to
functions.php in WordPress.