Submission forms

Submission forms

A submission form enables your contributors to rate and review your products and services.

Clients collect the majority (74%) of native content by sending out review requests (formerly post-interaction email or PIE) with a link that loads the product review submission form.

Types of submission forms

Consider which type of review submission form you want your contributors to fill in before sending a review request:

  • Single-product submission (SPS): Allows contributors to rate and review a single product or service. This is the default Ratings & Reviews submission form.

  • Multi-product submission (MPS): Allows contributors to rate and review multiple products from a single email. Once the initial review is submitted, the multiple-product form automatically kicks in and the contributor is prompted to submit reviews for all remaining products using a seamless data-driven user experience.

    Note
    Note: The submission link for the Review Request Email (RRE) and the Review Request Reminder (RRR) has a limit on the number of products that can be included. Refer to Limitations in multi-product submission link for more information.

If you're not sending review requests through Bazaarvoice, learn how to create a single-product simple submission URL (ssURL)External link icon and multi-product simple submission URL (ssURL)External link icon.

Note
To access ssURL information in Support Community, sign in to the Bazaarvoice Portal first. Then, select the Access the Support Community link located at the bottom of the Home page or top of the Help window. To open the Help window, select the Help icon in-app help icon in the upper-right corner.
Note
You can expect to generate four approved reviews for every 100 post-purchase emails sent out (on average). MPS drives higher review volume than single product submission forms.

Single-product submission form types

When configuring a submission form layout for contributors to provide reviews and ratings, you can select from the following formats:

Compact form: Contains two sections—one for mandatory questions and another for optional questions grouped together. 

Detailed form: Distributes optional questions across multiple sections instead of grouping them into one section. The form structure includes:

  • Mandatory questions in the first section

  • Optional questions divided into four sections:

    • Photo and video uploads

    • People-related questions

    • Product-related questions

    • Net Promoter Score (NPS)

To keep all optional questions in one section, select Compact  when you configure the form. To organize optional questions into separate sections, select Detailed. For configuration options, refer to Configure options for Ratings & Reviews.

What type of information can I collect?

You can configure your review submission form to collect the following valuable information:

  • Product star rating (mandatory)
  • Review title (mandatory)
  • Review text (mandatory)
  • Customer nickname (mandatory)
  • Customer email address (mandatory)
  • Answers to additional questions (optional)
  • Photos (optional)
  • Video links (optional)
  • Customer location (optional)
Note
To submit the review, consumers must complete the required fields on the submission form. You can also configure your submission form to include additional sections with optional fields.

V2 only Consumers have 30 days to edit both completed and skipped sections after submitting their review. This allows for progressive submission, enabling continuous updates and modifications of the reviews submitted. Completed sections are labeled as Completed, and skipped sections are labeled as Skipped.

Submission form examples

The following image is an example of a Ratings & Reviews single-product and multi-product submission form elements.

Single-product submission form Multi-product submission form

Works on mobile and desktop, but optimized for desktop.

Works on mobile and desktop, but optimized for mobile.

Single-product submission form
Multi-product submission form

Submission form: design best practices

  • To maximize the number of contributions on your website and minimize abandonment, keep your submission form simple and easy to complete. Collect the following types of information:

    • Useful information that helps consumers to make informed decisions based on the review.
    • Business intelligence information, such as authentic user sentiment about your products or services.
    • Words or quotes from consumers that your company can use to improve product quality or to make merchandising or marketing decisions.
    • Emojis with text that helps consumers to share more impactful expressions than words in the content when they submit reviews, questions, answers, and comments. For example, “Loving how these sunglasses look on me!😎".
    • Photos and videos of products from consumers that your company can showcase on the product display pages (PDPs) to help consumers make informed purchase decisions.
  • To ensure security of your customers, don't ask for personally identifiable information (PII) in submission form questions, even if the questions are hidden on the review display. For example, don't request the following:

    • Physical mail addresses
    • Date or place of birth
    • Telephone numbers
    • Drivers license or vehicle identification numbers
  • To enhance the quality of the user-generated review content received, provide AI-generated topic suggestions to the consumers while they write a review. The Content Coach feature dynamically suggests relevant topics based on the product’s name, description, and category. When a consumer mentions a suggested topic while writing the review, the topic text is highlighted. This enables consumers to write more helpful and specific reviews. 
