← All resources
The toolkit · Resource guide

Enqueue a WordPress theme script

Load a theme’s JavaScript through WordPress’s asset system.

Visit website (opens in a new tab)
Understand the tool

Overview

Load a theme’s JavaScript through WordPress’s asset system.

The example below is an original, minimal illustration of the referenced web-platform feature. Read the official reference and adapt it before using it in a real project.

Best for

  • Understanding Enqueue hook.
  • Trying a focused implementation in a test page.
  • Adapting a small pattern to an existing codebase.

Key features

  • Enqueue hook
  • Theme asset URL
  • File versioning
A practical walkthrough

Getting started

  1. Read the example and reference. Identify the selectors, files or values that belong to your project.

  2. Try it in isolation. Use a disposable test page and adapt the example values.

  3. Verify before reuse. Check keyboard behavior, responsive layout and relevant browser support.

Things to know

  • These examples are learning material, not a drop-in application.
  • Replace example filenames, selectors and routes as needed.
  • Test changes on staging and escape data for the context where it is used.

Code example

Illustrative example: adapt it to your project and test it on staging.

<?php
// Add to a theme's functions.php. The referenced file must exist.
add_action('wp_enqueue_scripts', function () {
    $path = get_theme_file_path('/assets/site.js');
    if (!is_file($path)) return;
    wp_enqueue_script(
        'example-site',
        get_theme_file_uri('/assets/site.js'),
        [],
        (string) filemtime($path),
        true
    );
});

Useful alongside this

Accessibility

Text

Visual

Orientation

Accessibility settings