LearnDash

Certificate Shortcodes

Certificate shortcodes display information about the learner and the course, quiz, or group for which the certificate is awarded, such as the learner’s name, course title, completion date, or quiz grade.

Shortcodes apply to legacy shortcode-based certificates. The drag-and-drop certificate builder uses Live Data instead of shortcodes. To use dynamic fields in the drag-and-drop builder, open the Insert panel and choose a field under Live Data, such as Full name or Course title. These fields fill automatically for each learner when a certificate is issued.

There are four primary certificate shortcodes, each accepting parameters that control which information is displayed:

  • [usermeta] displays user info
  • [courseinfo] displays course info (only works with certificates assigned to a course)
  • [quizinfo] displays quiz info (only works with certificates assigned to a quiz)
  • [groupinfo] displays group info (only works with certificates assigned to a group)

To locate this reference inside the WordPress admin area, navigate to LearnDash LMS > Certificates and select the Shortcodes tab.

For a complete index of available shortcodes across your LearnDash site, see the all shortcodes documentation.

Gradebook score shortcode

If using the Gradebook add-on, the following shortcode displays the learner’s overall grade from a specific gradebook:

[ld_overall_grade gradebook="123"]

*Replace 123 with the target gradebook ID.

To find the gradebook ID:

  1. Navigate to LearnDash LMS > Gradebook.
  2. Under Manage Gradebooks, hover over the gradebook name to view its ID in the browser URL preview.

The gradebook ID is required for the shortcode to output the grade.

[usermeta]

Use the [usermeta] shortcode to display learner information.

  • [usermeta field="first_name"] – Displays a user’s first name
  • [usermeta field="last_name"] – Displays a user’s last name
  • [usermeta field="display_name"] – Displays a user’s full display name, which is often a combination of {first_name} and {last_name}.
  • [usermeta field="user_login"] – Displays a user’s username
  • [usermeta field="nickname"] – Displays a user’s nickname (might not be captured upon user signup)
  • [usermeta field="user_email"] – Displays a user’s email address
  • [usermeta field="user_url"] – Displays a user’s website address (likely not captured upon user signup)
  • [usermeta field="description"] – Displays a user’s bio (likely not captured upon user signup)
  • [usermeta field="id"] – Displays a user’s unique WordPress user ID

Use [usermeta field="first_name"] and [usermeta field="last_name"] to show the learner’s name.

NOTE: Profile fields collected during registration depend on the checkout or signup configuration. To verify collected fields, navigate to Users > All Users and view an individual user profile.

[courseinfo]

Use [courseinfo] for certificates assigned to a course.

Quiz calculation methods:

  • Aggregate: Sums the highest recorded score or value for each quiz in the course.
  • Cumulative: Averages the highest recorded score or value for each quiz in the course.

Available parameters:

  • [courseinfo show="course_title"] – Displays the course title
  • [courseinfo show="course_price"] – Displays the course price (only for one-time payment courses)
  • [courseinfo show="course_price_type"] – Displays the Access Mode for the given course
  • [courseinfo show="course_url"] – Displays the course URL
  • [courseinfo show="course_points"] – Displays the total available points for the course
  • [courseinfo show="user_course_points"] – Displays the learner’s total earned course points across the site
  • [courseinfo show="enrolled_on"] – Displays the course enrollment date (this does not apply to Open courses)
  • [courseinfo show="completed_on"] – Displays the date the course was completed
  • [courseinfo show="user_course_time"] – Displays the elapsed time from starting the course to completing it, or to the last recorded course activity
  • [courseinfo show="cumulative_score"] – Displays the average quiz score
  • [courseinfo show="cumulative_points"] – Displays the average points earned
  • [courseinfo show="cumulative_total_points"] – Displays the average possible quiz points
  • [courseinfo show="cumulative_percentage"] – Displays the average percentage of all quizzes taken in the course
  • [courseinfo show="cumulative_timespent"] – Displays the average time spent on quizzes in the course
  • [courseinfo show="aggregate_score"] – Displays the sum of the quiz scores
  • [courseinfo show="aggregate_points"] – Displays the total points earned for the course
  • [courseinfo show="aggregate_total_points"] – Displays the total possible quiz points for the course
  • [courseinfo show="aggregate_percentage"] – Displays the sum of the quiz percentages
  • [courseinfo show="aggregate_timespent"] – Displays the total time spent on quizzes for the course as a whole

To customize the date output for completed_on, append the format parameter (See available date formats):

[courseinfo show="completed_on" format="F j, Y"]

[quizinfo]

Use [quizinfo] for certificates assigned to a quiz.

Available parameters:

  • [quizinfo show="score"] – Displays the score received for that quiz
  • [quizinfo show="count"] – Displays the number of questions within the quiz
  • [quizinfo show="pass"] – Displays Yes if the learner passed the quiz, or No if they did not
  • [quizinfo show="timestamp"] – Displays the day/time when the quiz was completed
  • [quizinfo show="points"] – Displays the points received by the user on the quiz
  • [quizinfo show="total_points"] – Displays the total possible points that can be received for a given attempt
  • [quizinfo show="percentage"] – Displays the percentage grade received by the user on the quiz
  • [quizinfo show="quiz_title"] – Displays the name of the quiz
  • [quizinfo show="course_title"] – Displays the name of the course that the quiz is associated with
  • [quizinfo show="timespent"] – Displays the time spent taking the quiz

To customize the date output for timestamp, append the format parameter:

[quizinfo show="timestamp" format="F j, Y"]

[groupinfo]

Use [groupinfo] for certificates assigned to a group.

Available parameters:

  • [groupinfo show="group_title"] – Displays the group’s title
  • [groupinfo show="group_url"] – Displays the group’s URL
  • [groupinfo show="group_price_type"] – Displays the group’s Access Mode
  • [groupinfo show="group_price"] – Displays the group’s price
  • [groupinfo show="group_users_count"] – Displays the number of group enrollees
  • [groupinfo show="group_courses_count"] – Displays the number of courses in the group
  • [groupinfo show="user_group_status"] – Displays the group progress status of the user
  • [groupinfo show="enrolled_on"] – Displays the recorded start date for the learner’s group progress
  • [groupinfo show="completed_on"] – Displays the date the user completed all courses assigned to the group
  • [groupinfo show="percent_completed"] – Displays the percentage of courses the learner has completed in the group

To customize the date output for enrolled_on or completed_on, append the format parameter:

[groupinfo show="completed_on" format="F j, Y"]

Filed under Certificates
Last updated: November 12, 2026
Was this page helpful?
Thanks for the feedback!