Note
Content Coach can be implemented for English locales only.

Content coach

Refer to Major features in V2 display to watch a video on how Content Coach helps consumers to write quality reviews.

Before implementing Content Coach:
  • Contact Bazaarvoice Support to enable this feature in the Workbench.
  • Enable and configure Content Coach for your implementation.
To configure Content Coach for your implementation:
  1. From the Site Manager page in Configuration, under the Implementations section, select Edit next to the implementation you want to configure.
  2. In the User Experience section, select Display Options.
  3. Select the Ratings & Reviews tab.
  4. Under Content Coach, select Enabled.
  5. (Optional) To display Content Coach expanded or collapsed by default on mobile devices, under Display topics (Mobile submission form), select Show all or Hide all. 

Upload native and YouTube videos to reviews

You can improve the quality of reviews by allowing consumers to upload native and YouTube videos. Consumers can add videos when submitting a review through the submission form. To enable this feature in your implementation, refer to Configure options for Ratings & Reviews. Once enabled, consumers can:

  • Upload a video from their device
  • Create a video using a mobile device
  • Upload a YouTube video

Note
Note: Consumers can create videos only using mobile devices. Videos must be 200 MB or smaller.

Upload a native video

  1. In the submission form, under Add Video, select Upload.
  2. Select a video from your device storage.
  3. Select Open to start uploading the video.The video will upload automatically if it meets the required guidelines.

Create a video (Mobile devices only)

  1. In the submission form, under Add Video, select Create.
  2. Record your video.
    • If the consumer has already granted the necessary permissions, the video recording screen will open immediately.
    • If permissions are not granted, you’ll see a message that appears for 5 seconds, reminding you to update your permissions in your device settings. Consumers can update the permissions in their device settings and then return to the form.
  3. After recording, the video upload starts automatically, and a loading screen appears.

Upload a YouTube video

To upload a video, select YouTube and enter the video link.

Note
Note: Consumers cannot add or edit a video after submission.

Supported video formats and compatibility

Most commonly used video formats are supported in Chrome, Safari, and Firefox, and on Android, macOS, and iOS devices. The table below lists the supported video formats along with browser and device combinations.

Video formats Chrome Safari Firefox
3GP/3G2, AVI, MOV, MP4/F4V, MPEG/MPG, QuickTime (QT), and WMV All devices All devices All devices
ASF Android, Mac desktop Android, Mac desktop Android
FLV Android All devices All devices

Note
Note: When a video is recorded using the default camera interface of your mobile device:
  • On iOS devices, the video is saved in MOV format.
  • On Android devices, the video is saved in MP4 format.

Why are simple submission URLs important?

A simple submission URL (ssURL) is a structured URL with parameters that contain information for triggering a submission form. It allows you to create and embed a link in the email templates that you use to send email messages to contributors. It will take a potential contributor directly to the review submission form for a specific product.

Sign in to the Bazaarvoice Support Community to understand how to create an ssURLExternal link icon.

Simple submission URLs are commonly used in email campaigns, review-request email messages, website banners, and splash pages to encourage review volume.

  • You can use data-injection with single-product ssURLs.

  • You can add information to reviews for tracking and reporting purposes.

  • Through simple submission technology, you can pre-authenticate contributors so they don't have to sign in before they submit reviews.

    Note
    Research shows that when customers have to locate a product page, open the submission form, and sign in, almost 75% of the customers abandon during the process. The ssURLs removes that barrier, potentially increasing review volume and the effectiveness of email campaigns.
  • You can use ssURLs in both site authentication and hosted authentication. In hosted authentication, Bazaarvoice creates a user token to identify the user details, which will expire after 30 days. So, consumers can submit a review only within 30 days of the initial submission. The UAS (user authentication string) token returned during the hosted authentication review submission is set to expire after 30 days for security reasons. If hosted authentication is implemented on your website, ensure the single review per user configuration is enabled to allow the cookie to be stored in the browser. The cookie will persist only on the browser from which a consumer has submitted the review. To learn more about Bazaarvoice cookies, refer to Bazaarvoice cookie consent.

