> ## Documentation Index > Fetch the complete documentation index at: https://docs.kwebby.com/llms.txt > Use this file to discover all available pages before exploring further. # Product reviews and Verified purchase > Show star ratings and the reviews you approve on the product page, with a Verified purchase badge, and collect new reviews through a form, without an app. Kelvin can show customer reviews on the product page without a reviews app. The **Below: reviews** block shows three things: a rating score, the reviews you have published for that product, and a **Write a review** form. You publish every review yourself in the Shopify admin, so nothing appears until you add it, and Kelvin never invents a review, a star or a badge. ![The reviews section on a product page](https://mintcdn.com/kwebby/tbWCv70mkhaUy_7w/images/kelvin/guide-reviews.webp?fit=max\&auto=format\&n=tbWCv70mkhaUy_7w\&q=85\&s=4e3650bbe11cc62b334944b5f943d838) 1 the score, 2 a published review with the Verified purchase badge **1. Create the review definition.** In **Settings → Custom data → Metaobjects**, click **Add definition** and name it **Product review**. Shopify suggests the type `product_review` from that name, but Shopify reserves that type, so change it to `customer_review`. Add these fields, with exactly these keys: | Key | Type | Shown as | | - | - | - | | `rating` | Integer from 1 to 5, or Rating from 1 to 5 | The stars | | `title` | Single line text | The review's headline | | `author` | Single line text | The reviewer's name, such as Sam P. | | `used_for` | Single line text | A Used for line, such as Used for gaming | | `body` | Multi-line text | The review text | | `date` | Date | The date it was written | | `verified` | True or false | The Verified purchase badge, when true | Keep **Storefronts** access on for the definition, so the theme can read the entries. If you turn on the definition's active and draft status, only active entries show on the store. **2. Add the Reviews metafield to products.** In **Settings → Custom data → Products**, click **Add definition**. Name it **Reviews** with the namespace and key `custom.reviews`. Choose the type **Metaobject**, select **Product review** as the reference, choose **List of entries**, and save. **3. Check the block.** The default product template has **Below: reviews** on install. In the theme editor open **Products → Default product** and select it: * **Heading**: leave it empty for Reviews. * **Note under the heading**: an optional short line, for example how you check reviews. * **Show the product's reviews**: the list from the Reviews metafield. * **Reviews shown before Show all**: 2 to 12, 4 on install. The rest open from a Show more reviews button. * **Show the Write a review form**: the form described below. **4. Publish a review.** Open the product in **Products**, find the **Reviews** metafield and add an entry, or create entries in **Content → Metaobjects → Product review** and select them there. Fill in the fields, and tick `verified` only for a review you matched to a real order that includes this product. Reviews show in the order of the list, so put the most useful first. **The score.** When a reviews app writes Shopify's rating metafields `reviews.rating` and `reviews.rating_count`, the score shows those, on the app's scale. Otherwise it is the average of the reviews in the list, with their number as the count. With neither, no score shows. **Stars elsewhere.** The **Rating** block in the buy box, quick view and the stars on product cards read only `reviews.rating` and `reviews.rating_count`. With Kelvin's own reviews alone, stars show in the reviews section only. To show them everywhere, let a reviews app write those metafields, or add Shopify's standard product definitions **Product rating** and **Product rating count** and fill them in yourself; the reviews section then shows that rating instead of the average. **How the Write a review form works.** It is a Shopify contact form, so it needs no app and no outside service. A sent review arrives as a contact form email to your store, with the rating, title, text, the name to show, the product, a link to it and the customer's email. The form asks for a star rating and at least 20 characters of text, and tells the customer that reviews are checked before they appear. * **A signed-in customer who bought the product:** Kelvin looks through the customer's own orders for this product. When one includes it, the form names the order, for example #1042, and says that once you check the order the review can show Verified purchase. The email carries the tags `product-review, verified-purchase` and a **Verified purchase** line with the order name. * **Any other signed-in customer:** the form explains that reviews from customers whose orders include the product can show Verified purchase, and the email carries the tag `product-review`. * **A guest:** instead of the form, a **Sign in to review** button opens your customer sign-in page. ![The Write a review form for a signed-in customer](https://mintcdn.com/kwebby/tbWCv70mkhaUy_7w/images/kelvin/guide-reviews-form.webp?fit=max\&auto=format\&n=tbWCv70mkhaUy_7w\&q=85\&s=22159c7681c4762a91c4399afa547a7d) A signed-in customer whose order includes the product sees the order named and is told the review can show Verified purchase **5. Publish what you receive.** Read the email, then find the order named in **Verified purchase** under **Orders**: it should belong to that customer and include the product. Add the review as an entry on the product's Reviews metafield, and tick `verified` once the order checks out. The order name in the email is a hint, not proof: the badge appears only when you tick it. > [!NOTE] > > Kelvin reads the signed-in customer's orders on the product page, outside the account pages, and this is not yet confirmed on a live store. Test it once: sign in as a customer who has an order, open a product from that order and check that the form names the order. If it does not, the form still sends a plain review and you match the order yourself. **Using a reviews app.** Add the app's block right after **Below: reviews** (**Add block → Apps**); it sits beside the score. If the app collects and shows reviews itself, turn off **Show the product's reviews** and **Show the Write a review form**. **What Kelvin never does.** It never publishes a review on its own, never asks customers for reviews by email, and never shows a star or a Verified purchase badge that is not in your data. On the demo, the reviews are sample entries, marked as such under the heading. ## In the theme editor ![Reviews in the theme editor](https://mintcdn.com/kwebby/QKNMzt7KPy_yk6ai/images/kelvin/editor-reviews.webp?fit=max\&auto=format\&n=QKNMzt7KPy_yk6ai\&q=85\&s=732fd823e8ff85b791090a01f25493ef) The home page Reviews section: 1 Reviews · 2 its settings · 3 the preview This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.