is_plugin_active( string $plugin ): bool

Determines whether a plugin is active.


Description

Only plugins installed in the plugins/ folder can be active.

Plugins in the mu-plugins/ folder can’t be "activated," so this function will return false for those plugins.

For more information on this and similar theme functions, check out the Conditional Tags article in the Theme Developer Handbook.


Top ↑

Parameters

$plugin string Required
Path to the plugin file relative to the plugins directory.

Top ↑

Return

bool True, if in the active plugins list. False, not in the list.


Top ↑

Source

File: wp-admin/includes/plugin.php. View all references

function is_plugin_active( $plugin ) {
	return in_array( $plugin, (array) get_option( 'active_plugins', array() ), true ) || is_plugin_active_for_network( $plugin );
}


Top ↑

Changelog

Changelog
Version Description
2.5.0 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 1 content
    Contributed by Jonas Lundman
    <?php
    /**
     * Detect plugin. For use on Front End and Back End.
     */
     
    // check for plugin using plugin name
    if(in_array('plugin-directory/plugin-file.php', apply_filters('active_plugins', get_option('active_plugins')))){ 
    	//plugin is activated
    }
  2. Skip to note 2 content
    Contributed by Codex

    Front end

    <?php
    /**
     * Detect plugin. For frontend only.
     */
    include_once ABSPATH . 'wp-admin/includes/plugin.php';
    
    // check for plugin using plugin name
    if ( is_plugin_active( 'plugin-directory/plugin-file.php' ) ) {
    	//plugin is activated
    } 
  3. Skip to note 3 content
    Contributed by Codex

    Admin area

    <?php
    /**
     * Detect plugin. For use in Admin area only.
     */
    if ( is_plugin_active( 'plugin-directory/plugin-file.php' ) ) {
    	//plugin is activated
    } 

You must log in before being able to contribute a note or feedback.