Single-product submission form

Specify an alternate return page

By default, customers return to the URL where they selected the Write a review link to access the review submission form. However, you can choose to specify a different return page.

Note
You must use an absolute URL when redirecting to the alternate page.

Include the following code on the page where the user selects the Write a review link:

You can add same-page submission links to

  • Pages where you are hosting Bazaarvoice content, such as the product display page.
  • Pages where there is no Bazaarvoice content, such as a user's account page.

To add submission links to a page where Bazaarvoice content is hosted:

  1. Add the appropriate submission link code.

  2. Insert the following JavaScript code on any page where you want to trigger the review submission form:

    To trigger the v2 review submission form, use Bv.ui instead of the $Bv.ui calls.

  3. Insert the following HTML code to load the submission form.

    • Required HTML code for this feature (recommended):
    • The data-bv-show attribute instructs the BV loader to load an inpage submission form.
    • The data-bv-product-id attribute instructs the BV loader to display the feature for a specified product ID. This product ID must match the ExternalId provided in the product catalog.
    • The data-bv-campaign-id attribute instructs the BV loader to add the required campaign ID to help track the submission flow.

To add links to a page where Bazaarvoice content is not hosted:

  1. Add the appropriate submission link code.

  2. Insert the following JavaScript code on the page, replacing <client_name>, <site_ID>, and locale with your values.

    • Use the following code for the staging environment (the staging environment is for testing and development and is typically only visible internally. Ensure each Bazaarvoice URL referenced in the code contains in the domain).
      <script type="text/javascript" src="https://display.ugc.bazaarvoice.com/bvstaging/static/<client_name>/<site_ID>/<locale>/bvapi.js"></script>
      
    • Use the following code for the production environment. The production environment is visible externally. Content in the production environment is visible on your live website.
      <script type="text/javascript" src="https://display.ugc.bazaarvoice.com/static/<client_name>/<site_ID>/<locale>/bvapi.js"></script>
      

Data injection

You can pre-populate ("inject") data for some fields on submission forms. Data injection uses a shared key plus hashing to validate the population of data, such as email addresses.

You might want to pre-populate data for the following reasons:

  • Help customers complete submissions more quickly. You can provide information you know about your customers—such as name, gender, age, or location—to make form completion faster and easier.
  • By eliminating the need for users to enter repetitive details, you encourage a higher rate of reviews.
  • Provide data for reporting and analytics. You can tie reviews to specific data that exists in your CRM, such as an order ID. This information isn't visible to your customers.

Note
Contact Bazaarvoice Support  to enable data injection for your implementation if you haven't already done so.

Multi-product submission forms

A multi-product submission form enables you to collect multiple reviews from a single review request. Designed with mobile users in mind, multi-product submission forms encourage customers to leave multiple reviews by displaying all of their purchases on one page.

Multi-product submission forms also minimize form abandonment rates by following a simple, progressive submission flow. This means that the responses to the submission form questions are captured as the customer moves from one question to the next.

The multi-product submission form displays a list of recently purchased products. The customer can tap on a product to rate, review, and submit the form. Then they are returned to the form's first page to complete the same actions with the rest of the products if they choose to.

Note
Contact your Bazaarvoice implementation team to enable the multi-product submission form feature.

Refer to the following topics for more information:

Enable multi-product submission forms for Bazaarvoice-hosted review requests

