What Good Content Is: contentEffort and Google's Soft Metrics
One leaked field, one rater definition, twelve official questions, and a checklist that marks which parts are evidence and which are our reading.
01Start here: three texts, one question
This article answers one question — what does Google mean by "good content"? — in three passes. First the machine answer: a single leaked field called contentEffort, described in one line and nothing more. Then the human answer: how Google's quality rater guidelines define effort, and the twelve questions Google publishes for publishers. Then the practical answer: a checklist. Every statement below names its source, so you can see at a glance whether it rests on the leak, on an official Google document, or on our own reading.
The first of the two texts that prompted this one is Cyrus Shepard's "Content Effort: The Google Ranking Feature Nobody Talks About" on Zyppy Signal. It takes the same field from the practitioner's side. It gathers the effort markers scattered through the rater guidelines — curation and real editing, automation that adds something a model cannot, original facts instead of recycled ones, helpful material placed prominently rather than buried under filler, discussion with an actual point of view — and ends in a short audit to run before you publish. That piece says what to do. This one says what is documented, what is official, and where the reading starts. They are meant to be read together, and Shepard's is the better place to begin.
The second is a LinkedIn post by Anam Hassan, which recommended that article and added the part no ranking field can see. Content of this kind needs departments that actually talk to each other, writers with access to the tool and to subject matter experts, and time. That is the organisational precondition behind every line of the checklist in section 07: a page cannot show evidence of work that nobody was given room to do. Our thanks to both: to Cyrus Shepard for the piece that set the frame, and to Anam Hassan for naming what it costs in practice.
02One line in the leak
The leaked Content Warehouse documentation, Google's internal API documentation that became public, gives "What is good content?" a surprisingly short machine answer: a single field, contentEffort, described in one line as an LLM-based effort estimation for article pages, that is, an estimate made by a large language model. The field sits in the module QualityNsrPQData, stored as a list of versioned values whose type is defined in Google's quality/nsr code. Next to it sit other page-level quality predictors such as chard, tofu, keto, rhubarb and vlq.
That one line is also everything the leak says. It names no inputs, no scale, no weight and no use in ranking, and it limits the field to article pages. A weather forecast, a calculator or a product page may never receive this value. Anything beyond the line is inference, and this article marks it as such.
03Google's own definition of effort
The word the field uses, effort, is also the first criterion in Google's rater manual on content quality. The Search Quality Rater Guidelines of 11 September 2025, the handbook for the people who rate search results, say that for most pages the quality of the main content can be determined by the amount of effort, originality, and talent or skill that went into it, plus accuracy for informational and YMYL pages. These four are the soft metrics: judgments a trained person makes, not numbers a tool reports.
The definition of effort is about people and purpose, not length or production method. Effort is the extent to which a human actively worked to create satisfying content, and it can go into building page functionality as much as into writing. What counts as enough depends on the page type, and the use of generative AI alone does not decide the level of effort.
04The soft metrics, spelled out
The rater manual gives each soft metric a high and a low end. High effort means well organised, edited and curated; low effort means helpful content mixed with filler, little discussion, or instructions buried under unrelated text. High originality means content unique to the site, own photos or footage, or a first-hand perspective; low originality means summaries of what others already said.
Two calibrations matter more than any single criterion. First, filler is named as its own failure: content that inflates a page without serving its purpose. Second, the bar is relative to the competition, because typical and average pages on a topic are Medium, not High. At the bottom, pages built almost entirely from copied, paraphrased or AI-generated material with no added value are rated Lowest, even when they credit their sources.
05Google's twelve questions for publishers
For publishers, Google translates the same ideas into self-assessment questions. The twelve content and quality questions ask about original information and analysis, completeness, insight beyond the obvious, added value over copied sources, honest titles, whether the page would be bookmarked or cited in print, value compared with other results, spelling, sloppy or hasty production, and mass production across many creators or sites.
Two further passages sharpen what effort is not and what it looks like. Google says outright that it has no preferred word count, and it asks publishers to show the "How": for reviews, how many products were tested, with what results and methods, backed by evidence such as photographs. On the other side of the line sits the spam policy on scaled content abuse, which applies no matter how the content is created.
06Rater judgment and the machine estimate
Rater scores do not rank pages. Google states that no single rating can move a page, and that ratings serve to measure how well search works and to supply examples of helpful and unhelpful results. The rater's soft metrics are therefore not inputs; they are the yardstick against which systems are checked.
The leaked field and the rater manual share one word, and that is where the evidence ends. Nothing in the leak says that contentEffort is trained on rater judgments, and nothing in the guidelines mentions the field. Reading contentEffort as a machine approximation of the rater's effort criterion is plausible, and it is our assessment.
07The checklist
- Purpose first: say what the page is for and put the most helpful part at the top.
- Effort shows in the result: organised, edited, curated, with no filler ahead of the answer.
- Something original: own data, own photos, own tests or a first-hand perspective; if you draw on sources, add substantial value.
- Skill fits the task: the explanation works because the author can do the thing.
- Accurate, and on YMYL topics consistent with expert consensus.
- An honest title that neither exaggerates nor shocks.
- Show the How: methods, tests, evidence, and a disclosure where automation did substantial work.
- Calibrate against the results page: if your page is typical for the topic, raters call that Medium.
- Do not write to a word count; length is not effort.
- No scale without value: generating, stitching or paraphrasing pages in bulk is where the spam policy begins, whatever tool is used.
Items 1 to 10 restate Google's documented criteria; that meeting them raises contentEffort is not documented anywhere.
08References
Official Documentation (4)
- [13]OGoogle Search Central, "Creating helpful, reliable, people-first content", section "Content and quality questions" ↗
- [14]OGoogle Search Central, "Creating helpful, reliable, people-first content", section "Avoid creating search engine-first content" ↗
- [15]OGoogle Search Central, "Creating helpful, reliable, people-first content", section "How (the content was created)" ↗
- [16]OGoogle Search Central, "Spam policies for Google web search", section "Scaled content abuse" ↗
API Leak (3)
Quality Rater Guidelines (9)
- [7]OSearch Quality Rater Guidelines, 11 September 2025, section 3.2 "Quality of the Main Content" ↗
- [8]OSearch Quality Rater Guidelines, 11 September 2025, section 3.2 ↗
- [9]OSearch Quality Rater Guidelines, 11 September 2025, section 4.6.6 ↗
- [10]OSearch Quality Rater Guidelines, 11 September 2025, section 7.1 "High Quality Main Content" ↗
- [11]OSearch Quality Rater Guidelines, 11 September 2025, section 7.1 ↗
- [12]OSearch Quality Rater Guidelines, 11 September 2025, section 5.2.2 "Filler as a Poor User Experience" ↗
- [17]OSearch Quality Rater Guidelines, 11 September 2025, section 0.1 "The Purpose of Search Quality Rating" ↗
- [18]COwn comparison of QualityNsrPQData and the Search Quality Rater Guidelines ↗
- [19]COwn synthesis of the Search Quality Rater Guidelines and "Creating helpful, reliable, people-first content" ↗