Title: WP_Icons_Registry::get_registered_icon
Published: May 20, 2026

---

# WP_Icons_Registry::get_registered_icon( string $icon_name ): array|null

## In this article

 * [Parameters](https://developer.wordpress.org/reference/classes/wp_icons_registry/get_registered_icon/?output_format=md#parameters)
 * [Return](https://developer.wordpress.org/reference/classes/wp_icons_registry/get_registered_icon/?output_format=md#return)
 * [Source](https://developer.wordpress.org/reference/classes/wp_icons_registry/get_registered_icon/?output_format=md#source)
 * [Related](https://developer.wordpress.org/reference/classes/wp_icons_registry/get_registered_icon/?output_format=md#related)

[ Back to top](https://developer.wordpress.org/reference/classes/wp_icons_registry/get_registered_icon/?output_format=md#wp--skip-link--target)

Retrieves an array containing the properties of a registered icon.

## 󠀁[Parameters](https://developer.wordpress.org/reference/classes/wp_icons_registry/get_registered_icon/?output_format=md#parameters)󠁿

 `$icon_name`stringrequired

Icon name including namespace.

## 󠀁[Return](https://developer.wordpress.org/reference/classes/wp_icons_registry/get_registered_icon/?output_format=md#return)󠁿

 array|null Registered icon properties or `null` if the icon is not registered.

## 󠀁[Source](https://developer.wordpress.org/reference/classes/wp_icons_registry/get_registered_icon/?output_format=md#source)󠁿

    ```php
    public function get_registered_icon( $icon_name ) {
    	if ( ! $this->is_registered( $icon_name ) ) {
    		return null;
    	}

    	$icon            = $this->registered_icons[ $icon_name ];
    	$icon['content'] = $icon['content'] ?? $this->get_content( $icon_name );

    	return $icon;
    }
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-includes/class-wp-icons-registry.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/7.0/src/wp-includes/class-wp-icons-registry.php#L252)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/7.0/src/wp-includes/class-wp-icons-registry.php#L252-L261)

## 󠀁[Related](https://developer.wordpress.org/reference/classes/wp_icons_registry/get_registered_icon/?output_format=md#related)󠁿

| Uses | Description | 
| [WP_Icons_Registry::is_registered()](https://developer.wordpress.org/reference/classes/wp_icons_registry/is_registered/)`wp-includes/class-wp-icons-registry.php` |

Checks if an icon is registered.

  | 
| [WP_Icons_Registry::get_content()](https://developer.wordpress.org/reference/classes/wp_icons_registry/get_content/)`wp-includes/class-wp-icons-registry.php` |

Retrieves the content of a registered icon.

  |

## User Contributed Notes

You must [log in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fclasses%2Fwp_icons_registry%2Fget_registered_icon%2F)
before being able to contribute a note or feedback.