Community Q&A Widgets

Emplifi Ratings & Reviews Community Q&A widgets includes the Instant Answers widget and the Q&A List widget, which combine to enable your customers to sort through existing knowledge quickly, ask new questions, and find accurate answers.

Installing Community Q&A widgets

Steps:

Place the following code into the <head> of your page:

This turnToConfig snippet controls all installed Emplifi Ratings & Reviews widgets. It should be placed only once.

CODE

<script>
  var turnToConfig = {
    sku:"YOUR SKU",
    locale: "en_US",
    pageId: "pdp-page",
    qa: {
      // onFinish: function(){}
  }
};
  window.TurnToCmd=window.TurnToCmd||function(){(TurnToCmd.q=TurnToCmd.q||[]).push(arguments)};
</script>
<script src="https://widgets.turnto.com/v5/widgets/YOUR SITE KEY/js/turnto.js" async></script>

If you are a TurnTo.eu customer, change turnto.com to turnto.eu in this snippet.

Replace YOUR SKU and YOUR SITE KEY with the appropriate values.
To display the Instant Answers widget, add this div element. The widget dynamically inserts content into the element.
CODE
```
<div id="tt-instant-answers-widget"></div>
```
To display the Q&A List widget, add this div element. The widget dynamically inserts content into the element.
Most customers choose to display the Q&A List widget directly below the Instant Answers widget.
CODE
```
<div id="tt-qa-list"></div>
```

Widget refresh function

Some Product Detail Pages (PDPs) are architected in a way that makes it possible to switch product SKUs without reloading the page. For these pages, the TurnToCmd 'set' function can be used re-initialize the Emplifi content / components given the new SKU context.

CODE

TurnToCmd('set', {sku:"newsku"});

Conversion tracking

Instant Answers and Q&A List widgets are not currently reported in Emplifi conversion reporting.

Widget display options

To learn more about design options for these widgets, please review our SpeedFlex Theming Guide.

Instant Answers widget

The Instant Answers widget allows shoppers to ask a question and see relevant Q&A, reviews, and/or knowledge base article results instantly. If no results answer their question, the shopper can easily submit a new question of up to 2,000 characters. The Instant Answers widget shows the following elements:

Call to Action ('Have a question? Ask owners.')
Instant Answers input field
Hint text and 'Learn more' link
Search results

Clicking the 'Learn more' link shows in place a fully-customizable set of guidelines for using the Instant Answers widget. Emplifi strongly recommends that you customize this text to provide clear content guidelines and customer support contact information.

Search results

The Instant Answer search mechanism shows relevant existing content in real time, ensuring that you aren't collecting duplicate questions that have already been answered by a previous question or a relevant knowledge base article.

When a shopper starts typing in the Emplifi Instant Answers search box, our search mechanism begins looking for matching questions and knowledge base articles. As the shopper continues typing, the widget updates and refines the results to provide the best match. Results display in order of relevance.

The search queries all content from the page's Q&A List widget. You can configure each list widget to only display direct content or to include related content for the product SKU. This related product configuration affects whether the search results only show direct content or include related content.

Related content that is configured to display separately in a '...for Similar Products' section is not included in Instant Answers search results. To help shoppers find answers, if a question has zero answers we exclude it from the search results.

Learn more about integrating relevant articles from your store and knowledge base into the Instant Answers widget in the Knowledge Base File article.

Advanced configuration options

These optional settings are not managed within the Emplifi installation code. Contact Emplifi Support to enable, disable, or adjust these settings.

Option	Default Setting	Description
variant div IDs	tt-instant-answers-widget	If there are issues with the default div IDs detailed above, you can customize them to any string that will work with your system.
text changes	<see widget images above for default text>	Virtually all text within the widgets can be customized. Emplifi does not translate custom text. You are responsible for all custom text that needs to be localized for other languages.
disable multi-item questions	false	Multi-item questions allow shoppers to ask a question about more than one SKU in your product catalog. This setting allows you to disable this feature. Inactive items are not included in the search results of multi-item questions.
disable attach items to answers	false	This feature disables the ability for shoppers to attach items from your product catalog to their answer.
instructional copy enabled	true	Allows clients to not display the 'Learn more' link and Instant Answers guidelines
instant answers results pagination	5	How many Instant Answers search results to display per page

If you have any questions, or to make other changes to your widgets, please contact Emplifi Support.

Q&A List widget

The Q&A List widget displays a list of shopper questions and answers for a product. Most customers choose to place the Q&A List widget directly below the Instant Answers widget. Questions, answers, and replies have a 2,000-character limit.

The Q&A List widget shows the following elements:

Total question count ('# questions')
Sort / Filter - only displays if there are 3 or more questions for a SKU. Allows sorting of questions by most recent, oldest, most common, most answers, and fewest answers.
Question List - all published questions and associated answers and replies for this product
Pagination

No question display

The Q&A List widget does not display when there are no questions.

Multiple answers per question

For questions with multiple answers, this is how Emplifi sorts answers:

Show staff answers first
- Depends on the Show staff answers first option in Emplifi Portal > Q&A Settings
Sort by votes, highest first
- For tie votes, show the longest answer first
Sort by date

Advanced configuration options

These optional settings are not managed within the Emplifi installation code. Contact Emplifi Support to enable, disable, or adjust these settings.

Option	Default Setting	Description
variant div IDs	tt-qa-list	If there are issues with the default div IDs detailed above, you can customize them to any string that will work with your system.
text changes	<see widget images above for default text>	Virtually all text within the widgets can be customized. Emplifi does not translate custom text. You are responsible for all custom text that needs to be localized for other languages.
set default display order	most common	You can set the default sort for items within the Q&A List. Options: Most common (default) Most answers Fewest answers Most recent question Oldest question
related question display	Separate	If you have selected to include questions about related products, you can set how they display: Separate - questions about related products appear in a 'Questions for similar products' section Included - questions about related products are mixed in with direct questions and appear in one list
show checkout comments in Q&A List	true	By default, Emplifi displays answers to 'Why did you choose this product?' as the first Q&A List item. This setting allows you to disable this feature. If you include questions about related products in the Q&A list, then checkout comments for related products will be included.
hideBestAnswer	false	Only display questions (and not the 'Best Answer') on initial Q&A list view.
show x questions initially	10	The number of questions that will display on initial page load before pagination is displayed for the remaining questions.
show y questions per page	10	The number of questions that will display on each subsequent page for the remaining questions.
show x related questions initially	2	If you have selected to display related questions separately from your main SKU questions, this will load x questions initially.
show y related questions per page	10	If you have selected to display related questions separately from your main SKU questions, the number of questions that will display on each subsequent page for the remaining questions.

If you have any questions, or to make other changes to your widgets, please contact Emplifi Support.