Title: widget_meta_poweredby
Published: April 25, 2014
Last modified: May 20, 2026

---

# apply_filters( ‘widget_meta_poweredby’, string $html, array $instance )

## In this article

 * [Parameters](https://developer.wordpress.org/reference/hooks/widget_meta_poweredby/?output_format=md#parameters)
 * [More Information](https://developer.wordpress.org/reference/hooks/widget_meta_poweredby/?output_format=md#more-information)
 * [Source](https://developer.wordpress.org/reference/hooks/widget_meta_poweredby/?output_format=md#source)
 * [Related](https://developer.wordpress.org/reference/hooks/widget_meta_poweredby/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/hooks/widget_meta_poweredby/?output_format=md#changelog)
 * [User Contributed Notes](https://developer.wordpress.org/reference/hooks/widget_meta_poweredby/?output_format=md#user-contributed-notes)

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

Filters the “WordPress.org” list item HTML in the Meta widget.

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

 `$html`string

Default HTML for the WordPress.org list item.

`$instance`array

Array of settings for the current widget.

## 󠀁[More Information](https://developer.wordpress.org/reference/hooks/widget_meta_poweredby/?output_format=md#more-information)󠁿

 * The “`widget_meta_poweredby`” filter is part of the build in Meta widget. This
   filter allows you to alter the powered by link at the bottom of the widget. By
   default, this links to WordPress.org.
 * Note that the filter function **must** return an value after it is finished processing
   or the result will be empty.

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

    ```php
    echo apply_filters(
    	'widget_meta_poweredby',
    	sprintf(
    		'<li><a href="%1$s">%2$s</a></li>',
    		esc_url( __( 'https://wordpress.org/' ) ),
    		__( 'WordPress.org' )
    	),
    	$instance
    );
    ```

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

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

| Used by | Description | 
| [WP_Widget_Meta::widget()](https://developer.wordpress.org/reference/classes/wp_widget_meta/widget/)`wp-includes/widgets/class-wp-widget-meta.php` |

Outputs the content for the current Meta widget instance.

  |

## 󠀁[Changelog](https://developer.wordpress.org/reference/hooks/widget_meta_poweredby/?output_format=md#changelog)󠁿

| Version | Description | 
| [4.9.0](https://developer.wordpress.org/reference/since/4.9.0/) | Added the `$instance` parameter. | 
| [3.6.0](https://developer.wordpress.org/reference/since/3.6.0/) | Introduced. |

## 󠀁[User Contributed Notes](https://developer.wordpress.org/reference/hooks/widget_meta_poweredby/?output_format=md#user-contributed-notes)󠁿

 1.  [Skip to note 2 content](https://developer.wordpress.org/reference/hooks/widget_meta_poweredby/?output_format=md#comment-content-4835)
 2.   [Steven Lin](https://profiles.wordpress.org/stevenlinx/)  [  5 years ago  ](https://developer.wordpress.org/reference/hooks/widget_meta_poweredby/#comment-4835)
 3. [You must log in to vote on the helpfulness of this note](https://login.wordpress.org?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fhooks%2Fwidget_meta_poweredby%2F%23comment-4835)
    Vote results for this note: 0[You must log in to vote on the helpfulness of this note](https://login.wordpress.org?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fhooks%2Fwidget_meta_poweredby%2F%23comment-4835)
 4. Example Migrated from Codex:
 5. Replacing with a custom powered by link.
 6.     ```php
        add_filter( 'widget_meta_poweredby', 'custom_meta_poweredby' );
    
        function custom_meta_poweredby( $html, $instance ) {
            // Replace with custom powered by link
            return ' More Awesome by <a href="http://ma.tt&quot; title="More Awesome by Matt Mullenweg">Matt Mullenweg</a>';
        }
        ```
    
 7.  [Log in to add feedback](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fhooks%2Fwidget_meta_poweredby%2F%3Freplytocom%3D4835%23feedback-editor-4835)

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