Explore
★ 4.6 (513 reviews) · View on G2 ↗
Download complete package · Installation files (JSON)
1 instructions file · 3 supporting files · installs together
Version 1.0, 30 Oct 2026.
Turn a customer's last 12 months on G2 into a mobile and desktop click-through story. Customer-facing title: "[Company]’s year in reviews". Do not use the word "Wrapped" on the page. Every customer gets the same slides in the same order, built only from G2's full-set aggregate counts. No review is ever paged through, so a customer with 20 reviews and one with 20,000 take the same time, and every number is exact.
Intro: customer logo and "[Company]’s year in reviews", with no subtitle
Review count, with a fun line
Segment: "Most reviews came from" (only when the top segment is over 50%, otherwise "The biggest share of reviews came from"), a segment emoji (🏪 Small Business, 🏢 Mid-Market, 🏙️ Enterprise) and a fun line
Top reviewer country with that country's flag emoji, plus a "countries reached" line when reviewers span 5 or more countries
Share of reviewers who scored 9/10 or higher, with 🎉 and a fun line. It appears only when more than 50% of reviews are in the 5-star bucket; otherwise the slide is left out entirely, with no placeholder
Review excerpt under the label "Feedback isn’t just about the numbers", chosen by the user (omitted if they do not choose)
All-time rating on G2, labelled all-time so it is not mistaken for the 12-month figure, with a row of five ⭐ emoji above it (the last star is partly filled for the decimal, so 4.7 shows four full stars and a 70% star) A G2 mark sits in the top right of every slide except the last, always the same size (about 27 px on a phone, the same height as the small customer logo on content slides) and much smaller than the customer logo on the intro. The final slide has the full lockup instead.
Final lockup: handshake emoji, "Here’s to another great year together", customer logo + G2 mark, and the source line pinned near the bottom
There is no 12-month average rating and no metrics scorecard. Both need a number from every review, which is slow on big accounts and would make customers inconsistent. Do not add them back unless the user asks.
Find the product. list_products with filter_product_name_cont, fields="name,slug,review_count,g2_url". If the vendor has several products (for example a vendor with a CRM, a service desk and a core product), take the flagship and tell the user which, or ask if it is unclear.
list_products
filter_product_name_cont
fields="name,slug,review_count,g2_url"
One aggregate call. list_standard_product_reviews with product_id=<slug>, fields="star_rating", filter_updated_at_gt=<today minus 12 months, RFC3339>, page_size=1. Everything below comes from meta, which covers the full filtered set, not just the one row returned.
list_standard_product_reviews
product_id=<slug>
fields="star_rating"
filter_updated_at_gt=<today minus 12 months, RFC3339>
page_size=1
meta
nps_score
meta.record_count
5 star
company_segment
country
region
meta.products[0].star_rating
review_count
meta.products[0].image_url
image_url
build.py
{"aruba":"AW","afghanistan":"AF","islamic republic of afghanistan":"AF","angola":"AO","republic of angola":"AO","anguilla":"AI","aland islands":"AX","albania":"AL","republic of albania":"AL","andorra":"AD","principality of andorra":"AD","united arab emirates":"AE","argentina":"AR","argentine republic":"AR","armenia":"AM","republic of armenia":"AM","american samoa":"AS","antarctica":"AQ","french southern territories":"TF","antigua and barbuda":"AG","australia":"AU","austria":"AT","republic of austria":"AT","azerbaijan":"AZ","republic of azerbaijan":"AZ","burundi":"BI","republic of burundi":"BI","belgium":"BE","kingdom of belgium":"BE","benin":"BJ","republic of benin":"BJ","bonaire, sint eustatius and saba":"BQ","burkina faso":"BF","bangladesh":"BD","people's republic of bangladesh":"BD","bulgaria":"BG","republic of bulgaria":"BG","bahrain":"BH","kingdom of bahrain":"BH","bahamas":"BS","commonwealth of the bahamas":"BS","bosnia and herzegovina":"BA","republic of bosnia and herzegovina":"BA","saint barthelemy":"BL","belarus":"BY","republic of belarus":"BY","belize":"BZ","bermuda":"BM","bolivia, plurinational state of":"BO","plurinational state of bolivia":"BO","bolivia":"BO","brazil":"BR","federative republic of brazil":"BR","barbados":"BB","brunei darussalam":"BN","bhutan":"BT","kingdom of bhutan":"BT","bouvet island":"BV","botswana":"BW","republic of botswana":"BW","central african republic":"CF","canada":"CA","cocos (keeling) islands":"CC","switzerland":"CH","swiss confederation":"CH","chile":"CL","republic of chile":"CL","china":"CN","people's republic of china":"CN","cote d'ivoire":"CI","republic of cote d'ivoire":"CI","cameroon":"CM","republic of cameroon":"CM","congo, the democratic republic of the":"CD","congo":"CG","republic of the congo":"CG","cook islands":"CK","colombia":"CO","republic of colombia":"CO","comoros":"KM","union of the comoros":"KM","cabo verde":"CV","republic of cabo verde":"CV","costa rica":"CR","republic of costa rica":"CR","cuba":"CU","republic of cuba":"CU","curacao":"CW","christmas island":"CX","cayman islands":"KY","cyprus":"CY","republic of cyprus":"CY","czechia":"CZ","czech republic":"CZ","germany":"DE","federal republic of germany":"DE","djibouti":"DJ","republic of djibouti":"DJ","dominica":"DM","commonwealth of dominica":"DM","denmark":"DK","kingdom of denmark":"DK","dominican republic":"DO","algeria":"DZ","people's democratic republic of algeria":"DZ","ecuador":"EC","republic of ecuador":"EC","egypt":"EG","arab republic of egypt":"EG","eritrea":"ER","the state of eritrea":"ER","western sahara":"EH","spain":"ES","kingdom of spain":"ES","estonia":"EE","republic of estonia":"EE","ethiopia":"ET","federal democratic republic of ethiopia":"ET","finland":"FI","republic of finland":"FI","fiji":"FJ","republic of fiji":"FJ","falkland islands (malvinas)":"FK","france":"FR","french republic":"FR","faroe islands":"FO","micronesia, federated states of":"FM","federated states of micronesia":"FM","gabon":"GA","gabonese republic":"GA","united kingdom":"GB","united kingdom of great britain and northern ireland":"GB","georgia":"GE","guernsey":"GG","ghana":"GH","republic of ghana":"GH","gibraltar":"GI","guinea":"GN","republic of guinea":"GN","guadeloupe":"GP","gambia":"GM","republic of the gambia":"GM","guinea-bissau":"GW","republic of guinea-bissau":"GW","equatorial guinea":"GQ","republic of equatorial guinea":"GQ","greece":"GR","hellenic republic":"GR","grenada":"GD","greenland":"GL","guatemala":"GT","republic of guatemala":"GT","french guiana":"GF","guam":"GU","guyana":"GY","republic of guyana":"GY","hong kong":"HK","hong kong special administrative region of china":"HK","heard island and mcdonald islands":"HM","honduras":"HN","republic of honduras":"HN","croatia":"HR","republic of croatia":"HR","haiti":"HT","republic of haiti":"HT","hungary":"HU","indonesia":"ID","republic of indonesia":"ID","isle of man":"IM","india":"IN","republic of india":"IN","british indian ocean territory":"IO","ireland":"IE","iran, islamic republic of":"IR","islamic republic of iran":"IR","iran":"IR","iraq":"IQ","republic of iraq":"IQ","iceland":"IS","republic of iceland":"IS","israel":"IL","state of israel":"IL","italy":"IT","italian republic":"IT","jamaica":"JM","jersey":"JE","jordan":"JO","hashemite kingdom of jordan":"JO","japan":"JP","kazakhstan":"KZ","republic of kazakhstan":"KZ","kenya":"KE","republic of kenya":"KE","kyrgyzstan":"KG","kyrgyz republic":"KG","cambodia":"KH","kingdom of cambodia":"KH","kiribati":"KI","republic of kiribati":"KI","saint kitts and nevis":"KN","korea, republic of":"KR","south korea":"KR","kuwait":"KW","state of kuwait":"KW","lao people's democratic republic":"LA","laos":"LA","lebanon":"LB","lebanese republic":"LB","liberia":"LR","republic of liberia":"LR","libya":"LY","saint lucia":"LC","liechtenstein":"LI","principality of liechtenstein":"LI","sri lanka":"LK","democratic socialist republic of sri lanka":"LK","lesotho":"LS","kingdom of lesotho":"LS","lithuania":"LT","republic of lithuania":"LT","luxembourg":"LU","grand duchy of luxembourg":"LU","latvia":"LV","republic of latvia":"LV","macao":"MO","macao special administrative region of china":"MO","saint martin (french part)":"MF","morocco":"MA","kingdom of morocco":"MA","monaco":"MC","principality of monaco":"MC","moldova, republic of":"MD","republic of moldova":"MD","moldova":"MD","madagascar":"MG","republic of madagascar":"MG","maldives":"MV","republic of maldives":"MV","mexico":"MX","united mexican states":"MX","marshall islands":"MH","republic of the marshall islands":"MH","north macedonia":"MK","republic of north macedonia":"MK","mali":"ML","republic of mali":"ML","malta":"MT","republic of malta":"MT","myanmar":"MM","republic of myanmar":"MM","montenegro":"ME","mongolia":"MN","northern mariana islands":"MP","commonwealth of the northern mariana islands":"MP","mozambique":"MZ","republic of mozambique":"MZ","mauritania":"MR","islamic republic of mauritania":"MR","montserrat":"MS","martinique":"MQ","mauritius":"MU","republic of mauritius":"MU","malawi":"MW","republic of malawi":"MW","malaysia":"MY","mayotte":"YT","namibia":"NA","republic of namibia":"NA","new caledonia":"NC","niger":"NE","republic of the niger":"NE","norfolk island":"NF","nigeria":"NG","federal republic of nigeria":"NG","nicaragua":"NI","republic of nicaragua":"NI","niue":"NU","netherlands":"NL","kingdom of the netherlands":"NL","norway":"NO","kingdom of norway":"NO","nepal":"NP","federal democratic republic of nepal":"NP","nauru":"NR","republic of nauru":"NR","new zealand":"NZ","oman":"OM","sultanate of oman":"OM","pakistan":"PK","islamic republic of pakistan":"PK","panama":"PA","republic of panama":"PA","pitcairn":"PN","peru":"PE","republic of peru":"PE","philippines":"PH","republic of the philippines":"PH","palau":"PW","republic of palau":"PW","papua new guinea":"PG","independent state of papua new guinea":"PG","poland":"PL","republic of poland":"PL","puerto rico":"PR","korea, democratic people's republic of":"KP","democratic people's republic of korea":"KP","north korea":"KP","portugal":"PT","portuguese republic":"PT","paraguay":"PY","republic of paraguay":"PY","palestine, state of":"PS","the state of palestine":"PS","french polynesia":"PF","qatar":"QA","state of qatar":"QA","reunion":"RE","romania":"RO","russian federation":"RU","rwanda":"RW","rwandese republic":"RW","saudi arabia":"SA","kingdom of saudi arabia":"SA","sudan":"SD","republic of the sudan":"SD","senegal":"SN","republic of senegal":"SN","singapore":"SG","republic of singapore":"SG","south georgia and the south sandwich islands":"GS","saint helena, ascension and tristan da cunha":"SH","svalbard and jan mayen":"SJ","solomon islands":"SB","sierra leone":"SL","republic of sierra leone":"SL","el salvador":"SV","republic of el salvador":"SV","san marino":"SM","republic of san marino":"SM","somalia":"SO","federal republic of somalia":"SO","saint pierre and miquelon":"PM","serbia":"RS","republic of serbia":"RS","south sudan":"SS","republic of south sudan":"SS","sao tome and principe":"ST","democratic republic of sao tome and principe":"ST","suriname":"SR","republic of suriname":"SR","slovakia":"SK","slovak republic":"SK","slovenia":"SI","republic of slovenia":"SI","sweden":"SE","kingdom of sweden":"SE","eswatini":"SZ","kingdom of eswatini":"SZ","sint maarten (dutch part)":"SX","seychelles":"SC","republic of seychelles":"SC","syrian arab republic":"SY","syria":"SY","turks and caicos islands":"TC","chad":"TD","republic of chad":"TD","togo":"TG","togolese republic":"TG","thailand":"TH","kingdom of thailand":"TH","tajikistan":"TJ","republic of tajikistan":"TJ","tokelau":"TK","turkmenistan":"TM","timor-leste":"TL","democratic republic of timor-leste":"TL","tonga":"TO","kingdom of tonga":"TO","trinidad and tobago":"TT","republic of trinidad and tobago":"TT","tunisia":"TN","republic of tunisia":"TN","turkiye":"TR","republic of turkiye":"TR","tuvalu":"TV","taiwan, province of china":"TW","taiwan":"TW","tanzania, united republic of":"TZ","united republic of tanzania":"TZ","tanzania":"TZ","uganda":"UG","republic of uganda":"UG","ukraine":"UA","united states minor outlying islands":"UM","uruguay":"UY","eastern republic of uruguay":"UY","united states":"US","united states of america":"US","uzbekistan":"UZ","republic of uzbekistan":"UZ","holy see (vatican city state)":"VA","saint vincent and the grenadines":"VC","venezuela, bolivarian republic of":"VE","bolivarian republic of venezuela":"VE","venezuela":"VE","virgin islands, british":"VG","british virgin islands":"VG","virgin islands, u.s.":"VI","virgin islands of the united states":"VI","viet nam":"VN","socialist republic of viet nam":"VN","vietnam":"VN","vanuatu":"VU","republic of vanuatu":"VU","wallis and futuna":"WF","samoa":"WS","independent state of samoa":"WS","yemen":"YE","republic of yemen":"YE","south africa":"ZA","republic of south africa":"ZA","zambia":"ZM","republic of zambia":"ZM","zimbabwe":"ZW","republic of zimbabwe":"ZW","russia":"RU","korea, south":"KR","turkey":"TR","macau":"MO","brunei":"BN","palestine":"PS","cape verde":"CV","ivory coast":"CI","macedonia":"MK","kosovo":"XK","uae":"AE","usa":"US","uk":"GB","the netherlands":"NL","democratic republic of the congo":"CD","swaziland":"SZ","burma":"MM"}
.stage{ container-type:size;position:relative;width:100%;height:100%;max-width:460px;overflow:hidden; background:var(--brand);color:var(--on-brand); transition:background-color .45s ease,color .45s ease;
#!/usr/bin/env python3 """Build a customer year in reviews page from a small data.json.
Usage: python3 build.py data.json out.html [--logo path_or_url] [--primary "#RRGGBB"]
The logo defaults to data["logo_url"] (G2's image_url for the product). The brand colour defaults to data["brand"]["primary"], then to the logo's dominant colour. Everything is embedded, so the output is one self-contained HTML file. """ import argparse, base64, colorsys, io, json, sys, unicodedata, urllib.request from collections import Counter from pathlib import Path from PIL import Image
HERE = Path(file).resolve().parent TEMPLATE = HERE.parent / "assets" / "template.html"
def norm(s): return unicodedata.normalize("NFKD", s).encode("ascii", "ignore").decode().lower().strip()
def flag_for(name): table = json.loads((HERE.parent / "assets" / "countries.json").read_text()) code = table.get(norm(name)) return "".join(chr(0x1F1E6 + ord(c) - 65) for c in code) if code and len(code) == 2 else ""
SEG_EMOJI = {"small business": "🏪", "mid-market": "🏢", "enterprise": "🏙️"}
def h2r(h): h = h.lstrip("#") return tuple(int(h[i:i + 2], 16) for i in (0, 2, 4))
def r2h(rgb): return "#%02x%02x%02x" % tuple(max(0, min(255, round(c))) for c in rgb)