# Comparison Table

> Compare your product against an alternative in a structured table.

Canonical HTML: https://press.varavel.com/docs/shortcodes/comparison-table/
Markdown: https://press.varavel.com/docs/shortcodes/comparison-table/index.md

`comparison_table` renders a bordered comparison table for positioning pages, alternative pages, and buyer enablement sections.

## When to Use

Use it when a visitor is comparing options and needs a quick, scannable answer. Keep row labels concrete and avoid turning the table into a generic feature dump.

## Usage

```markdown
{{/* comparison_table(
title="Why VaraPress",
primary_label="VaraPress",
secondary_label="Custom templates",
row_1_feature="Markdown composition",
row_1_primary="true",
row_1_secondary="false"
) */}}
```

## Live Example

{{ comparison_table(
container="md",
title="A clearer way to launch",
description="Use rows that map directly to buyer concerns.",
primary_label="VaraPress",
secondary_label="Custom templates",
row_1_feature="Markdown composition",
row_1_primary="true",
row_1_secondary="false",
row_2_feature="Bundled assets",
row_2_primary="true",
row_2_secondary="Manual setup"
) }}

## Parameters

| Parameter         | Description                                                       |
| ----------------- | ----------------------------------------------------------------- |
| `container`       | Inner content width. Use `xs`, `sm`, `md`, `lg`, `xl`, or `full`. |
| `eyebrow`         | Small uppercase label above the heading.                          |
| `title`           | Section heading.                                                  |
| `description`     | Supporting copy below the heading.                                |
| `primary_label`   | Label for the primary comparison column.                          |
| `secondary_label` | Label for the alternative comparison column.                      |
| `row_N_feature`   | Feature or capability name for row `N`.                           |
| `row_N_primary`   | Primary value for row `N`. Use `true`, `false`, or custom text.   |
| `row_N_secondary` | Secondary value for row `N`. Use `true`, `false`, or custom text. |
| `bg`              | Section background token. Usually `base-100` or `base-200`.       |
| `class`           | Additional CSS classes on the outer section.                      |