STEP 1:
Set Up Your Account
Set Up Your Account
Step 3: Test Your Catalog in Staging
Important: Catalog integration is available to select partners only.
Before you submit your catalog to Amazon for acceptance, you must thoroughly test your content integration on a Fire TV device in the staging environment. By validating your catalog, you make sure that your content is discoverable, displays correctly, and deep links function as expected for all user scenarios.
Prerequisites
Before you test your catalog, make sure you complete the following:
- Any related integration required for your content type:
- Fire TV Launcher Integration – Required for VOD and live event content (supports validation of deep links and entitlements).
- Linear TV Integration – Required for linear and broadcast content (supports validation of station tuning).
- To see your staging catalog on a device, send a list of test devices for Amazon to add to an allow list. This is part of your account setup in Provide details to set up your account.
Test scenarios
Complete the following test scenarios for each content type in your catalog (VOD, live event, and linear).
| Test category | Test steps | Expected Behavior |
|---|---|---|
| Voice search |
|
Your content title appears in the search results. Note: You might need to scroll across titles within a row or scroll across multiple rows to find your content title in the search results. |
| Detail page offers |
|
|
| Deep link for entitled user |
|
Content starts playing within your app. Note: A user might need to select a profile on your in-app picker screen before content playback begins. |
You must document your test results as part of the catalog acceptance process. For details instructions see Step 4: Receive Catalog Acceptance from Amazon.
Troubleshooting guide
Review the following solutions if you encounter problems during testing.
Issue: Content doesn't appear in search results
Symptoms
When you search for your content, it doesn't appear in the search results. This problem can occur for any of the following reasons:
- The catalog file has missing or incomplete search metadata.
- The search phrase you used doesn't match the catalog titles.
- The content isn't properly indexed for search yet.
Try this
- Verify your catalog file includes all required search metadata fields and images. Check the title, description, and keyword fields.
- Try searching with alternate title variations.
- Wait for eight hours for search indexing to complete.
Issue: Your offer doesn't display on the detail page
Symptoms
When you navigate to a content detail page, your offer doesn't appear. This problem can occur if the catalog file has missing or incorrect offer data, such as incomplete entitlement information or an incorrect availability window.
Try this
- Verify that your catalog submission includes offer data with entitlement information.
- Verify that the offer object structure matches the schema.
- Confirm that the availability dates are current.
Issue: Deep link opens browser instead of app
Symptoms
When you select a deep link, the content opens in a browser instead of your app. This problem can occur for any of the following reasons:
- The deep link URL format is incorrect.
- The app intent filters aren't configured properly.
- The app isn't installed or isn't on the allow list for the test device.
Try this
- Check that the deep link URL formatting matches the expected pattern.
- Verify the app intent filters in the Android manifest are correct.
- Confirm that the app is installed and on the allow list for the device.
- To isolate the issue, test the deep link URL directly by using an Android Debug Bridge (ADB) command. If the link works through ADB but not through Fire TV, the issue is likely outside your app and requires further investigation.
Issue: Autoplay not working for entitled users
Symptoms
When an entitled user selects content, it doesn't autoplay in your app. This problem can occur for any of the following reasons:
- Entitlement verification is failing.
- Playback permissions aren't granted.
- Content rights restrictions are blocking playback.
Try this
- Verify that the test account has an active entitlement.
- Review the entitlement verification logic in your app and make sure it isn't rejecting valid entitlements. Update the logic if necessary.
- Make sure your app grants playback permissions for entitled users.
- Confirm that the content has proper rights and licenses for playback.
Issue: Wrong content plays or loads
Symptoms
When you select content, the wrong title plays or loads in your app. This problem can occur for any of the following reasons:
- There's a content ID mismatch between the catalog and the app.
- The deep link parameter is incorrect.
- The app routing logic has an issue.
Try this
- Verify that the content IDs match between your catalog file and your app.
- Verify the deep link parameters passed to the app are correct.
- Test with multiple content items to identify a pattern. If the same mismatch occurs across titles, the issue could be in the routing logic rather than individual content entries.
- Review the content routing logic in your app to make sure it's correct. If the logic maps IDs incorrectly, update the routing to match the IDs in your catalog file.
- Previous – Step 2: Upload Your Catalog to Staging
- Next – Step 4: Receive Catalog Acceptance from Amazon
Last updated: May 27, 2026
