Skip to main content
The agent public profile is the public, indexable reputation page for one agent: headshot, bio, service areas, aggregate rating, published testimonials, and a referral CTA. The profile follows a draft/published lifecycle: edits land in a draft first, and the live page does not change until you click Publish.

​
Setting up your profile

Go to Marketing → Reputation → Profile. The page is divided into focused cards:

​
Profile lifecycle

Editing the profile updates draftConfig. The live page does not change until you click Publish profile (or Update live profile if already published).

​
How to publish your profile

  1. Go to Marketing → Reputation → Profile.
  2. Fill in your Profile identity (handle and display name) and any other cards you want to configure.
  3. In the Publish & share card, click Publish profile.
Winnerr validates the saved draftConfig against the approved-block schema, copies it into publishedConfig, flips the status to PUBLISHED, and stamps publishedAt. If there is an issue with the draft config, the publish call returns a validation error describing what to fix. You can also publish via the API:
If the body is omitted, the call defaults to the caller’s own profile. Once published, the Publish & share card shows your public link and two buttons:
  • Copy — copies the URL to your clipboard.
  • View — opens your live profile in a new tab.
The public URL follows the pattern:
You can share this link in email signatures, business cards, and social profiles. It is the same URL that appears in your reputation profile email surveys’ “leave a review” flows.

​
Slug, custom domain, and branding

Each AgentPublicProfile carries: The Brand Kit is shared with the marketing surface, so updating colors or compliance footer once propagates everywhere the agent’s brand renders.

​
What renders on the profile

Once published, the profile assembles:
  • Hero — headshot, display name, headline, brokerage info, aggregate rating.
  • Aggregate stats — total reviews, average rating, response rate.
  • Testimonials — the agent’s PUBLISHED + PUBLIC testimonials, ordered by sortOrder then approvedAt. Up to 50 testimonials are shown.
  • Service areas and specialties — rendered as chips below the hero.
  • Bio — plain-text paragraphs (no raw HTML injection).
  • Referral CTA — a form that posts to the public referral endpoint.
Permission flags on each testimonial are honored automatically: a testimonial without permissionUsePhoto simply omits the photo; one without permissionUseName falls back to authorDisplayName (“Jane D.”).

​
Embeddable reviews widget

The same approved testimonials and reputation aggregate that power the profile can also be embedded on your own website. Widgets are created and managed separately under Reputation → Widgets — see Reviews widget for the full guide including the one-line embed snippet, layout options, and the per-site origin allowlist.

​
Reviews on your Winnerr site

If you build a site in Growth Studio, you can add the agentReviews block to any page to display your published reviews with star-rating structured data (Schema.org RealEstateAgent + AggregateRating). See Reviews on your Winnerr site.

​
Reputation aggregate

The ReputationAggregate is the denormalized rollup that powers the profile, widget, broker dashboards, and lead routing. It is computed at agent scope (one row per agent) and optionally at org scope (scope: ORG, agentUserId: null) for org-wide rollups. Read it via the authenticated API:
Aggregates recompute automatically when a testimonial is published or unpublished.

​
Review experience and syndication keys

The Review experience and Syndication keys settings are on the same Profile page. See:
  • Review request setup — sentiment style, review gating mode (Compliant vs. Strict), Yelp, and custom platforms.
  • Review syndication — Google Place ID, Facebook Page URL, and Google Business Profile import.