Unsupported E-commerce / Custom Platform: Getting Started

If your store is running on a custom-built or unsupported E-commerce platform, it's possible to integrate Stamped Reviews & UGC using this guide.

There are basically 2 points of integration needed.

In this guide

Adding Review Widget Into Your Store

This is where the reviews submitted by your customers will be shown, and customers will also be able to write the reviews directly in the widget. Installation of this widget is really simple and only requires a script and HTML element to be added.

Add in Header:

<script type="text/javascript" src="https://cdn1.stamped.io/files/widget.min.js"></script>
<script type="text/javascript">//<![CDATA[ 
StampedFn.init({ apiKey: '##publicAPIKey##', storeUrl: '##storeUrl##' }); 
// ]]></script>

Add in Product Page for main review widget: 

<div id="stamped-main-widget" 

Add in Product / Collection page for Reviews badge: 

<span class="stamped-product-reviews-badge stamped-main-badge" data-id="##product.id##"></span>

Note: Replace all variable with your store's and product's info. ##storeUrl## should be without 'http' or '/'

Including Product Rich Snippet

To include product rich snippet, your store needs to have a set of product schema codes present in the site, which can be custom-developed or rendered by an SEO app that provides the codes. Once the product schema is present, please install the following set of codes:


function addEventListenerStamped(el, eventName, handler) {

if (el.addEventListener) { el.addEventListener(eventName, handler); }
else { el.attachEvent('on' + eventName, function () { handler.call(el); }); }


addEventListenerStamped(document, 'stamped:reviews:loaded', function(e) {
var ratingCount = jQueryStamped('meta[itemprop="reviewCount"]').attr('content');
var ratingValue = jQueryStamped('meta[itemprop="ratingValue"]').attr('content');

var richSnippet = {
"@context": "http://schema.org",
"@type": "Product",
"@id": "HTTPS://STORE.COM/URL/#product"

if (parseInt(ratingValue) > 0){
richSnippet.aggregateRating = {
"@type": "AggregateRating",
"ratingValue": ratingValue,
"reviewCount": ratingCount
var script = document.createElement('script');
script.type = 'application/ld+json';
script.innerHTML = JSON.stringify(richSnippet);

You will then need to include the same "@id" field in the product schema code present within the site, to link the two sets of codes together:

"@id": "HTTPS://STORE.COM/URL/#product"

You can make use of Google's tool, such as GSDT to confirm the placement of the codes is correct. You should see the aggregateRating field rendering within the product schema, on product pages which contains reviews:

Pushing Orders Into Stamped

We'll need to know when a new order has been created or fulfilled, so the app can create the review request email to be sent to the customer, and this can be done by pushing order data into Stamped. There are 3 possibilities:

  • Integration with our API (Stamped REST APIs) *Available on Business & Professional plan

    We provide public API endpoints. On an order update/fulfillment event/action, you'll push the order data into the Stamped API and a review request email will be created for the order.


  • Import order details via excel file (Sample excel file) *Available on all paid plans
    Alternatively, if API integration is difficult with your platform, you can create review requests for the orders by importing a formatted excel file with the order data. This can be done periodically e.g. daily or every end of the week.


  • Utilize our Integration with Zapier (Zapier + Stamped - Using Stamped As Action For Review Request) *Available on Premium, Business & Professional plan
    You can push order data into Stamped via our Zapier "Actions" integration