Title: wp_required_field_message
Published: November 2, 2022
Last modified: May 20, 2026

---

# wp_required_field_message(): string

## In this article

 * [Return](https://developer.wordpress.org/reference/functions/wp_required_field_message/?output_format=md#return)
 * [Source](https://developer.wordpress.org/reference/functions/wp_required_field_message/?output_format=md#source)
 * [Hooks](https://developer.wordpress.org/reference/functions/wp_required_field_message/?output_format=md#hooks)
 * [Related](https://developer.wordpress.org/reference/functions/wp_required_field_message/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/functions/wp_required_field_message/?output_format=md#changelog)

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

Creates a message to explain required form fields.

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

 string Message text and glyph wrapped in a `span` tag.

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

    ```php
    function wp_required_field_message() {
    	$message = sprintf(
    		'<span class="required-field-message">%s</span>',
    		/* translators: %s: Asterisk symbol (*). */
    		sprintf( __( 'Required fields are marked %s' ), wp_required_field_indicator() )
    	);

    	/**
    	 * Filters the message to explain required form fields.
    	 *
    	 * @since 6.1.0
    	 *
    	 * @param string $message Message text and glyph wrapped in a `span` tag.
    	 */
    	return apply_filters( 'wp_required_field_message', $message );
    }
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-includes/general-template.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/7.0/src/wp-includes/general-template.php#L5404)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/7.0/src/wp-includes/general-template.php#L5404-L5419)

## 󠀁[Hooks](https://developer.wordpress.org/reference/functions/wp_required_field_message/?output_format=md#hooks)󠁿

 [apply_filters( ‘wp_required_field_message’, string $message )](https://developer.wordpress.org/reference/hooks/wp_required_field_message/)

Filters the message to explain required form fields.

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

| Uses | Description | 
| [wp_required_field_indicator()](https://developer.wordpress.org/reference/functions/wp_required_field_indicator/)`wp-includes/general-template.php` |

Assigns a visual indicator for required form fields.

  | 
| [__()](https://developer.wordpress.org/reference/functions/__/)`wp-includes/l10n.php` |

Retrieves the translation of $text.

  | 
| [apply_filters()](https://developer.wordpress.org/reference/functions/apply_filters/)`wp-includes/plugin.php` |

Calls the callback functions that have been added to a filter hook.

  |

[Show 1 more](https://developer.wordpress.org/reference/functions/wp_required_field_message/?output_format=md#)
[Show less](https://developer.wordpress.org/reference/functions/wp_required_field_message/?output_format=md#)

| Used by | Description | 
| [wp_media_insert_url_form()](https://developer.wordpress.org/reference/functions/wp_media_insert_url_form/)`wp-admin/includes/media.php` |

Creates the form for external url.

  | 
| [get_media_item()](https://developer.wordpress.org/reference/functions/get_media_item/)`wp-admin/includes/media.php` |

Retrieves HTML form for modifying the image attachment.

  | 
| [get_compat_media_markup()](https://developer.wordpress.org/reference/functions/get_compat_media_markup/)`wp-admin/includes/media.php` |

Retrieves the media markup for an attachment.

  | 
| [comment_form()](https://developer.wordpress.org/reference/functions/comment_form/)`wp-includes/comment-template.php` |

Outputs a complete commenting form for use within a template.

  |

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

| Version | Description | 
| [6.1.0](https://developer.wordpress.org/reference/since/6.1.0/) | Introduced. |

## User Contributed Notes

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