{"id":2459,"date":"2019-05-22T17:39:57","date_gmt":"2019-05-22T21:39:57","guid":{"rendered":"https:\/\/learndash.com\/support\/docs\/core\/quizzes\/quiz-custom-fields\/"},"modified":"2025-08-07T14:02:48","modified_gmt":"2025-08-07T18:02:48","password":"","slug":"quiz-custom-fields","status":"publish","type":"docs","link":"https:\/\/learndash.com\/support\/kb\/core\/quizzes\/quiz-custom-fields\/","title":{"rendered":"Quiz Custom Fields"},"content":{"rendered":"\n<p><strong>Quiz Custom Fields<\/strong> allow course creators to collect additional information from learners, either before the quiz begins or just before it ends. These fields are useful for gathering feedback, capturing learner details, or asking custom questions relevant to the course.<\/p>\n\n\n\n<p class=\"note has-theme-palette-7-background-color has-background\"><strong>NOTE<\/strong>: Custom fields are configured on a <strong>per-quiz<\/strong> basis. There is no option to set them globally for all quizzes.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Enabling Quiz Custom Fields<\/h2>\n\n\n\n<p>To turn on Custom Fields for a quiz:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Go to <strong>LearnDash LMS > Quizzes<\/strong>.<\/li>\n\n\n\n<li>Click on the quiz to edit.<\/li>\n\n\n\n<li>Open the <strong>Settings<\/strong> tab.<\/li>\n\n\n\n<li>Scroll to the <strong>Administrative and Data Handling Settings<\/strong> section.<\/li>\n\n\n\n<li>Toggle <strong>Custom Fields<\/strong> to <strong>ON<\/strong>.<\/li>\n<\/ol>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1884\" height=\"882\" src=\"https:\/\/learndash.com\/support\/wp-content\/uploads\/2019\/05\/learndash-quiz-custom-fields-admin-setup.jpg\" alt=\"LearnDash quiz custom fields admin setup\" class=\"wp-image-2654\" srcset=\"https:\/\/learndash.com\/support\/wp-content\/uploads\/2019\/05\/learndash-quiz-custom-fields-admin-setup.jpg 1884w, https:\/\/learndash.com\/support\/wp-content\/uploads\/2019\/05\/learndash-quiz-custom-fields-admin-setup-400x187.jpg 400w, https:\/\/learndash.com\/support\/wp-content\/uploads\/2019\/05\/learndash-quiz-custom-fields-admin-setup-768x360.jpg 768w, https:\/\/learndash.com\/support\/wp-content\/uploads\/2019\/05\/learndash-quiz-custom-fields-admin-setup-800x375.jpg 800w\" sizes=\"auto, (max-width: 1884px) 100vw, 1884px\" \/><\/figure><\/div>\n\n\n<h2 class=\"wp-block-heading\">Choosing the Display Position<\/h2>\n\n\n\n<p>Custom Fields can appear in one of two places:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>At the start of the quiz<\/strong><br>Shown below any quiz description and <strong>above<\/strong> the <strong>Start Quiz<\/strong> button.<\/li>\n\n\n\n<li><strong>At the end of the quiz<\/strong><br>Shown <strong>before<\/strong> the <strong>Finish Quiz<\/strong> button, after all questions are answered.<\/li>\n<\/ul>\n\n\n\n<p>Choose the position that best suits the goal of your custom questions.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1508\" height=\"688\" src=\"https:\/\/learndash.com\/support\/wp-content\/uploads\/2019\/05\/learndash-quiz-custom-field-collection-before.jpg\" alt=\"Quiz custom field collection before a quiz\" class=\"wp-image-2655\" srcset=\"https:\/\/learndash.com\/support\/wp-content\/uploads\/2019\/05\/learndash-quiz-custom-field-collection-before.jpg 1508w, https:\/\/learndash.com\/support\/wp-content\/uploads\/2019\/05\/learndash-quiz-custom-field-collection-before-400x182.jpg 400w, https:\/\/learndash.com\/support\/wp-content\/uploads\/2019\/05\/learndash-quiz-custom-field-collection-before-768x350.jpg 768w, https:\/\/learndash.com\/support\/wp-content\/uploads\/2019\/05\/learndash-quiz-custom-field-collection-before-800x365.jpg 800w\" sizes=\"auto, (max-width: 1508px) 100vw, 1508px\" \/><\/figure><\/div>\n\n\n<p class=\"note has-theme-palette-7-background-color has-background\"><strong>NOTE<\/strong>: If you choose this option, the &#8220;Autostart&#8221; setting in your <a href=\"https:\/\/learndash.com\/support\/docs\/core\/quizzes\/quiz-display\/#autostart\">quiz display settings<\/a> is ignored, and a &#8220;Start Quiz&#8221; button will always be displayed.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-setting-up-custom-fields\">Setting up Custom Fields<\/h2>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"816\" height=\"358\" src=\"https:\/\/learndash.com\/support\/wp-content\/uploads\/2019\/05\/learndash-quiz-custom-field-add-move-remove-animation.gif\" alt=\"How to use LearnDash quiz custom fields, an animation\" class=\"wp-image-2657\"\/><\/figure><\/div>\n\n\n<h2 class=\"wp-block-heading\">Setting Up Custom Fields<\/h2>\n\n\n\n<p>Once Custom Fields are enabled, follow these steps to add and configure them:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Click <strong>Add Field<\/strong>.<\/li>\n\n\n\n<li>Complete the field settings:<\/li>\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-field-name\">Field Name<\/h3>\n\n\n\n<p>The label that appears to learners (e.g., \u201cWhat did you think of this quiz?\u201d).<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-field-type\">Field Type<\/h3>\n\n\n\n<p>Choose the type of input:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Text<\/strong> \u2013 Single-line text<\/li>\n\n\n\n<li><strong>Textarea<\/strong> \u2013 Multi-line text<\/li>\n\n\n\n<li><strong>Checkbox<\/strong> \u2013 Multiple selections<\/li>\n\n\n\n<li><strong>Drop-Down Menu<\/strong> \u2013 One selection from a list<\/li>\n\n\n\n<li><strong>Radio<\/strong> \u2013 One selection, displayed as buttons<\/li>\n\n\n\n<li><strong>Number<\/strong> \u2013 Numeric input only<\/li>\n\n\n\n<li><strong>Email<\/strong> \u2013 Valid email address required<\/li>\n\n\n\n<li><strong>Yes\/No<\/strong> \u2013 Simple yes\/no choice<\/li>\n\n\n\n<li><strong>Date<\/strong> \u2013 Month, day, and year dropdowns<\/li>\n<\/ul>\n\n\n\n<p class=\"has-theme-palette-7-background-color has-background\"><strong>Tip:<\/strong> For <strong>Checkbox<\/strong>, <strong>Radio<\/strong>, or <strong>Drop-Down<\/strong>, click <strong>Edit List<\/strong> to add your custom options.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"806\" height=\"482\" src=\"https:\/\/learndash.com\/support\/wp-content\/uploads\/2019\/05\/learndash-quiz-custom-field-edit-list-animation.gif\" alt=\"Edit a list in a LearnDash quiz custom field\" class=\"wp-image-2658\"\/><\/figure><\/div>\n\n\n<h2 class=\"wp-block-heading\">Optional Field Settings<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Required<\/strong><br>Toggle ON to make the field mandatory. Learners must complete it before continuing.<\/li>\n\n\n\n<li><strong>Reorder Fields<\/strong><br>Hover over the six dots beside the field name and drag to change the order.<\/li>\n\n\n\n<li><strong>Delete Field<\/strong><br>Hover over the row and click <strong>Remove<\/strong> to delete a field.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"h-custom-fields-data-storage\">Custom Fields Data Storage<\/h2>\n\n\n\n<p>Learner responses to custom fields are saved with quiz results. These can be accessed in two places:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/learndash.com\/support\/kb\/core\/getting-started-with-learndash\/shortcodes-blocks\/#h-learndash-profile\"><strong>LearnDash Profile<\/strong> <strong>Block or Shortcode<\/strong><\/a><br>Custom field data appears alongside quiz statistics in the profile block or using the <code>[ld_profile]<\/code> shortcode.<\/li>\n\n\n\n<li><strong><a href=\"https:\/\/learndash.com\/support\/glossary\/admin\/\">WordPress Admin Dashboard<\/a><\/strong><br>Visit a user\u2019s profile and click <strong>Statistics<\/strong> to view their quiz data.<\/li>\n<\/ul>\n\n\n\n<p class=\"has-theme-palette-7-background-color has-background\"><strong>Note:<\/strong> The <strong>Quiz Statistics<\/strong> option must be enabled in the quiz settings to store custom field data.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Next Steps<\/h2>\n\n\n\n<p>Quiz Custom Fields can be a valuable tool for:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Collecting course feedback<\/li>\n\n\n\n<li>Asking follow-up questions<\/li>\n\n\n\n<li>Capturing learner details before final quiz submission<\/li>\n<\/ul>\n\n\n\n<p>For more quiz customization options, see the <a href=\"https:\/\/learndash.com\/support\/kb\/core\/quizzes\/quiz-builder\/\">Quiz Builder<\/a> tutorial.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Quiz Custom Fields allow course creators to collect additional information from learners, either before the quiz begins or just before it ends. These fields are useful for gathering feedback, capturing learner details, or asking custom questions relevant to the course. NOTE: Custom fields are configured on a per-quiz basis. There is no option to set&#8230;<\/p>\n","protected":false},"author":59,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_helpful_status":1,"_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","_swpsp_post_exclude":false,"_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"footnotes":""},"doc_category":[170],"doc_tag":[],"knowledge_base":[154],"class_list":["post-2459","docs","type-docs","status-publish","hentry","doc_category-quizzes","knowledge_base-core"],"year_month":"2026-04","word_count":444,"total_views":"4847","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"display_name":"Matt Cromwell","author_link":"https:\/\/learndash.com\/support\/author\/mattc\/"},"doc_category_info":[{"term_name":"Quizzes","term_url":"https:\/\/learndash.com\/support\/kb\/core\/quizzes\/"}],"doc_tag_info":[],"taxonomy_info":{"doc_category":[{"value":170,"label":"Quizzes"}],"knowledge_base":[{"value":154,"label":"LearnDash Core"}]},"featured_image_src_large":false,"comment_info":0,"knowledge_base_info":[{"term_name":"LearnDash Core","term_url":"https:\/\/learndash.com\/support\/kb\/core\/","term_slug":"core"}],"knowledge_base_slug":["core"],"_links":{"self":[{"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/docs\/2459","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/users\/59"}],"replies":[{"embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/comments?post=2459"}],"version-history":[{"count":10,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/docs\/2459\/revisions"}],"predecessor-version":[{"id":10355,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/docs\/2459\/revisions\/10355"}],"wp:attachment":[{"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/media?parent=2459"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/doc_category?post=2459"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/doc_tag?post=2459"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/learndash.com\/support\/wp-json\/wp\/v2\/knowledge_base?post=2459"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}