Complete the following steps to enable and configure multi-product submission forms for Bazaarvoice-hosted review requests:

  1. Sign in to the Bazaarvoice PortalExternal link icon.
  2. From the upper-right corner, select the settings icon settings icon.
  3. Select Configuration.
  4. Under Implementations, select Edit next to the implementation for which you want to configure submission forms.
  5. From the menu on the left side of the page, select Display Options under User Experience.
  6. Select the Ratings & Reviews tab.
  7. Go to the Multi-Product Submission (Standard and Custom review request email templates) section at the bottom of the page. Turn on the toggle switch on the right side of the section to enable multi-product submission forms.
    Note
    This toggle switch only enables multi-product submission forms for standard and custom review request email template types. In-mail template types always use a multi-product submission form.

  8. Select when you want your review request to link to a multi-product submission form instead of the default single-product submission form. Choose from the following options:
    • For all transactions—All review requests will direct your customers to the multi-product submission form, whether they purchased one or multiple products.
    • Only for transactions with multiple products—If the customer purchases more than one product, they will receive a review request link to a multi-product submission form. Purchases of a single product will trigger your default single-product submission form.
    • Never only use single-product submission form—review requests for all transactions will link to your default single-product submission form configured with the submission form editor.
  9. (Optional) Go to Require Review Text & Title (Multi-Product Submission Form) in the Review Submission section. Select Enabled to require contributors to enter review text and a title to submit reviews when using a multi-product submission form. Enabling this setting prevents the submission of ratings-only reviews in the multi-product submission form. We also recommend you upload a company logo to display on the multi-product submission (MPS) form. If you're sending your review request or using a custom email template, then you may not have a company logo loaded into our system.
Note
Refer to Edit standard email templates for guidelines and instructions (Step 4) on how to add your company logo.
Tip
If sending your own review request, see Create a multi-product ssURL for information about creating your submission form link that leads to a multi-product submission form.

Create a multi-product ssURL

Refer to Create a multi-product ssURLExternal link icon for instructions.

Content Display Style Guide Tip
Tip
Refer to the Content Display Style Guide for information on how to style features using the Style Editor. This guide maps the Style Editor menu options to the various display components.

Product limitations in submission links are implemented to enhance the consumer experience and prevent link failures. The submission link for RRE is limited to 25 products, while the RRR has a limit of 40 products.

How are products shortlisted?

The algorithm for shortlisting products begins by selecting the most expensive product, followed by the one with the fewest reviews. It then continues with the second most expensive product and the second least-reviewed product, repeating this process until the above mentioned limit is reached. The products that are not selected will not appear on the review submission page.

Adding or customizing submission form questions

Use the configuration to configure your single-product or multi-product submission form questions.

Note
To streamline the submission process, you can configure data injection and simple submission URLs. 

Using the submission form editor

Submission form questions enable you to collect valuable information from your customers that you can use for business purposes. The questions prompt customers to provide information about themselves and their sentiments about your products or service.

For example, authentic user sentiment and quotes about your products or services (directly from your customers), can be used in marketing campaigns and are invaluable in reviews.

Answers to submission form questions contextualize the review and enable consumers to make informed buying decisions. For example, a contributor might write a negative review about an item of clothing saying it doesn't fit well, but answers the Body Type question on the submission form. A potential customer reading the review (someone with a different body type) may ignore this negative review.

Watch this short video about using the submission form editor:

Customize a submission form

Watch this short video to see how you can configure submission form questions:

