Skip to content
One2Five Developer Portal

Knowledge Hub

  • One2Five Platform Overview
  • Concepts
  • Fundamentals
  • Path of a Review
  • Review Verification
  • Authenticity
  • Badges
  • Best Practices
  • One2Five Shopify App
  • One2Five WooCommerce Plugin
  • Additional Resources

API Reference

  • API Introduction
  • Full API Reference
  • Submission
    • Authentication
    • Submit Review
    • Submit Feedback
    • Submit Review Answer
    • Submit Answer
    • Submit Question
    • Submit PIE-feed
    • Submit PIE-feed-interaction
  • Display
    • Fetch Reviews
    • Get Reviews
    • Get Review Answers
    • Display Reviews HTML
    • Get Review Exists
    • Get Questions
  • Home
  • One2Five developer pages
  • Knowledge Hub
  • Badges

Badges

Badges are visual markers designed to highlight important attributes, achievements, or statuses associated with user-generated reviews on the One2Five platform. These badges serve to enhance the credibility of reviews, build customer trust, and support efficient content moderation. By clearly signaling quality, authenticity, or relevance, badges help users make more informed purchase decisions.

This guide provides a comprehensive overview of the badge system, including the criteria for badge assignment, the various types of badges available, how badges are associated with content, and best practices for their display.

Key Benefits of Review Badges:

Enhance User Experience: Badges draw attention to helpful or insightful reviews, reducing the effort users need to find relevant feedback.

Improve Trustworthiness: Badges validate the authenticity or quality of a review, giving shoppers more confidence in the content.

Support Moderation: They help moderators and algorithms quickly identify reviews that meet specific standards or come from verified sources.

Badge Metadata #

Each badge is defined by a unique template ID and includes several key properties:

PropertyDescription
badge_template_idUnique identifier for the badge template.
badge_nameInternal name of the badge.
badge_typeOptional grouping label (e.g., Affiliation, Custom) for filtering/display.
content_typeType of content the badge can be attached to (e.g., REVIEW, QUESTION).

Available Badges #

Badge NameDescription
EmployeeSubmitted by an employee of the company. May affect neutrality.
AffiliatedReviewSubmitted by a user affiliated with the brand or vendor.
VerifiedPurchaserThe Verified purchaser badge identifies end users who have purchased products from a given client. This provides content authenticity as the person is guaranteed to have actually purchased the product.
SweepstakeReviewSubmitted as part of a sweepstake or giveaway program.
TranslatedReviewThis represents that the review has been translated from another language.
IncentivizedReviewThe reviewer receives a reward or incentive for submitting the review. This includes, but is not limited to, any of the following being provided to the consumer in exchange for writing a review:
1. Coupons or Discounts
2. Loyalty Reward Points
3. Free products, either before as in a Sampling program or after, as a Thank You gift
CompetitionYesReview was submitted for a competition or contest.
StaffContent created by a staff member or company representative.

Badge Application Process #

Badges can be applied to content through 4 main mechanisms:

a. Content Submission-based

Badges are automatically assigned at the time of content submission, based on user actions or metadata (e.g., verified purchases or incentives).

link to review submission api , using review submission api one can submit the badges to the review.

  • Example: A user who submits a review with a respective badge gets assigned to the review.
b. Automated Badging

O2F automatically applies certain badges using internal logic after the content is submitted. These are typically based on content attributes, contributor behavior, or campaign configurations.

One needs to select the brand site for which the badge needs to be assigned, select the campaign under which the reviews should get the selected badge assigned, and the date range between which the review was created.

  • Example: A review part of a competition is tagged with the CompetitionYes badge through backend rules.
c. Manual Badging

Moderators or admin users can assign badges through moderation tools or internal workflows.

We have our review detail page on our platform where users can assign a badge to the review.

  • Example: The Employee badge can be applied using the show review detail user interface.
d. Update Badge

On the One2Five platform, we have a feature that allows users to upload a file containing details and simply upload the file, which will then assign the badges accordingly.

You can download sample dummy data in the required file format from the link below.

badge_update_sample_fileDownload

For opting this type of feature, please get in touch with one2five support.

Badges retrieval #

Badges are retrievable via:

  • Display Frontend (visual on public-facing review pages)
  • Display API (for client-integrated solutions)
  • Data Feeds (e.g., SFTP feeds for downstream systems)

Updated on July 11, 2025
Table of Contents
  • Badge Metadata
  • Available Badges
  • Badge Application Process
  • Badges retrieval