Affiliate publishing guide
Maintain comparison tables people can actually use.
A good comparison table helps a reader understand the decision, the products in front of them, and the trade-offs between those choices. Accessibility is part of that editorial job: the same meaning should remain available to keyboard users, screen reader users, people zooming the page, and people reading on a small screen.
01 · Frame the decision
Tell readers what they are choosing and why.
Introduce the decision in one sentence before the table. Is the reader choosing a first tool, replacing an existing product, staying within a budget, or trading setup effort for more control? That context tells readers how to interpret the rows and keeps the table from becoming a list of disconnected specifications.
Use a short, descriptive caption that states what is being compared. Name each product with its full, recognizable label in the column header. If a product has a relevant plan, edition, audience, or limitation, include that distinction in the label or the nearby explanatory text rather than assuming the reader knows it.
02 · Label the structure
Give the table, columns, and rows an explicit name.
Use a real table when the content is a relationship between products and criteria. Provide a visible or programmatically available caption, a header for the criteria column, a header for every product column, and a clear row label for every value. Those relationships let assistive technology announce the context as a reader moves through cells.
Keep labels concise, but do not replace them with unexplained icons, abbreviations, or empty cells. If a value is unknown, unavailable, or not applicable, say that in text and explain the difference where it affects the decision.
03 · Make differences meaningful
Explain what changes between products—and what it costs.
Use words that distinguish the products in a way readers can act on. “Included,” “add-on,” “manual export,” and “requires a larger plan” communicate more than a green check or a gray dash. Do not rely on color, position, bold weight, or an icon alone to identify the recommended choice or a meaningful limitation.
Put the trade-off close to the advantage it qualifies. If one product offers more flexibility but takes longer to configure, say both in the row or its supporting note. If a score compresses several judgments into one number, show the criteria and the evidence behind it so readers can make their own priority-based decision.
Value: what the product offers.
Constraint: what it requires or gives up.
Fit: who should care about the difference.
04 · Maintain it deliberately
Use the same review loop after every meaningful change.
Treat accessibility as part of content maintenance, not a final polish step. A new product, changed plan, removed feature, reordered column, or revised recommendation can break the meaning and usability of a table even when the page still looks tidy.
- Record product, price, availability, feature, and policy changes before editing the table.
- Review the caption, column headers, row labels, product distinctions, and trade-off notes after every structural change.
- Check keyboard movement, zoomed text, narrow screens, and a screen reader before republishing.
- Confirm that the recommendation still matches the stated reader decision and the evidence behind it.
- Add the review date, name the next reviewer, and keep unresolved limitations visible.
On mobile, verify that the table remains understandable without forcing people to guess which product a cell belongs to. A carefully labeled horizontal scroll area can be appropriate; so can a stacked alternative when the relationships remain explicit. Test at increased text size and with keyboard navigation. A screen reader check should confirm the caption, column headers, row labels, and recommendation context are announced in a sensible order.
Ask a second editor to name the decision, the products, and the most important trade-off from the page without opening another document. Then verify the same path with keyboard-only navigation and a narrow viewport. If either reader has to infer the meaning from color or layout, revise the labels and supporting text before publishing.
Revisit the comparison criteria guide