# Carousel vs Link Decision Guide

**Last Updated:** 2026-01-10

Guide for deciding when to use the related content carousel vs inline links in blog posts.

## Overview

The blog uses two complementary systems for internal linking:
1. **Inline Links** - Direct links within content
2. **Related Content Carousel** - Rotating carousel of related resources

This guide helps determine when to use each approach for optimal SEO/GEO/AEO and user experience.

## Decision Framework

### Use Inline Links For:

1. **Direct References**
   - Definitions and explanations
   - Tools and calculators mentioned in content
   - Specific resources (templates, downloads)
   - Product features and solutions

2. **Contextual Mentions**
   - First natural mention of keyword
   - When link adds immediate value
   - When link clarifies or expands on current topic

3. **SEO-Critical Links**
   - Pillar page links (cluster requirements)
   - Product page links (conversion opportunities)
   - Target keyword links

4. **Grammatical Integration**
   - When link fits naturally into sentence flow
   - When anchor text matches surrounding context
   - When link enhances readability

### Use Carousel For:

1. **Related Content Discovery**
   - Additional blog posts on similar topics
   - Related resources (templates, tools, downloads)
   - Topic exploration
   - Content clusters

2. **Non-Critical Links**
   - When inline link would be redundant
   - When multiple related posts exist
   - When link doesn't fit grammatically

3. **Content Diversity**
   - Multiple resource types (blog, templates, tools)
   - Cross-cluster content
   - Topic variations

## Integration Strategy

### Avoid Redundancy

- If a post is linked inline, don't include it in carousel
- If a post is in carousel, avoid inline link unless critical
- Prioritize inline links for SEO-critical targets

### Balance Distribution

- **Inline Links**: 3-8 per post (varies by length)
- **Carousel**: 8-12 related resources
- **Total Internal Links**: 10-20 per post

### Link Frequency Limits

- Maximum 1 link per paragraph (unless long paragraph)
- Minimum 200 characters between links
- Maximum 3 links to same URL per post

## Examples

### Good Inline Link Usage

```
Mit Ordio kannst du deine Schichtplanung effizient gestalten. 
Die Schichtplanungsfunktionen ermöglichen es dir, Schichten 
flexibel anzupassen und Verfügbarkeiten zu berücksichtigen.
```

**Why:** Direct product mention, natural integration, SEO-critical

### Good Carousel Usage

After a post about "Dienstplan erstellen", the carousel shows:
- Related posts: "Schichtmodelle", "Dienstplan optimieren"
- Templates: "Dienstplan Excel Vorlage"
- Tools: "ROI Rechner Schichtplanung"

**Why:** Related content discovery, avoids inline redundancy

### Bad Inline Link Usage

```
Ein Beispiel aus der Praxis: mehr zum Dienstplan
```

**Why:** Placed after section title, grammatically awkward

### Bad Carousel Usage

Including the exact same post that's already linked inline 3 times.

**Why:** Redundant, doesn't add value

## SEO Considerations

### Inline Links

- **Anchor Text Variety**: Use different anchor texts for same URL
- **First Mention Priority**: Link at first natural mention
- **Keyword Integration**: Use target/relevant/LSI keywords naturally

### Carousel

- **Cluster Integration**: Use content clusters for selection
- **Topic Matching**: Prioritize posts with shared topics
- **Semantic Similarity**: Use similarity scores for ranking

## Implementation

### Inline Links

Managed by:
- `v2/scripts/blog/add-links-to-json.php` - Context-aware link insertion
- `v2/scripts/blog/analyze-content-context.php` - Paragraph analysis
- `v2/scripts/blog/validate-link-grammar.php` - Grammar validation

### Carousel

Managed by:
- `v2/base/blog_related_carousel.php` - Carousel component
- `v2/config/blog-template-helpers.php` - `load_related_resources_unified()`
- Related posts algorithm (5-tier fallback system)

## Best Practices

1. **Context First**: Always analyze paragraph context before placing links
2. **Grammar Validation**: Ensure links fit grammatically
3. **Natural Integration**: Links should enhance, not distract
4. **Strategic Placement**: First natural mention, not random positions
5. **Avoid Redundancy**: Don't duplicate carousel content in inline links
6. **Balance**: Use both systems strategically for comprehensive linking

## Validation

Run validation scripts to check link quality:

```bash
# Validate link quality
php v2/scripts/blog/validate-link-quality.php [category/slug]

# Fix problematic links
php v2/scripts/blog/fix-problematic-links.php [category/slug]
```

## Related Documentation

- [Internal Linking Guide](./INTERNAL_LINKING_GUIDE.md)
- [Related Posts Logic](./RELATED_POSTS_LOGIC.md)
- [Content Relationships](./CONTENT_RELATIONSHIPS.md)
- [Cluster Linking Strategy](./CLUSTER_LINKING_STRATEGY.md)