do_action( 'comment_post', int $comment_ID, int|string $comment_approved, array $commentdata )

Fires immediately after a comment is inserted into the database.

Parameters Parameters


(int) The comment ID.


(int|string) 1 if the comment is approved, 0 if not, 'spam' if spam.


(array) Comment data.

Top ↑

Source Source

File: wp-includes/comment.php

View on Trac

Top ↑

Changelog Changelog

Version Description
4.5.0 The $commentdata parameter was added.
1.2.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    Contributed by Stephen Cronin

    The following example uses the comment_post hook to run a function immediately after a comment is posted. The function checks whether the comment is approved and, if so, executes the code specified.

    function show_message_function( $comment_ID, $comment_approved ) {
    	if( 1 === $comment_approved ){
    		//function logic goes here
    add_action( 'comment_post', 'show_message_function', 10, 2 );

    Note that the add_action line includes the priority and the number of parameters (, 10, 2). If we leave the number of parameters out, we will only be able to access to the first parameter ($comment_ID) in our function. We will not be able to access the second parameter ($comment_approved).

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