Follow these steps to configure a submission form:

  1. Before beginning, consider the types of questions available and how you want to design your form. Refer to Submission form questions, categories and fields to read about and determine the category of questions you want to configure.
  2. Sign in to the PortalExternal link icon.
  3. From the upper-right corner, select the settings icon settings icon.
  4. Select Configuration.
  5. Under Implementations, select Edit next to the implementation for which you want to configure submission forms.
  6. From the menu on the left side of the page, select Submission Form Editor under User Experience.
    Note
    You will also need to configure some sections outside the submission form editor. Locate this content by hovering over a grayed-out section and opening the link provided in the tooltip.

  7. Select Folder icon located in the upper-left corner of the page to find the product category name or ID of the submission form you want to modify. The editor automatically displays the All Products submission form. If you add, edit, or delete questions in this particular form, the editor applies your changes to all linked forms.
    Note
    The path to the selected category displays at the top of the editor beside Editing questions for:. If you select Folder icon again, the word "Selected" appears on the right side of the newly selected category.
  8. If applicable, select the locale you want to edit from the drop-down list.
  9. To add a new question to the form, select + New Question beside the category of question you want to add. A list of predefined questions for that category displays.
  10. To add a predefined question, select Add This Question. You can edit the question name, display label, submission form label, possible answer values, and global question settings before saving. If you operate in multiple locales, you can also edit values for each locale. To add a custom question, select Add a Custom Question. You can select a question type and enter a question name, question ID, display label, submission form label, and possible answer values. Set global question settings. The following table shows valid values for question type depending on the question category.
    Question Category Valid Question Types
    People questions Single Select, Free Text
    Ratings questions Ratings, Slider
    Product questions Single Select, Multiselect Groups, Free Text
    Select Save and Add to form, or select Delete icon in the upper-right corner to return to the editor without saving.
    Note
    The Single Select question type renders as a button on a mobile device.
  11. Select Configure icon to modify an existing question. If the question appears in multiple categories, any edits will update the question in all categories where it appears.
  12. If you need to delete a question from the form, select Delete icon. If you delete a question from the All Products form, the editor removes the question from all linked forms.
  13. If you need to change the default order of questions on the form, select Reorder icon> Move this section next to a question category to move an entire section of questions. Select the section you want to move and drag it to the preferred location on the submission form.
    Note
    The Base Review Questions, Basic User Info, and Net Promoter Question sections are locked and can't be moved.
    You can also reorder questions within a question category. Select Reorder icon > Reorder questions in this section. Select the question you want to move and drag it to the preferred location.
  14. If you added or modified a product question for a subcategory (chosen in step 5), this severs inheritance from the parent category. (Submission forms for product subcategories inherit questions from parent categories.) No Inheritance button displays at the top of the submission form editor and next to the category in the product categories list. To revert the category to its original state and restore the link to the parent category, select No inheritance button. All of the changes made to the parent category while the child category was severed now appear in the child.

Submission form question categories and fields

This section describes the available question categories and explains the elements you can configure for each question.

Watch this short video to see an overview of the submission form question categories:

Question categories

Submission form questions are grouped into the following categories:

  • Ratings—Optional secondary ratings relating to specific attributes (aka rating dimensions) of the product or service, such as the cleanliness or food quality at a restaurant.

    Answers to these questions can help consumers determine if a specific aspect of a product or service meets their needs. You can customize the customer-facing labels for rating dimensions for your specific business.

  • People—Provide additional information about the contributor, such as age and gender. Answers to these questions help consumers identify with the person who wrote the review. People questions should map to consumer segments important to your business. For example, a cosmetics company might want to ask reviewers to identify their skin type.

    You can customize the language of the questions to suit your business, and you can omit any recommended options. However, to benchmark this data accurately against other Bazaarvoice clients, you must use the default answer ranges. These can be powerful tools if you make these questions filterable by other users.

    Note
    Ratings & Reviews Collect-Distribute supports COPPA. Refer to the COPPA support statement  for more information.
  • Products—Enable contributors to provide insight into specific issues about a product (such as clothing fit, durability, or appearance) and how they use the product (level of expertise or usage frequency).

    Answers to these questions help consumers learn more about the contributor and provide context for their experience with the product or service.

    • For example, if a person is shopping for a new camera to take family photos, and she sees a few low ratings from reviewers who are professional photographers, she can probably assume their concerns will not impact her satisfaction with the camera.

    • Use product questions instead of ratings questions when a specific attribute is best described on a two-option scale instead of a relative, value-based scale of 1-5 or a value-neutral scale. For example, you can collect information about product appearance using a product question ("How does your purchase fit?") with response values like "Runs narrow" and "Runs wide".

    • Or you can use a rating question ("How would you rate the appearance of the product?") with response values of 1-5.

    • Product questions provide more context than ratings questions. Answers to ratings questions don't provide consumers as much useful information as answers to product questions, especially if the contributor rates the product without writing a text review that provides context.

      Note
      Be aware that submission forms for product subcategories inherit questions from parent categories. Changes made to the submission form for a parent category are inherited by child categories.

      For example, if you define a submission form for apparel, submission forms displayed for product subcategories in apparel (such as dresses or shirts) inherit questions from the main apparel submission form. By default, a change to a subcategory product's submission form severs the inheritance from its parent category.

