1# Content Architecture for Competitor Pages
2 
3How to structure and maintain competitor data for scalable comparison pages.
4 
5## Contents
6- Centralized Competitor Data
7- Competitor Data Template
8- Your Product Data
9- Page Generation
10- Index Page Structure (alternatives index, vs comparisons index, index page best practices)
11- Footer Navigation
12 
13## Centralized Competitor Data
14 
15Create a single source of truth for each competitor:
16 
17```
18competitor_data/
19├── notion.md
20├── airtable.md
21├── monday.md
22└── ...
23```
24 
25---
26 
27## Competitor Data Template
28 
29Per competitor, document:
30 
31```yaml
32name: Notion
33website: notion.so
34tagline: "The all-in-one workspace"
35founded: 2016
36headquarters: San Francisco
37 
38# Positioning
39primary_use_case: "docs + light databases"
40target_audience: "teams wanting flexible workspace"
41market_position: "premium, feature-rich"
42 
43# Pricing
44pricing_model: per-seat
45free_tier: true
46free_tier_limits: "limited blocks, 1 user"
47starter_price: $8/user/month
48business_price: $15/user/month
49enterprise: custom
50 
51# Features (rate 1-5 or describe)
52features:
53  documents: 5
54  databases: 4
55  project_management: 3
56  collaboration: 4
57  integrations: 3
58  mobile_app: 3
59  offline_mode: 2
60  api: 4
61 
62# Strengths (be honest)
63strengths:
64  - Extremely flexible and customizable
65  - Beautiful, modern interface
66  - Strong template ecosystem
67  - Active community
68 
69# Weaknesses (be fair)
70weaknesses:
71  - Can be slow with large databases
72  - Learning curve for advanced features
73  - Limited automations compared to dedicated tools
74  - Offline mode is limited
75 
76# Best for
77best_for:
78  - Teams wanting all-in-one workspace
79  - Content-heavy workflows
80  - Documentation-first teams
81  - Startups and small teams
82 
83# Not ideal for
84not_ideal_for:
85  - Complex project management needs
86  - Large databases (1000s of rows)
87  - Teams needing robust offline
88  - Enterprise with strict compliance
89 
90# Common complaints (from reviews)
91common_complaints:
92  - "Gets slow with lots of content"
93  - "Hard to find things as workspace grows"
94  - "Mobile app is clunky"
95 
96# Migration notes
97migration_from:
98  difficulty: medium
99  data_export: "Markdown, CSV, HTML"
100  what_transfers: "Pages, databases"
101  what_doesnt: "Automations, integrations setup"
102  time_estimate: "1-3 days for small team"
103```
104 
105---
106 
107## Your Product Data
108 
109Same structure for yourself—be honest:
110 
111```yaml
112name: [Your Product]
113# ... same fields
114 
115strengths:
116  - [Your real strengths]
117 
118weaknesses:
119  - [Your honest weaknesses]
120 
121best_for:
122  - [Your ideal customers]
123 
124not_ideal_for:
125  - [Who should use something else]
126```
127 
128---
129 
130## Page Generation
131 
132Each page pulls from centralized data:
133 
134- **[Competitor] Alternative page**: Pulls competitor data + your data
135- **[Competitor] Alternatives page**: Pulls competitor data + your data + other alternatives
136- **You vs [Competitor] page**: Pulls your data + competitor data
137- **[A] vs [B] page**: Pulls both competitor data + your data
138 
139**Benefits**:
140- Update competitor pricing once, updates everywhere
141- Add new feature comparison once, appears on all pages
142- Consistent accuracy across pages
143- Easier to maintain at scale
144 
145---
146 
147## Index Page Structure
148 
149### Alternatives Index
150 
151**URL**: `/alternatives` or `/alternatives/index`
152 
153**Purpose**: Lists all "[Competitor] Alternative" pages
154 
155**Page structure**:
1561. Headline: "[Your Product] as an Alternative"
1572. Brief intro on why people switch to you
1583. List of all alternative pages with:
159   - Competitor name/logo
160   - One-line summary of key differentiator vs. that competitor
161   - Link to full comparison
1624. Common reasons people switch (aggregated)
1635. CTA
164 
165**Example**:
166```markdown
167## Explore [Your Product] as an Alternative
168 
169Looking to switch? See how [Your Product] compares to the tools you're evaluating:
170 
171- **[Notion Alternative](/alternatives/notion)** — Better for teams who need [X]
172- **[Airtable Alternative](/alternatives/airtable)** — Better for teams who need [Y]
173- **[Monday Alternative](/alternatives/monday)** — Better for teams who need [Z]
174```
175 
176---
177 
178### Vs Comparisons Index
179 
180**URL**: `/vs` or `/compare`
181 
182**Purpose**: Lists all "You vs [Competitor]" and "[A] vs [B]" pages
183 
184**Page structure**:
1851. Headline: "Compare [Your Product]"
1862. Section: "[Your Product] vs Competitors" — list of direct comparisons
1873. Section: "Head-to-Head Comparisons" — list of [A] vs [B] pages
1884. Brief methodology note
1895. CTA
190 
191---
192 
193### Index Page Best Practices
194 
195**Keep them updated**: When you add a new comparison page, add it to the relevant index.
196 
197**Internal linking**:
198- Link from index → individual pages
199- Link from individual pages → back to index
200- Cross-link between related comparisons
201 
202**SEO value**:
203- Index pages can rank for broad terms like "project management tool comparisons"
204- Pass link equity to individual comparison pages
205- Help search engines discover all comparison content
206 
207**Sorting options**:
208- By popularity (search volume)
209- Alphabetically
210- By category/use case
211- By date added (show freshness)
212 
213**Include on index pages**:
214- Last updated date for credibility
215- Number of pages/comparisons available
216- Quick filters if you have many comparisons
217 
218---
219 
220## Footer Navigation
221 
222The site footer appears on all marketing pages, making it a powerful internal linking opportunity for competitor pages.
223 
224### Option 1: Link to Index Pages (Minimum)
225 
226At minimum, add links to your comparison index pages in the footer:
227 
228```
229Footer
230├── Compare
231│   ├── Alternatives →  /alternatives
232│   └── Comparisons →  /vs
233```
234 
235This ensures every marketing page passes link equity to your comparison content hub.
236 
237### Option 2: Footer Columns by Format (Recommended for SEO)
238 
239For stronger internal linking, create dedicated footer columns for each format you've built, linking directly to your top competitors:
240 
241```
242Footer
243├── [Product] vs               ├── Alternatives to            ├── Compare
244│   ├── vs Notion              │   ├── Notion Alternative     │   ├── Notion vs Airtable
245│   ├── vs Airtable            │   ├── Airtable Alternative   │   ├── Monday vs Asana
246│   ├── vs Monday              │   ├── Monday Alternative     │   ├── Notion vs Monday
247│   ├── vs Asana               │   ├── Asana Alternative      │   ├── ...
248│   ├── vs Clickup             │   ├── Clickup Alternative    │   └── View all →
249│   ├── ...                    │   ├── ...                    │
250│   └── View all →             │   └── View all →             │
251```
252 
253**Guidelines**:
254- Include up to 8 links per column (top competitors by search volume)
255- Add "View all" link to the full index page
256- Only create columns for formats you've actually built pages for
257- Prioritize competitors with highest search volume
258 
259### Why Footer Links Matter
260 
2611. **Sitewide distribution**: Footer links appear on every marketing page, passing link equity from your entire site to comparison content
2622. **Crawl efficiency**: Search engines discover all comparison pages quickly
2633. **User discovery**: Visitors evaluating your product can easily find comparisons
2644. **Competitive positioning**: Signals to search engines that you're a key player in the space
265 
266### Implementation Notes
267 
268- Update footer when adding new high-priority comparison pages
269- Keep footer clean—don't list every comparison, just the top ones
270- Match column headers to your URL structure (e.g., "vs" column → `/vs/` URLs)
271- Consider mobile: columns may stack, so order by priority
272