Skip to main content

Publishing guidelines

What belongs on a public portfolio or lot passport

A BeanGrader portfolio and a lot passport are public pages. Anyone with the link, including a buyer who has never heard of you, can read them. These rules exist so that what a reader finds there is a grading record and not a marketing claim, because the moment the two are indistinguishable the record stops being worth anything to either of you.

Last updated 9 August 2026

The sample has to be the lot

Publish a grading of a sample drawn from the lot you are describing. Grading a hand-picked handful, or the best of three trays, and attaching it to a container is the one thing that makes every other record on the platform less credible.

  • Draw the sample the way you would for a physical grading, then photograph that sample
  • One passport describes one lot; do not reuse a passport across shipments
  • If the lot is blended or reprocessed after grading, publish a new reading

Lot identity must be accurate

Farm, region, altitude, variety, process and harvest are read as facts by whoever opens the page. State what you know and leave blank what you do not; an empty field costs you nothing and an invented one costs you the buyer.

  • Do not name a farm, cooperative or region the coffee did not come from
  • Do not state a certification (organic, fair trade, or any other) you do not hold
  • Where a lot is a blend of several producers, say so rather than naming one

Do not present our result as certification

BeanGrader produces indicative pre-screening aligned with SCA green arabica methodology. It is not official SCA certification, it is not a Q Grader's opinion, and a passport must not be captioned as either.

  • Do not describe a BeanGrader grade as SCA certified, Q graded or officially graded
  • Do not imply endorsement or affiliation by the Specialty Coffee Association or the Coffee Quality Institute
  • Do not remove or obscure the disclaimer that we render on every public page

Publish the readings you get, not the ones you like

You choose which analyses to publish, and that is fine: a portfolio is a portfolio. What is not fine is regrading one sample repeatedly and publishing the flattering run as though it were the reading.

  • Do not photograph the same tray repeatedly and publish only the best result
  • Do not edit, retouch or crop a sample photograph before submitting it
  • Where you have republished a lot after reprocessing, keep the earlier record visible

Names, photographs and contact details

Public pages carry a producer or exporter identity. Keep to information you have the right to publish.

  • Publish only your own business identity, logo and photographs, or ones you are licensed to use
  • Do not include named individuals, including workers, without their agreement
  • Do not publish a third party's contact details, prices or contract terms

Nothing unlawful, and nothing that endangers anyone

The obvious floor, stated so it is not ambiguous. Public pages must not carry unlawful content, harassment, or material that identifies people in ways that could put them at risk.

  • No unlawful, deceptive or fraudulent content of any kind
  • No content that harasses, threatens or targets an individual or a group
  • No claims about health, safety or food safety attributes we do not measure

Reporting a page

If you believe a portfolio or a lot passport misrepresents a coffee, misuses your name or photographs, or breaks any of the rules above, write to us at the contact address with the link and what you believe is wrong. We look at every report.

Contact

What we do about breaches

In most cases we contact the account and ask for a correction, because most breaches are carelessness rather than intent. Where a page misrepresents a coffee to a buyer we unpublish it, and the verification code stops resolving so nobody is left holding a certificate that points at nothing. Repeated or deliberate misrepresentation ends in the account losing the ability to publish. We do not delete an account's grading history to hide a breach: the analyses stay, the public page goes.

Grade a lot and publish it properly

Install BeanGrader and grade your first samples free. The rules above are the whole rulebook.

Free to download • 3 free analyses included • No subscription