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.

Table label
“Setup and support comparison for a solo affiliate publisher” is more useful than “Feature comparison.”
Row label
“Typical setup effort” tells the reader what “Low” or “Requires configuration” means in that row.

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.

A useful distinction has three parts.

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.

Before you publish the next revision

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