GitHubDisplay a comic series, including all comic issues and all images that make up the comic. (All properties are required unless stated otherwise)
Property | Type | Description |
identifier | Uuid | Unique identifier for the comic |
name | String | Name of the comic |
description | String | A short description of the comic |
status | Status options for the comic | |
datePublished | Date the comic is published | |
url | String | Url link of this SSS feed |
genres | [Genre] | An array of what genres your comic. Most apps will only display use the first 2 or 3 genres provided. |
tags | [String] | An array of tags for the comic. Most apps will only display use the first 10 tags provided. |
coverImage | Cover art for the comic. Comes in 3 sizes (variants) cover_sm, cover_md, cover_lg | |
bannerImage | Banner art for the comic. Comes in 3 sizes (variants) banner_sm, banner_md, banner_lg | |
thumbnailImage | Thumbnail art for the comic. Comes in 1 size (variant) thumbnail | |
contentRating | Rating for the comic. | |
inLanguage | Language the comic is in. | |
seriesType | Type of comic | |
seriesLayout | Layout style for the comic | |
feedOwnerName | String | Name of the owner of this SSS feed. |
feedOwnerEmail | String | Email used to verify ownership of this SSS feed. |
copyrightNotice | String | Copyright details. |
creators | [Creator] | Links to Creator SSS Feeds. One for every creator for the comic. |
issues | An array of all issues for the comic. | |
hostingProvider | (Optional) Link to the Hosting Provider SSS Feed. This gives you details on OAuth endpoints, which allow you to access paid content on this feed. | |
scopesForExclusiveContent | [String] | (Optional) If this comic series contain any exclusive content this property will be present. It lists the payment platforms which the user must use to view exclusive issues. |
ComicIssue
Comic Series con contain multiple issues (episodes)
Property | Type | Description |
identifier | Uuid | Unique identifier for the comic issue |
name | String | Name of the issue |
creatorNote | String | A note from the creator. Most apps will only display the first 260 characters. |
datePublished | Date the issue is published. | |
bannerImage | Banner art for the issue. Comes in 3 sizes (variants) banner_sm, banner_md, banner_lg | |
thumbnailImage | Thumbnail art for the issue. Comes in 1 size (variant) thumbnail | |
stories | An array of all the stories (art) for the issue. | |
scopesForExclusiveContent | [String] | (Optional) This property will be present if this comic issue is exclusive content. It lists the payment platforms which the user must use to view exclusive issues. |
dateExclusiveContentIsAvailable | (Optional) Date the exclusive issue is available for everyone.
If this comic issue is exclusive content and will be free at a certain time in the future, this property will be present. This gives you the information to display ‘X days till Free’ for the comic issue. |
ComicStory
An image.
Property | Type | Description |
identifier | Uuid | Unique identifier for the comic story (artwork) |
storyImage | Art for the story. Comes in 1 size (variant) story |
Example SSS Feed
Comics Apps that support SSS Feeds
Supported Comic AppsWant to notify comic apps about a new feed?
Referenced types in this document:
LanguageImageDetailsContentRatingComicSeriesTypeGenreDateSSSFeedSeriesStatusComicSeriesLayoutIf you would like to edit or contribute to the SSS specification. You can either submit a PR here or by creating a notion account and leaving a comment.
Open Source Credit: This website is actually just a notion document. We use Travis's notion + nextjs starter project, you should check it out if you want an easy way to create + edit your docs.