Skip to main content
The movie type represents a standalone film. It has the highest priority of all content types in Stremio Web and is the default type shown in Discover and Board.

​
Type identifier

'movie'

​
Priority

movie has a priority value of 10 — the highest of all recognized content types. Priority is used to sort type selectors and catalog tabs when multiple types are available from an add-on. 
// From CONSTANTS.js
const TYPE_PRIORITIES = {
    movie: 10,
    // ...
};

​
Icon

The icon key for movies is 'movies', as defined in ICON_FOR_TYPE: 
const ICON_FOR_TYPE = new Map([
    ['movie', 'movies'],
    // ...
]);

​
Metadata fields

The following fields are expected for movie catalog items and detail pages. Fields sourced from the Stremio Add-on SDK meta object spec:
​
id
string
required
Unique identifier for the movie. For IMDB-sourced content, this is the IMDB ID (e.g., 'tt0111161').
​
type
string
required
Must be 'movie'.
​
name
string
required
The movie title displayed in catalog cards and the detail page header.
​
poster
string
URL to the poster image. Used in catalog cards and the detail page.
​
background
string
URL to a background/backdrop image shown on the detail page.
URL to a logo image overlaid on the backdrop on the detail page.
​
description
string
Plot summary displayed on the detail page.
​
releaseInfo
string
Release year or date string (e.g., '2023').
​
runtime
string
Duration string (e.g., '142 min').
​
genres
string[]
Genre list displayed as tags on the detail page.
​
director
string[]
Director name(s).
​
cast
string[]
Cast member names.
​
imdbRating
string
IMDB rating string (e.g., '8.5'), shown as a badge.
​
links
Link[]
Structured links. The following categories are used by the UI:
type valueConstantUsage
'meta'META_LINK_CATEGORYInternal meta links
'imdb'IMDB_LINK_CATEGORYIMDB page link
'share'SHARE_LINK_CATEGORYShare URL
'Writers'WRITERS_LINK_CATEGORYWriter credits

​
UI surfaces

Movies appear in the Board (home) view when add-ons provide movie catalogs. Catalog previews show up to 10 items (CATALOG_PREVIEW_SIZE) per catalog row.
The Discover page defaults to the movie type given its priority of 10. Users can browse paginated catalogs with up to 100 items per page (CATALOG_PAGE_SIZE). The type selector orders types by TYPE_PRIORITIES descending, so movie appears first.
Movies added to the library are stored with their full meta object. The Library view filters by type when a type is selected from the sidebar.
The movie detail page (#/detail/movie/{id}) displays poster, background, logo, description, runtime, genres, cast, director, rating, and available streams from installed add-ons.
Movies do not have seasons or episodes. The detail page for a movie renders stream options directly without an episode selector.

Build docs developers (and LLMs) love

Get started for freeTalk to us