Importing Q&A into Yotpo
    • Dark
      Light

    Importing Q&A into Yotpo

    • Dark
      Light

    Article summary

    Products


    Reviews
    Supported plans

    Premium, Enterprise

    eCommerce Platform

    Shopify, Shopify Plus, Adobe Commerce (Magento), BigCommerce, WooCommerce, Volusion, Salesforce Commerce Cloud, Custom

    This article describes how to prepare questions and answers for importing by Yotpo.If you want to re-use existing Q&A when migrating to Yotpo, you can provide information from any platform. 

    Please note:
    • If you have more than one account, you need to create an import file for each account
    • You cannot import questions that do not have answers

    Importing Q&A

    Yotpo Support can assist with imports of Q&A. To import the questions and answers:

    Download the template:

    1. Use a spreadsheet application such as LibreOffice or Google Sheets CSV file in UTF-8 encoding.
      Please note:
      If you are using Excel, you must import the CSV file to preserve the encoding. If you open it, any special characters will be lost. Click here for instructions.
    2. Complete the template with the appropriate information filled in according to the following guidelines:
      • All fields are mandatory
      • Ensure that the product-id in your file matches the product-id on your website for every product
      • Make sure the date format is consistent across the entire date column. The recommended format is YYYY-MM-DD, for example, 2016-03-21
      • When you import Q&A to Yotpo, they are automatically published to your website. Edit the files before you send them to Yotpo to remove any Q&A you do not want to be published
      • If a question has multiple answers, create a row for each answer with the same question_id, question poser and product data (see rows 1 and 2 of the template for an example)
      • You cannot have multiple answers for the same question from the same user email
    3. Save the file either as Excel (.xlsx) or a .csv file in UTF-8 encoding. Other formats, such as Apple Numbers, are not supported,
    To save an Excel file in UTF-8 format:
    1. Select Save As in the File menu.
    2. Select Web Options in the Tools menu near the Save button.
    3. Select Encoding.
    4. Select Unicode (UTF-8) in the Save this document as: drop-down list.
    5. Click OK.
    6. Click Save.

    Please note that these instructions depend on the version of Excel you're using.

    To ensure the CSV File is in UTF-8 encoding:
    1. Open the file in Windows Notepad.
    2. Select Save As in the file menu.
    3. Select UTF-8 encoding in the Encoding dropdown menu next to the Save button in the Save As dialog box. Make sure to only select the Tab and Comma Separator Options.
    4. Save the file using a new name.
    5. Go through the checklist below before you submit your files to Yotpo Support.

    Selecting the Tab and Comma Separator Options:

    Checklist:

    • Target account ID for the Q&A import: To find your account ID, click here
    • Verify product IDs 
    • Remove any questions you do not want to be published
    • Verify that all the mandatory fields are filled
    • Remove invalid strings of characters that were converted from emoji into UTF-8
    • Verify the product URLs and product image URLs are valid - The URLs should open the product page.
    • Verify that the character encoding is UTF-8
    • Verify that the file format is Excel (.xlsx) or CSV (comma separated values) - commas between the data, and inverted commas as the text delimiters, for example:
    1. question_id,question_content,question_user_email,question_user_name,question_created_at,product_sku,product_title,product_description6. Use the online support form to send the files and Yotpo will import the Q&A for you. Specify the Yotpo account ID for which to import the Q&A.
      • Yotpo Support will contact you when the questions and answers have been imported.

    Finding your account ID

    To find your account ID, do the following:

    1. Log into Yotpo Reviews.
    2. Click  in the top right corner of your screen.
    3. Select the Account Settings tab.
    4. Click the Store tab. Your Yotpo Account ID is shown at the top of the Store Settings tab.

    Finding product IDs

    To find your product IDs, please click here.

    Import Q&A template

    FieldMandatoryDescriptionExample
    question_idXThe unique id of the question.1
    question_contentXThe content of the questionWhat colors does the T-shirt come in?
    question_user_emailXThe email of the user who asked the questionjohndoe@email.com
    question_user_nameXThe name of the user who asked the questionJohn Doe
    question_created_atXThe date the question was asked in YYYY-MM-DD format2016-03-21
    product_skuXThe sku (product ID)1
    product_titleXThe name of the productYotpo T-shirt
    product_descriptionXThe description of the product on the storeYotpo-branded T-shirt
    product_urlXThe url of the product on your storehttp://magento.yotpo.com/index.php/yotpo-products/yotpo-t-shirt.html
    product_image_urlXThe url of the product imagehttp://magento.yotpo.com/media/catalog/product/cache/1/image/9df78eab33525d08d6e5fb8d27136e95/2/0/2011-12-19_15.13.05_large.jpeg
    answer_contentXThe answer added by a customer or the store ownerOnly in a stylish blue at the moment
    answer_user_emailXThe email of the person who answeredjane_smith@domain.com
    answer_user_nameXThe name of the person who answeredJane Smith
    answer_created_atXThe date the answer was created2016-03-23
    Please note:
    • All fields are mandatory
    • One product may have multiple questions
    • One question may have multiple answers
    • If a question has multiple answers, create a row for each answer with the same question_id, question poser and product data (see rows 1 and 2 of the template for an example)
    • You cannot have multiple answers for the same question from the same user email
    • product_sku is the product_id

    Was this article helpful?