> ## Documentation Index
> Fetch the complete documentation index at: https://help.hoopai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add reviews manually to your review widgets

> Import offline reviews via CSV or add them one at a time to consolidate all star ratings and customer feedback in HoopAI.

The Reviews section displays all feedback from integrated social accounts automatically, but you may also have reviews from other platforms or offline sources. This article shows you how to manually add those reviews so all your customer sentiment is managed in one location.

Start by navigating to **Reputation > Reviews** and clicking the **Add Reviews** button.

<Frame caption="Add Reviews button in the Reviews tab">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/hoopai-84ec0cdc/images/reputation-add-reviews-btn.png" alt="Add Reviews Button" />
</Frame>

You will see two options: **Upload CSV** and **Add Manually**.

## Option 1: Upload CSV

Use this method to import a batch of reviews at once.

<Steps>
  <Step title="Review file specifications">
    Before uploading, review the file specifications and download the sample file for a visual guide on how your file should be formatted.

    <Frame caption="CSV upload with file format guide">
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/hoopai-84ec0cdc/images/reputation-add-reviews-csv-upload.png" alt="CSV Upload" />
    </Frame>
  </Step>

  <Step title="Select a platform">
    Choose the review platform from the dropdown. Options include Amazon, Goodreads, Yelp, Zillow, and more. You can also add a custom platform if the desired one is not listed.

    <Frame caption="Platform selection dropdown">
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/hoopai-84ec0cdc/images/reputation-add-reviews-platform.png" alt="Platform Selection" />
    </Frame>
  </Step>

  <Step title="Upload your file">
    Drag and drop your prepared CSV file into the upload area, then click **Upload Reviews** to load the reviews into your review widgets.

    <Frame caption="Upload Reviews button">
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/hoopai-84ec0cdc/images/reputation-add-reviews-upload.png" alt="Upload Reviews" />
    </Frame>
  </Step>
</Steps>

## Option 2: Add manually

If you do not have a file prepared, you can add reviews individually.

<Steps>
  <Step title="Select a star rating">
    Highlight the number of stars the customer gave as their rating.

    <Frame caption="Star rating selector">
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/hoopai-84ec0cdc/images/reputation-add-reviews-rating.png" alt="Star Rating" />
    </Frame>
  </Step>

  <Step title="Enter the review text">
    Copy and paste or type the customer's review in the **Testimonial** field.

    <Frame caption="Testimonial text field">
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/hoopai-84ec0cdc/images/reputation-add-reviews-testimonial.png" alt="Testimonial Field" />
    </Frame>
  </Step>

  <Step title="Upload a customer photo (optional)">
    If the customer shared a photo and consented to it being displayed publicly, you can upload it here. Requirements: between 200×200px and up to 5MB.

    <Frame caption="Profile photo upload">
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/hoopai-84ec0cdc/images/reputation-add-reviews-profile.png" alt="Profile Photo" />
    </Frame>
  </Step>

  <Step title="Enter customer information">
    Enter the customer's name and select the date of the review.

    <Frame caption="Customer details fields">
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/hoopai-84ec0cdc/images/reputation-add-reviews-customer.png" alt="Customer Details" />
    </Frame>
  </Step>

  <Step title="Assign a platform">
    Choose the platform the review should be linked to. Add a custom platform if the desired one is not available.

    <Frame caption="Platform assignment">
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/hoopai-84ec0cdc/images/reputation-add-reviews-platform-assign.png" alt="Platform Assignment" />
    </Frame>
  </Step>

  <Step title="Add attachments and submit">
    Upload any relevant attachments, then click **Submit** to save the review.

    <Frame caption="Attachment upload and submit">
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/hoopai-84ec0cdc/images/reputation-add-reviews-attachments.png" alt="Attachments and Submit" />
    </Frame>
  </Step>
</Steps>

## Where manually added reviews appear

Once imported, manually added reviews appear alongside organic reviews from connected platforms in both the Reviews section and your review widgets.

<Tip>
  Use manually added reviews to populate your review widgets quickly while you build up organic reviews from connected platforms such as Google and Facebook.
</Tip>

## FAQs

<AccordionGroup>
  <Accordion title="Which platforms can I assign to a manually added review?">
    You can assign reviews to any supported platform shown in the platform dropdown — including Amazon, Goodreads, Yelp, Zillow, and more. If your desired platform is not listed, select **Add Custom Platform** to enter it manually.
  </Accordion>

  <Accordion title="What is the correct CSV format for bulk uploads?">
    Download the sample CSV file in the upload dialog to see the required column structure. At minimum your file should include the reviewer name, star rating, review text, review date, and platform. Ensure dates are formatted consistently.
  </Accordion>

  <Accordion title="Will manually added reviews appear in my review widget on my website?">
    Yes. Once imported, manually added reviews appear in your review widgets alongside organic reviews from Google and Facebook. This lets you showcase feedback from all platforms in one place.
  </Accordion>

  <Accordion title="Can I edit or delete a manually added review after submitting it?">
    Manually added reviews can be managed from the Reviews tab. Hover over the three-dot icon on the review card to access delete and other management options.
  </Accordion>

  <Accordion title="Is there a limit to how many reviews I can import at once?">
    There is no published hard limit on CSV uploads. For very large imports, consider splitting your file into batches of a few hundred rows to ensure smooth processing.
  </Accordion>

  <Accordion title="Can I upload a customer photo with a manually added review?">
    Yes. When adding a review manually, you can upload the customer's profile photo. Requirements: the image must be between 200×200px and up to 5MB.
  </Accordion>
</AccordionGroup>
