Integrating Schema App and GatherUp Reviews

About Schema Markup

How do I achieve a rich result for Aggregate Ratings? This is one of the most frequent questions we receive from our customers, to which the answer is… Schema Markup! To follow guidelines for Schema Markup, you must include the elements being marked up on the page. In the case of Aggregate Ratings, this will require a visible Star Rating to be displayed for the Aggregate Rating with the rating value and review count or rating count. Thus you will likely need some embedded application to collect, aggregate and display the individual ratings.

There are numerous review applications that will collect and display Aggregate Ratings. One such application is GatherUp (formerly GetFiveStars). Recently our team at Schema App worked with our friends at GatherUp to come up with a way to integrate Schema App with GatherUp and add Aggregate Rating schema markup into the schema markup generated within Schema App to be eligible for rich results. 

GatherUp (; They make customer experience the backbone of your business through reviews and customer feedback. GatherUp is a customer experience and online review engine that enables insights, empowers marketing and converts customers. Gather customer feedback and reviews into one place to drive sales up for your business.

Today we’ll go through how to change the @id within Schema App to merge the schema markup provided by Schema App with the default markup in GatherUp. Within Schema App, we created the following FinancialService data item. To keep it more condense, I’ve removed a number of properties within the markup.

   "name":"Hanley Mortgage Group",
   "alternateName":"Hanley & Team",
   "description":"Great mortgages made simple. Oriana Financial is a boutique Mortgage Brokerage. Through our elite team of mortgage brokers and agents we have many years of experience, knowledge and expertise in the Mortgage and Financial Industry. Our ultimate goal is to ensure that we obtain the best mortgage strategy available that fits your life, while maintaining our fast, professional and courteous personal service.",

GatherUp generates the following similar markup related to the FinancialService and it’s connected AggregateRating:

   "name":"Hanley Mortgage Group",
   } }

Once these two have been merged the schema markup from each should be reflected in Google’s Structured Data Testing Tool or the Schema Markup Validator:

Google's Structured Data Testing Tool

Again, this has been condensed for this post, however the full result can be seen here.

To achieve this on your site, you will need to go into Schema App and determine the Schema Class of the data item where you would like to integrate the aggregate rating and review information. Once you’ve determined which data item the aggregate rating should be encompassed under you will need to see if the data item has already been created.

If you are just creating the markup, you will need to set the URI where the data item should deploy to and then append the following hashtag identifier: #company

identifier: #company

In our example, the Hanley Mortgage FinancialService data item would have it’s URI set to

If you have already created the data item, you will simply need to change the URI by opening the data item in the editor and clicking actions, then change URI. From here, you will be prompted with a similar dialog box to the example above and will need to append #company to the end of the page url.

append #company to the end of the page url

Once this change has been deployed to the page, you can view the result in the Structured Data Testing Tool or the Schema Markup Validator. When reviewing the data item, you should see one data item with the @id set to the base url and the appended hashtag #company at the end. When opening the details, the properties should include both the structured data from Schema App and the aggregate rating from GatherUp. Given the aggregate rating would be eligible for a rich result, we would also expect that Google shows a preview button in the Structured Data Testing Tool or the Schema Markup Validator, similar to the following:

Google shows a preview button in the Structured Data Testing Tool or the Schema Markup Validator

And that’s it. You’re done! Now you can sit back and enjoy more coffee, while your users find you and your star rated content easily in search results!

Hanley Mortgage Group Rich Result

For more information and another use case on this Additive technique, check out our blog post, “Additive Data Local Inventory Advertising

Taylor Laporte

Taylor Laporte is a former Customer Success Manager for Schema App, as well as a content contributor for the Schema App Blog.