Feeds¶

Django Cast provides comprehensive feed support for both blogs and podcasts, with RSS and Atom formats, iTunes metadata, and performance optimizations.

Feed Detail Page¶

Each blog and podcast has a dedicated feed detail page at <slug>/feed/ (URL name cast:feed_detail) that lists all available feeds in one place:

Blog RSS and Atom feed links (for all blogs)
Platform links — Apple Podcasts, Spotify, YouTube (for podcasts, when the corresponding key is set in CAST_FOLLOW_LINKS)
Podcast feeds table with all four audio formats (MP3, M4A, OGA, OPUS) in both RSS and Atom (for podcasts only)

The navbar RSS icon links to this page instead of the raw XML feed. Custom themes without a feed_detail.html template automatically fall back to the plain theme.

The template receives the following context variables:

blog — the Blog or Podcast instance
is_podcast — boolean, True for podcasts
blog_feed_url — URL to the blog RSS XML feed
blog_atom_feed_url — URL to the blog Atom XML feed
template_base_dir — the active theme name
podcast_feeds — list of dicts with format, format_label, rss_url, atom_url (podcasts only)
apple_podcasts_url — Apple Podcasts URL from settings, or None (podcasts only)
spotify_url — Spotify URL from settings, or None (podcasts only)
youtube_url — YouTube URL from settings, or None (podcasts only)

Feed Types¶

Blog Feeds¶

Blog feeds are available in RSS and Atom formats, automatically generated from your blog content:

RSS 2.0 feed at <slug>/feed/rss.xml
Atom 1.0 feed at <slug>/feed/atom.xml
Feed fields populated from Blog model: title, description, author
Automatic inclusion of post content (overview and detail sections)

Podcast Feeds¶

Podcast feeds extend blog feeds with additional podcast-specific features:

iTunes podcast metadata (artwork, categories, explicit content marking)
Audio file enclosures for episode distribution
Multiple audio format support with separate feeds per format
RSS at <slug>/feed/podcast/<audio_format>/rss.xml
Atom at <slug>/feed/podcast/<audio_format>/atom.xml
Chapter marks support for enhanced navigation
Transcript URLs included in feeds (WebVTT and DOTE formats)

Feed Fields¶

Standard Fields¶

These fields are populated from the Blog/Podcast model:

Title: From the blog’s title field
Description: From the blog’s description field
Author: Populates both iTunes and Atom feed author tags
Link: Canonical URL to the blog/podcast homepage
Language: Configurable per blog instance

Podcast-Specific Fields¶

Additional metadata for podcast feeds:

iTunes Artwork: High-resolution podcast cover image
iTunes Subtitle: From the blog’s subtitle field
iTunes Categories: Podcast directory categorization
Explicit Content: Content rating flag
Episode Enclosures: Audio files with proper MIME types
Episode Duration: Calculated from audio files
Chapter Marks: Time-indexed navigation points
Transcripts: Links to VTT and DOTE transcript files

Feed Generation¶

Repository Pattern¶

Feeds use the FeedContext pattern for optimized generation:

# Efficient feed generation with minimal queries
repository = FeedContext(blog)
# All posts and related data prefetched

Performance Features¶

Feed Caching: Generated XML cached to reduce server load
Prefetch Optimization: Single query retrieves all feed data
Lazy Loading: Large content fields loaded on-demand
Conditional GET: Support for If-Modified-Since headers

API Access¶

Feeds are also available via the REST API:

/api/posts/ - JSON feed of blog posts
/api/episodes/ - JSON feed of podcast episodes
Supports filtering, pagination, and field selection
Machine-readable alternative to XML feeds

Configuration¶

Feed Limits¶

Control the number of items in feeds:

# In settings.py
CAST_FEED_ITEM_LIMIT = 50  # Default: 50 items

Follow Links¶

Configure platform links shown on the feed detail page for podcasts:

CAST_FOLLOW_LINKS = {
    "apple_podcasts": "https://podcasts.apple.com/...",
    "spotify": "https://open.spotify.com/show/...",
    "youtube": "https://www.youtube.com/@...",
}

Cache Duration¶

Configure feed cache timeout:

# Cache feeds for 1 hour
CAST_FEED_CACHE_TIMEOUT = 3600

Best Practices¶

Use Descriptive Titles: Feed titles should clearly identify your content
Set Appropriate Descriptions: Descriptions appear in feed readers
Configure Author Information: Improves attribution and discoverability
Optimize Images: Use appropriate resolutions for podcast artwork
Enable Caching: Reduces server load for popular feeds
Monitor Feed Validation: Ensure feeds validate against standards