Updates are periodically released when new channel features are added to Instant TV Channel.
Updates usually consist of new Brightscript code that is automatically built into
your channel's Pkg file which you upload to your Roku Developer Account.
After an update is applied to a channel, it's a good idea to test the updated channel
before replacing the old channel.
This is particularly important for channels in the public Roku Channel Store,
and for monetized channels.
When a new update is available for a channel,
an Update button is present near the top of the Channels page.
The following is a screenshot from the top section of the Channels page
showing a selected channel with an update available.
The channel is at update version 191 and
the most recent update is version 194.
If no update is available for a channel,
the Update button is not present on the Channels page.
The following is a screenshot from the top section of the Channels page
showing a selected channel with no update available.
The channel is at update version 191.
If you have several channels, they do not have to all be at the same update version.
If a channel does not require the new capabilities provided by an update,
it is not necessary to update the channel to the newer version.
Details about updates including descriptions of the new channel capabilities
provided by each update are available on the Instant TV Channel
Applying an update to a channel is very easy:
Log into your Instant TV Channel account and click on
the Channels link on the left side of the page.
Click on the row containing the channel that you wish to update.
Clone the channel by clicking the
button in the channel's row,
then click the Confirm button at the top of the page.
This creates an identical copy of the channel that
we will apply the update to.
After the clone is complete,
the row containing the clone should be highlighted.
Click on the Update button near the top of the Channels page.
A warning dialog appears and reminds you to clone the channel first.
Since you have already done this, click Ok to proceed with the update.
After the clone has been updated the Update button will disappear.
Enter the Theme Editor by clicking on the Theme link on
the left side of the Instant TV Channel page.
Remove "(Clone)" from the end of the clone's Title.
Because the original and the clone now have the same title,
increment the clone's minor_version number so that you can
distinguish between them.
If the cloned channel's Type is "Clone requiring upgrade to Unlimited" or
"Clone requiring upgrade to Commercial",
click the button in the channel's row,
then verify the credit card information and click the
"UPGRADE TO UNLIMITED NOW" or "UPGRADE TO COMMERCIAL NOW" button.
Unlimited and Commercial clones that are not upgraded are not packagable
and will not be uploadable to your Roku Developer Account.
Before uploading the newly updated clone channel on top of the existing published channel,
it should first be packaged and uploaded to your Roku Developer Account as a test channel.
This will allow the update to be tested without affecting any
existing subscribers of the channel.
To package the cloned channel:
From the Channels page,
package the clone by clicking the
button in the clone's row.
Click the Confirm Package button.
After the clone 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 the next steps.
Before uploading the channel Pkg file to your Roku Developer Account, you'll need to have a Channel Store poster.
This is the artwork that is displayed in the Roku "Home" screen that will be used to launch your test 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:
Click the large purple Welcome (Your Name) box and then select Developer site.
Select the "Developer site" option.
Under "My Channels", click the Manage My Channels link to advance to the "Manage Channels" page.
Select "Manage My Channels".
Click the Add Channel button.
Click the "Add Channels" button.
Select the Developer SDK option.
Select the Non-certified ("Private") option.
Enter your test channel's name into the grey box.
Click the Continue button to advance to the "Properties" page.
Select the "Developer SDK" & "Non-certified" options, and enter your channel's name.
Select the Channel Store region in which you are located.
Since this channel is only for testing you do not need to select all of the regions that the production version of the channel uses.
Select the Channel Store regions.
Enter a Vanity Access Code.
This is usually one or two words, with no spaces, that identifies your test channel.
Write down this code, you'll need it to install the test channel later on.
Enter a "Vanity Access Code".
For most channels the remaining settings on this page should be unchanged.
If present, do not check any of the Required Features checkboxes,
as this may prevent your channel from being available for certain models of Roku devices.
Click the Continue button to advance to the "Channel Store Info" page.
Provide a Description and Web Description.
Channel Description - Test Channel
Web Description - Test Channel
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.
Select a "Preferred Category" for the Channel Store geographic region.
This is the on-screen Channel Store category in which your channel would appear,
if it was submitted and approved as a public channel.
Since this is a private test channel, the selection made here has no effect (but is still required).
Select a Preferred Category.
Click the Continue button to advance to the "Monetization" page.
For most test channels you should leave "None of the above" selected
and just click the Continue button to advance to the "Package Upload" page.
Change the Minimum Firmware to "v7.7.2".
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.
Click Upload a package and then locate and select the previously saved Pkg file.
Before Pkg Upload
After Pkg Upload
Click the Continue button to advance to the "Preview and Publish" page.
Click the blue Publish or Submit for Publishing button.
Click on the Vanity Access Code link to advance to the "Add Channel" page.
Click Add Channel to confirm that the test channel is to be added to your account and installed on your Roku device.
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 Vanity Access Code in any other Roku account to install the test channel.
Your test channel is now in your Roku account.
If the channel is not automatically installed onto your Roku device,
you can force your Roku device to install your channel immediately using your Roku remote control:
Press the remote control HOME key.
Use the remote control UP and DOWN keys and the OK key to select Settings from the on-screen menu.
Select System from the on-screen menu.
Select System update from the on-screen menu.
Select Check now from the on-screen menu
You should see a brief message flash on the screen about installing your new channel.
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.
You can temporarily set the test channel's ShowDebugVersion
parameter on the Theme page to Yes in order to verify that you are
viewing the test version of the channel instead of the production version.
Remember to set the parameter back to No when testing is completed.
Changing the ShowDebugVersion parameter does not require you to re-package the channel.
After thoroughly testing your Roku channel and verifying that it operates as expected,
upload the same Pkg file to your Developer Account again,
except this time overwrite the production channel:
Log into your Roku Developer Account again.
Click Manage My Channels.
Locate and click the large icon for the channel you are updating.
Click the Preview and Publish pull-down list and select Package Upload.
Increment the Channel Version number,
otherwise the updated channel will not be published.
Click the Upload a package button, then locate and click on the recently updated
channel's Pkg file.
The name of your Pkg file should appear in the box where the Upload a package button was.
Check the I'm not a robot box.
Click the blue Save button.
Click the blue Submit for Publishing button.
If this is a public channel in the on-screen Roku Channel Store,
it will not be published immediately.
Instead, the channel must go through a shortened version of the Roku
approval process again.
To speed up the approval process,
be prepared to briefly explain to Roku the changes that were made to the channel.
For example: "Updated from Legacy SDK to SceneGraph. No content was changed."
If you used a clone,
do not delete the original version of the channel until at least 24 hours after
Roku approves and publishes the updated version of the channel.
This allows time for all subscribers to automatically receive the updated channel.
the updated clone version of the channel becomes
the production version of the channel and the
old original version of the channel can be deleted.
If you used a clone and the channel type is "Unlimited" or "Commercial",
a pro-rated credit is issued to your Instant TV Channel account
when the old original version of the channel is deleted.
- o -
Please see this
Quick 5-Minute Guide
for information about how to get started with Instant TV Channel.
Suggestions, comments, or questions about this Roku tutorial can be sent to .
Instant TV Channel
Instant TV Channel is a cloud-based tool for Roku developers and content providers that shortens development time and eases maintenance after deployment.