Question fields

The following image shows the window in which you configure a new question or edit an existing question.

Configure question

Question Type—(all questions) Types of responses a reviewer can make for a given question.

  • Single Select—(people and product questions) Contributors respond with only one answer from the list of values you provide.

    Note
    The Single Select question type renders as a button on a mobile device.
  • V2 only Display As—(people and product questions) Enables you to display the following question types:
    • Single Tag—Enables consumers to select one value from the listed tags. 
    • Dropdown—Enables consumers to select an option from the drop-down menu. 
  • Ratings—(ratings questions) Contributors express sentiment about one aspect of the product or service on a five-point scale.

  • Slider—(ratings questions) Contributors rate a product or service on a continuum instead of by numeric rank. They supplement overall ratings by providing a richer rating level for a product. Sliders can reduce returns by 5 to 15 percent.

    The following image shows a slider similar to what you would find on a submission form or published review.

    Slider

    Examples of industries that benefit greatly from having sliders include apparel, shoes/footwear, cosmetics, sports and outdoors stores, and department stores. Sliders enable product reviews to have descriptions such as "Runs narrow," "Fits correctly," or "Runs wide."

  • Multiselect groups—(product questions) Contributors tag a product or service with descriptors you provide, and multiselect group enables contributors to add commonly expressed opinions or information to their reviews. Consumers can derive useful information from the tags quickly. For example, if your product is a digital camera, you could add the tag category "Digital Camera Pros" and provide tags like "Long battery life," "Compact," and "Included lens."

  • Free text—(product questions) Reviewers write comments about a product or service.

Question Name—(all questions) Descriptive, unique name for internal use that helps you identify the question in the questions list during configuration.

Question ID—(all questions) The ID of the question for data injection, syndication, and reporting. This ID should not contain any special characters or spaces.

Display Label—(all questions) Text displayed on the published review that prefaces the response value the contributor provided.

Submission Form Label—(all questions) Request for information from the contributor. The Submission Label text displays on the review submission form.

Possible Answer Values—(people, slider, and product questions) Options contributors select when responding to the submission form question. To edit existing values for default questions, select inside the value box to make it editable. To add more values, select Add new value.

Note
For ratings questions, values fields are available for the slider question type but not the ratings question type.

Left Label—(slider questions only) Leftmost label on a slider.

Right Label—(slider questions only) Rightmost label on a slider.

Global question settings

Watch this short video to see an overview of the global question settings:

The following global question settings are available. During onboarding, these settings are configured as best practices.

  • Required—(all questions) Requires contributors to respond to the question.

    Note
    Don't select this option if you use data injection to populate the answer.

  • Hide in display—(all questions) Prevents the answer to this question from displaying on the published review.
  • Filterable—(people questions) Enables consumers to filter reviews based on the Values you set.
  • Hide on submission—(people and product questions) Prevents the answer to this question from displaying on the submission form. Answers to these questions are populated using data injection.
  • Auto-populate—(people questions only) Automatically populates the submission form fields if the contributor previously provided the same information on your website. Deselect Required if you select the Auto-populate option. Contact your Bazaarvoice Implementation Engineer if you want to enable this option.
  • Subject ID required—(people and product questions) Requires the subject ID for a product to be injected into the review submission.