{"id":31924,"date":"2025-07-21T14:18:49","date_gmt":"2025-07-21T08:18:49","guid":{"rendered":"https:\/\/hasthemes.com\/?post_type=docs&#038;p=31924"},"modified":"2025-07-21T14:48:10","modified_gmt":"2025-07-21T08:48:10","password":"","slug":"ratings-field-in-ht-contact-form","status":"publish","type":"docs","link":"https:\/\/hasthemes.com\/docs\/ratings-field-in-ht-contact-form\/","title":{"rendered":"Ratings Field in HT Contact Form"},"content":{"rendered":"\n<p>The <strong>Ratings field<\/strong> in HT Contact Form lets users rate a product, service, or experience directly within your form using visual stars. It\u2019s a perfect way to collect user feedback in a simple, interactive format.<\/p>\n\n\n\n<p>In this guide, you\u2019ll learn how to add and configure the Ratings field with custom labels, scores, and conditional logic.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Step 1: Add the Ratings Field to Your Form<\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Go to <strong>HT Contact Form<\/strong> \u2192 <strong>Forms<\/strong> in your WordPress dashboard.<\/li>\n\n\n\n<li>Open an existing form or create a new one.<\/li>\n\n\n\n<li>From the left-hand field panel, drag the <strong>Ratings<\/strong> field into your form layout.<\/li>\n<\/ol>\n\n\n\n<figure class=\"wp-block-image size-large\"><img fetchpriority=\"high\" decoding=\"async\" width=\"1024\" height=\"530\" src=\"https:\/\/hasthemes.com\/wp-content\/uploads\/2025\/07\/add-rating-filed-1024x530.png\" alt=\"\" class=\"wp-image-31936\" srcset=\"https:\/\/hasthemes.com\/wp-content\/uploads\/2025\/07\/add-rating-filed-1024x530.png 1024w, https:\/\/hasthemes.com\/wp-content\/uploads\/2025\/07\/add-rating-filed-300x155.png 300w, https:\/\/hasthemes.com\/wp-content\/uploads\/2025\/07\/add-rating-filed-768x398.png 768w, https:\/\/hasthemes.com\/wp-content\/uploads\/2025\/07\/add-rating-filed-360x186.png 360w, https:\/\/hasthemes.com\/wp-content\/uploads\/2025\/07\/add-rating-filed.png 1535w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<div style=\"height:40px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h2 class=\"wp-block-heading\">Step 2: Configure Ratings Field Settings<\/h2>\n\n\n\n<p>After adding the field, you can customize the label, rating options, and display behavior.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Available Settings:<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Admin Label<\/strong>: Internal name for identification (not visible to users).<\/li>\n\n\n\n<li><strong>Field Label<\/strong>: Public label shown above the rating stars (e.g., \u201cRate Your Experience\u201d).<\/li>\n\n\n\n<li><strong>Label Position<\/strong>: Choose where the label is placed (Default, Top, Left, Right).<\/li>\n\n\n\n<li><strong>Options<\/strong>: Add rating levels with custom labels and values (e.g., \u201cExcellent = 4\u201d).<\/li>\n\n\n\n<li><strong>Default Selection<\/strong>: Pre-select a rating (optional).<\/li>\n\n\n\n<li><strong>Add\/Remove Options<\/strong>: Use the plus or trash icons to modify the list.<\/li>\n<\/ol>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"604\" src=\"https:\/\/hasthemes.com\/wp-content\/uploads\/2025\/07\/rating-available-filed-settings-1024x604.png\" alt=\"\" class=\"wp-image-31937\" srcset=\"https:\/\/hasthemes.com\/wp-content\/uploads\/2025\/07\/rating-available-filed-settings-1024x604.png 1024w, https:\/\/hasthemes.com\/wp-content\/uploads\/2025\/07\/rating-available-filed-settings-300x177.png 300w, https:\/\/hasthemes.com\/wp-content\/uploads\/2025\/07\/rating-available-filed-settings-768x453.png 768w, https:\/\/hasthemes.com\/wp-content\/uploads\/2025\/07\/rating-available-filed-settings-360x212.png 360w, https:\/\/hasthemes.com\/wp-content\/uploads\/2025\/07\/rating-available-filed-settings.png 1535w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<div style=\"height:40px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h2 class=\"wp-block-heading\">Step 3: Additional Field Options<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Optional Settings:<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Show Text<\/strong>: Toggle ON to display rating label (e.g., \u201cGood\u201d, \u201cExcellent\u201d).<\/li>\n\n\n\n<li><strong>Required<\/strong>: Make rating submission mandatory.<\/li>\n\n\n\n<li><strong>Field Size<\/strong>: Adjust the size (Small, Medium, Large).<\/li>\n\n\n\n<li><strong>Field Class<\/strong>: Add custom CSS class for styling.<\/li>\n\n\n\n<li><strong>Help Message<\/strong>: Add extra instruction below the rating stars.<\/li>\n\n\n\n<li><strong>Message Position<\/strong>: Choose where validation\/help messages appear.<\/li>\n\n\n\n<li><strong>Name Attribute<\/strong>: Used in submission data (developer use).<\/li>\n<\/ol>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"604\" src=\"https:\/\/hasthemes.com\/wp-content\/uploads\/2025\/07\/rating-additinal-filed-options-1024x604.png\" alt=\"\" class=\"wp-image-31938\" srcset=\"https:\/\/hasthemes.com\/wp-content\/uploads\/2025\/07\/rating-additinal-filed-options-1024x604.png 1024w, https:\/\/hasthemes.com\/wp-content\/uploads\/2025\/07\/rating-additinal-filed-options-300x177.png 300w, https:\/\/hasthemes.com\/wp-content\/uploads\/2025\/07\/rating-additinal-filed-options-768x453.png 768w, https:\/\/hasthemes.com\/wp-content\/uploads\/2025\/07\/rating-additinal-filed-options-360x212.png 360w, https:\/\/hasthemes.com\/wp-content\/uploads\/2025\/07\/rating-additinal-filed-options.png 1535w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<div style=\"height:40px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h2 class=\"wp-block-heading\">Step 4: Apply Conditional Logic (Optional)<\/h2>\n\n\n\n<p>Want to show the Ratings field only if users meet certain criteria?<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Toggle <strong>Enable Condition<\/strong> to ON.<\/li>\n\n\n\n<li>Choose <strong>All<\/strong> or <strong>Any<\/strong> match type.<\/li>\n\n\n\n<li>Set up field-based rules using dropdowns.<\/li>\n<\/ol>\n\n\n\n<p>Example: Only show Ratings field if &#8220;Dropdown = Product Feedback&#8221;.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"604\" src=\"https:\/\/hasthemes.com\/wp-content\/uploads\/2025\/07\/rating-conditinal-logic-1024x604.png\" alt=\"\" class=\"wp-image-31939\" srcset=\"https:\/\/hasthemes.com\/wp-content\/uploads\/2025\/07\/rating-conditinal-logic-1024x604.png 1024w, https:\/\/hasthemes.com\/wp-content\/uploads\/2025\/07\/rating-conditinal-logic-300x177.png 300w, https:\/\/hasthemes.com\/wp-content\/uploads\/2025\/07\/rating-conditinal-logic-768x453.png 768w, https:\/\/hasthemes.com\/wp-content\/uploads\/2025\/07\/rating-conditinal-logic-360x212.png 360w, https:\/\/hasthemes.com\/wp-content\/uploads\/2025\/07\/rating-conditinal-logic.png 1535w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<div style=\"height:40px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<div style=\"height:30px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h2 class=\"wp-block-heading\">Preview<\/h2>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"780\" height=\"437\" src=\"https:\/\/hasthemes.com\/wp-content\/uploads\/2025\/07\/rating-preview.png\" alt=\"\" class=\"wp-image-31940\" srcset=\"https:\/\/hasthemes.com\/wp-content\/uploads\/2025\/07\/rating-preview.png 780w, https:\/\/hasthemes.com\/wp-content\/uploads\/2025\/07\/rating-preview-300x168.png 300w, https:\/\/hasthemes.com\/wp-content\/uploads\/2025\/07\/rating-preview-768x430.png 768w, https:\/\/hasthemes.com\/wp-content\/uploads\/2025\/07\/rating-preview-360x202.png 360w\" sizes=\"(max-width: 780px) 100vw, 780px\" \/><\/figure>\n","protected":false},"excerpt":{"rendered":"<p>The Ratings field in HT Contact Form lets users rate a product, service, or experience directly within your form using visual stars. It\u2019s a perfect way to collect user feedback in a simple, interactive format. In this guide, you\u2019ll learn how to add and configure the Ratings field with custom labels, scores, and conditional logic. [&hellip;]<\/p>\n","protected":false},"author":22,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_uag_custom_page_level_css":"","_mi_skip_tracking":false,"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"set","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"doc_category":[259],"doc_tag":[],"class_list":["post-31924","docs","type-docs","status-publish","hentry","doc_category-ht-contact-forms"],"acf":[],"year_month":"2025-11","word_count":293,"total_views":"198","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"Saidul","author_nicename":"saidul","author_url":"https:\/\/hasthemes.com\/author\/saidul\/"},"doc_category_info":[{"term_name":"HT Contact Forms","term_url":"https:\/\/hasthemes.com\/docs-category\/ht-contact-forms\/"}],"doc_tag_info":[],"uagb_featured_image_src":{"full":false,"thumbnail":false,"medium":false,"medium_large":false,"large":false,"1536x1536":false,"2048x2048":false,"htmega_size_585x295":false,"htmega_size_1170x536":false,"htmega_size_396x360":false,"betterdocs-category-thumb":false},"uagb_author_info":{"display_name":"Saidul","author_link":"https:\/\/hasthemes.com\/author\/saidul\/"},"uagb_comment_info":0,"uagb_excerpt":"The Ratings field in HT Contact Form lets users rate a product, service, or experience directly within your form using visual stars. It\u2019s a perfect way to collect user feedback in a simple, interactive format. In this guide, you\u2019ll learn how to add and configure the Ratings field with custom labels, scores, and conditional logic.&hellip;","knowledge_base_info":[],"knowledge_base_slug":[],"_links":{"self":[{"href":"https:\/\/hasthemes.com\/wp-json\/wp\/v2\/docs\/31924","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/hasthemes.com\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/hasthemes.com\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/hasthemes.com\/wp-json\/wp\/v2\/users\/22"}],"replies":[{"embeddable":true,"href":"https:\/\/hasthemes.com\/wp-json\/wp\/v2\/comments?post=31924"}],"version-history":[{"count":5,"href":"https:\/\/hasthemes.com\/wp-json\/wp\/v2\/docs\/31924\/revisions"}],"predecessor-version":[{"id":32043,"href":"https:\/\/hasthemes.com\/wp-json\/wp\/v2\/docs\/31924\/revisions\/32043"}],"wp:attachment":[{"href":"https:\/\/hasthemes.com\/wp-json\/wp\/v2\/media?parent=31924"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/hasthemes.com\/wp-json\/wp\/v2\/doc_category?post=31924"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/hasthemes.com\/wp-json\/wp\/v2\/doc_tag?post=31924"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}