Lexicon

Channel

place.pod.show

A podcast show or channel.

Required properties

9 fields
title
string Required

The display name of the podcast show. Keep under 100 characters for directory compatibility.

description
string Required

A short summary describing the show's content, format, and purpose.

createdAt
datetime Required

ISO 8601 timestamp of when the show record was created.

feedUrl
uri Required

Canonical public RSS feed URL, used for atom:link rel="self".

website
uri Required

Public website URL for the show, used as the RSS channel link.

language
string Required

Primary language in ISO 639 format (for example, en-us).

categories
array Required

Apple Podcasts categories, ordered by priority, with optional subcategories.

explicit
boolean Required

Whether the show contains explicit content.

coverImageUrl
uri Required

Apple-compatible show artwork URL: JPEG or PNG, 1400x1400 to 3000x3000 pixels.

Optional properties

10 fields
podcastGuid
string Optional

Stable podcast:guid value preserved across feed-host migrations.

author
string Optional

Name of the show's author or primary creator.

ownerName
string Optional

Legal or business owner name. Useful for copyright and licensing.

ownerEmail
string Optional

Contact email for the show owner.

copyright
string Optional

Copyright notice or license identifier.

people
array Optional

List of people involved in the show (hosts, producers, editors, etc.).

locked
boolean Optional

Whether the show record is locked from edits. Defaults to false.

episodeType
string Optional

Default episode type for the show. Common values: full, trailer, bonus.

type
string Optional

Apple show type: episodic or serial; required when the show is serial.

medium
string Optional

Podcasting 2.0 medium, normally podcast; other media types are optional.

Example record

JSON
{
  "$type": "place.pod.show",
  "title": "The Future of Podcasting",
  "description": "A weekly show about open standards and decentralized media.",
  "createdAt": "2024-01-15T10:00:00.000Z",
  "language": "en-US",
  "explicit": false,
  "author": "Jane Doe",
  "website": "https://example.com/podcast"
}

Best practices

  • Keep title under 100 characters for compatibility with directory listings and mobile displays.
  • Use HTTPS for all external URLs (coverImageUrl, website).
  • Set explicit accurately to help directories and clients filter content appropriately.
  • Cover images should be square and at least 1400x1400px for maximum compatibility.