Quick Start: How to Create a Roku Channel in 5 Minutes


The following steps will guide you through the process of building a Roku "Custom SDK" channel. Sample video content and poster image URLs are provided, but feel free to substitute URLs for your own videos and posters if you wish.

  1. An Instant TV Channel account.
  2. A Roku Developer Account at http://developer.roku.com.
  3. A Roku device connected to a TV set or computer monitor, or a TV set with a built-in Roku device.

Step-by-Step Directions:

  1. Log into your Instant TV Channel account.
  2. From the menu along the left side of the page, select Channels.

    If this is a new account, you will already have a brand new channel waiting to be filled with content.

    If you want to start fresh, click the New Channel button at the bottom of the channel list. Select a channel type of SceneGraph then click the Confirm button. If you are watching the video for this walk-through, it incorrectly shows the Classic channel type. Use the SceneGraph channel type instead.

    Your new Roku channel is at the bottom of your channel list, and should be highlighted in yellow.

  3. From the menu along the left side of the page, select Theme.

    This is the Theme Editor. It allows you to change the look and feel of your Roku channel. For now, we'll just be changing the title. In the top parameter box, change "My Channel" to the name you want your new channel to have, for example "My Quick Channel".

  4. From the menu along the left side of the page, select Content.

    This is the Content Editor. It allows you to change the details of individual video or audio content items. It also lets you add new content items, and move, copy, or delete existing content items.

    Notice the Content Editor Help shown in the window along the right side of the page. This window often contains useful information about how to use the current page.

    The content "tree" shown in the upper left window is a visual representation of your Roku channel's layout. Each list and content item is shown here. Clicking any item causes the details of that item to be shown in the lower detail window, and any poster artwork associated with the item is shown in the upper right poster window. Clicking the + symbol next to a list, series , grid , or grid-row expands it to show the content item(s) it contains.

    There is only one content item currently in the channel . Let's change some of the information for that content item.

    1. In the parameter box labeled Title, replace "New Video or Audio" with "Plan 9 From Outer Space".
    2. In the parameter box labeled Description, replace the default text with "Worst Movie Ever Made!"
    3. In the parameter box labeled PosterURL, replace the default URL with

      The PosterURL points to the image (stored on a web server, S3 bucket, or other image storage service) that will be displayed in the content item's detail screen, after it has been selected on the Roku device. The detail screen is often referred to as the Springboard screen in Roku's SDK documentation.

    Example "PosterUrl" poster on a "Springboard" screen.

    1. Scroll the parameter list down to the Stream 1 URL parameter box that contains the default "https://cdn2.instanttvchannel.com/plan9/plan9_640x480.mp4" URL. This long URL points to the video content stream (stored on a web server, content delivery network, or online video provider) that will be played when this item is selected on the Roku device.
    2. Scroll further down to the parameter box labeled ShortDescriptionLine2, and change "Created with www.InstantTvChannel.com" to "My Favorite Movie".

      The ShortDescriptionLine1 and ShortDescriptionLine2 parameters contain the text that is displayed below the poster for the content item at the top level or parent-list of your channel, before the content item is selected on the Roku device.

    Example "Short Description Line 1" & "Short Description Line 2" on a "Horizontal List" screen.

    1. Scroll the parameter list down a little bit more to ListPosterURL, and change the default URL to

      The ListPosterURL points to the image (stored on a web server, S3 bucket, or other image storage service) that will be displayed for the content item at the top level or parent-list of your Roku channel, before the content item is selected on the device.

    Example "ListPosterUrl" posters (3 shown, 1 highlighted) on a "Horizontal List" screen.

    We have been using image URLs that point to specifically-sized .png files for each image that the content item might display. Using images that are sized to the exact requirements of the Roku device allows the channel to load faster. It is possible to use images of other sizes at the cost of slower load times. The recommended image size is always shown in the description next to the image URL parameters in the Content Editor. PNG, JPG and GIF images are supported.

  5. Now we're ready to package your Roku channel.

    From the menu along the left side of the page, select Channels.

    Click on the row containing the channel to be packaged.

    In the same row as the new channel there is a Package button with a red box around it.

    1. Click the Package button in the channel's row.
    2. Click the Confirm Package button.
    3. After the channel has been packaged, a DOWNLOAD PKG link is displayed. Click on the DOWNLOAD PKG link and save the file somewhere on your computer. You will need to upload it to your Roku Developer Account in a later step.

    The Pkg file contains the script that will be loaded from Roku's servers onto any Roku device that installs your channel.

  6. Before uploading the channel Pkg file to your Roku Developer Account, you'll need to have the Channel Store poster. This is the artwork that is displayed in the Channel Store to represent your channel. The size of the Channel Store poster is exactly 540 pixels wide and 405 pixels high.

    Use the following link to download a sample Channel Store poster from Instant TV Channel and save it to your computer:

  7. Now we will upload the Pkg file for your new channel to your Roku Developer Account.

    1. Log into your Roku Account at https://my.roku.com
    2. Click the circle icon in the upper right corner and then select Developers.

    Click the circle icon.

    Select "Developers".

    1. Click the Dashboard link to advance to the "Developer Dashboard" page.

    Click the "Dashboard" link.

    1. Under "My Channels", click the Manage My Channels link to advance to the "Manage Channels" page.

    Click "Manage My Channels".

    1. Click the Add Channel button.

    Click the "Add Channel" button.

    1. Select the Developer SDK option. This will create a Custom SDK channel.

      (The Direct Publisher option can also be used with Instant TV Channel, and is covered in a different walk-through. The Direct Publisher option does not yet provide as many features as the Custom SDK / Developer SDK option does.)

    2. Select the Non-certified or Private option. Be careful not to accidentally select the Public option, which is only used to submit fully tested channels to Roku for the Channel Store review and approval process.
    3. Enter your channel's name into the Channel Name text box.
    4. Click the Save or Continue button to advance to the "Properties" page.

    Select the "Developer SDK" & "Non-certified" options, and enter your channel's name.

    1. Select the Channel Store Regions for which you have the rights to distribute your channel's content. If your content has no regional licensing restrictions, it is OK to select all of the Regions.

    Select the Channel Store Regions.

    1. Enter a Vanity Access Code. This is usually one or two words, with no spaces, that identifies your channel. Write down this code, you'll need it to install the channel later on.

    Enter a "Vanity Access Code".

    1. For most channels the remaining settings on this page should be unchanged. If present, do not change any of the Required Features options, as this may prevent your channel from being available for certain models of Roku devices.
    2. Click the Save or Continue button to advance to the "Channel Store Info" page.
    3. Provide a Description, Web Description, and (if present) Keywords.

      For example:
         Channel Description - A great movie channel.
         Web Description - A great movie channel providing a wonderful selection of exciting movies.
         Keywords (if present) - film

    4. Click Add a poster and then locate and select the previously saved sample Channel Store poster. If you are using your own poster instead of the sample, the poster must be exactly 540 pixels wide and 405 pixels high.

    Upload a Channel Store Poster.

    1. Select a "Descriptive Category" for your channel. This is the Channel Store category in which your channel would appear, if it was submitted and approved as a public channel.

    Select a Preferred Category.

    1. Select a "Domestic Region" for your channel. If a channel is submitted and approved as a public channel, this is the Channel Store Region in which the channel will appear under the Descriptive Category. The channel will appear in the "International" category in all other Channel Stores Regions that were selected on the Properties page.

    Select a Domestic Region.

    1. Click the Save or Continue button to advance to the "Monetization" page.

      If your Roku Developer Account is not enrolled in Roku Billing Services then the "Monetization" page will not be available, and the "Package Upload" page will be displayed next.
    2. For this example channel you should leave "None of the above apply" selected and just click the Save or Continue button to advance to the "Package Upload" page.

    No monetization selected.

    1. Change the Minimum Firmware to "v6.1 b1". Usually this will never need to be adjusted again. If Minimum Firmware is set too high, your channel will not be available on older model Roku devices.

      In the future, if you need to upload a new Pkg file, you must remember to always increment the Channel Version number shown above the Minimum Firmware setting. Channel Version is what all Roku devices use to determine whether or not a newer Pkg file containing an updated version of your channel is available. If Channel Version is not incremented when you upload a new Pkg file, then Roku devices that already have your channel installed will not be able to receive the updated version. If this is the first Pkg file, then Channel Version remains at "1.0" and cannot be changed.
    2. Click Upload a package and then locate and select the previously saved Pkg file.

    Before Pkg file upload.

    After Pkg file upload.

    1. Click the Save or Continue button to advance to the "Preview and Publish" page.
    2. Verify that there is a checkmark next to each item in the checklist at the bottom of the page, except for Static Analysis, then click the Publish button. Static Analysis does not require a checkmark.


    1. Click on the Vanity Access Code link to advance to the non-certified channel Warning page.
    2. Click OK on the Warning page, then click Yes, add channel to confirm that the new channel is to be added to your account and installed on your Roku device.
    3. If a "you must have at least one device" error message appears at this point, it means that you do not have any Roku devices associated with this Roku account.

      You can use the same Vanity Access Code in any other Roku account to install your new channel.

  8. Your new channel is now in your Roku account and will be installed onto your Roku device in 24 hours or less. To force your Roku device to install your channel immediately you may need to do a System Update. Using your Roku remote control:

    1. Press the remote control HOME key.
    2. Use the remote control UP and DOWN keys and the OK key to select Settings from the on-screen menu.
    3. Select System from the on-screen menu.
    4. Select System update from the on-screen menu.
    5. Select Check now from the on-screen menu.
    6. You should see a brief message flash on the screen about installing your new channel.
    7. Press the remote control HOME key again.

    If your new channel installed successfully, it will be located directly above the dividing line in your Roku home-screen channel list.

    Selecting your channel will bring up a splash screen first, then it will display the ListPosterURL image. Your channel currently has only a single ListPoster image, although most channels will have several.

    Click OK with your remote to select the ListPoster image. You'll see the Springboard screen for your content item.

    Select the on-screen Play button to start the content item stream, "Plan 9 From Outer Space".

  9. Most changes to your Roku channel can be made instantly, without re-packaging or re-uploading to your Roku Developer Account.

    For example, let's add a new video content item to the channel:

    1. From the Instant TV Channel menu along the left side of the page, click Content to go to the Content Editor page.
    2. Right click on the channel folder icon in the upper left window and select New Video or Audio from the list of items. A content item named "New Video or Audio" is added to your Roku channel.
    3. Again, right click on the channel folder icon to create another content item.
    4. The two new content items have the default URLs for the Instant TV Channel posters and the default "Plan 9 From Outer Space" stream URL. Later on you can come back and change these to something else, but for now we'll keep the defaults.
    5. Go back to your Roku device. Press the Home button on your Roku remote control to exit your channel, then press OK to restart your channel. (You'll always need to exit and then re-enter your channel before viewing any new or recently changed content.)
    6. The two new content items that you added appear in your Roku channel.

    Your channel's content was changed WITHOUT needing to re-package or re-upload the channel to your Roku Developer Account.

    Only certain items in the Theme Editor, such as artwork contained in the Pkg file, will require re-packaging and re-uploading to Roku. If your Roku channel needs to be repackaged and re-uploaded then a red box will appear around the Package button in the main Channel List.

    For a more sophisticated appearance you may want to consider including grids and trailers in your channel. Here is some additional information to get you started:

Email comments & questions about this Roku developer guide to .

Instant TV Channel is a cloud-based tool for Roku developers and content providers that shortens development time and eases maintenance after deployment.

Access Code: U463
Check out Instant TV Channel by adding our latest demonstration channel to your Roku player, or watch the YouTube video.

Need help with your Roku?

We are unable to provide technical support for your Roku device.

Please visit www.roku.com for assistance.

Instant TV Channel is not affiliated with nor endorsed by Roku Inc.