Publish Your Ring Application
After your app passes certification, the Publish phase lets you control how it reaches Ring users. You can roll out gradually, to a closed beta group, or to everyone at once.
Prerequisites
- At least one app version has passed certification (status: "Certified version available for rollout")
- Your production endpoints are stable and ready for traffic
Accessing the Rollout Process
From your app's overview page, click the Publish section (step 5 in the app lifecycle). This opens the Rollout process page.
If a certified version is available, you'll see a banner confirming it along with an Initiate rollout process button. You also have access to:
- Review Version History — a log of all app versions, their statuses (e.g., Certification Under Review, Deployment Pending, Certification Withdrawn), and last-active timestamps.
Initiating a Rollout
Click Initiate rollout process. The rollout plan screen presents three configuration steps:
1. Distribution Location
This controls the geographic availability of your app — which Ring users can discover and install it.
Click the Distribution location card to open the location picker. You have two options:
- United States (Nationwide) — available to all Ring users across the US.
- Specific US States — restrict availability to selected states only. A checklist lets you pick individual states or use "Select all."
Distribution is currently limited to the US. International locations are not yet supported.
Choose your target region and click Save.
2. App Version
The certified version is pre-selected (e.g., v1 (Certified 02/06/2026)). Verify this is the version you intend to release.
3. Rollout Strategy
Pick one of three strategies:
| Strategy | Description | Use case |
|---|---|---|
| Gradual rollout | Deploy to a percentage of users, then increase over time up to 100%. | Minimize risk on new launches or major updates. |
| Beta rollout | Deploy to a closed group of beta testers via an invite link. | Validate with real users before a wider release. |
| Full rollout | Deploy to 100% of users immediately. | When you're confident the app is production-ready. |
Once everything looks right, click Confirm.
Rollout Strategy Details
Gradual Rollout
After confirming a gradual rollout, the portal shows a progress bar with your current rollout percentage (starts at 0%).
You control the pace by increasing traffic through the following stages:
- 10% — initial increment to validate stability with a small audience.
- 30% — expand after confirming no issues at 10%.
- 70% — broader rollout before full release.
- 100% — complete the rollout to all users in your selected distribution location.
At each stage, a button lets you advance to the next increment or skip ahead to 100%. A Roll back button is available to revert the deployment at any stage before 100%.
Beta Rollout
After confirming a beta rollout, the portal generates a Beta Enrollment URL.
Share this URL with the Ring users you want as testers. When they visit the link, they confirm participation in your beta program — no need to collect email addresses on your end.
Key details:
- Maximum of 10 beta users per app.
- A Rollback button lets you revert the beta deployment at any time.
When beta testing is complete and you're satisfied with the results, you can proceed to a wider rollout (gradual or full) by initiating a new rollout for the same version.
Full Rollout
Selecting full rollout triggers a confirmation dialog warning that the app will become available to all Ring customers on the Appstore.
Review the warning, then click Rollout to production to proceed, or Cancel to go back.
Once confirmed, the app deploys to 100% of users in your selected distribution location immediately.
After Rollout
When your app is live, the Rollout process page shows a success banner confirming the version is in production.
A Live configuration section displays your app's details:
- App name
- App type
- OAuth client ID
- Access token URL
From here you can:
- Click View in Appstore to see your published listing.
- Update the Distribution location at any time.
- Access Review Version History to track all versions.
Rolling Back
During any active rollout (gradual, beta, or full), a Roll back button is available on the Rollout process page. Use it if you discover issues post-deployment. The rollback reverts your app to its previous state.
Once a rollout is fully complete and you need to make changes, submit a new app version through the certification process.
Version History
Click Review Version History from the Rollout process page to see a table of all app versions with:
- Version number (v1, v2, v3, …)
- Status (e.g., Deployment Pending, Certification Under Review, Certification Withdrawn)
- Last active date
The summary at the top shows total versions, the current live version, and the latest version number.
Private Use Apps
If you want to build a Ring integration for a small, known group of users — such as a household, a small team, or an internal tool — you can create a private app. Private apps bypass the certification process and are never publicly listed on the Ring Appstore. Users connect through the standard Ring OAuth flow and access the app through the Ring App Store, where it appears with a private badge showing the app name and icon only.
Key details:
- No certification required
- Maximum 5 Ring accounts on the allowlist
- Available to Ring accounts from any country
- App appears in the Ring App Store with a private badge (name and icon only, no description or pricing)
- Basic Ring plan required
- Developer account sharing via the vendor/employee system supports up to 100 people (separate from the 5-account allowlist)
Private app lifecycle
Private apps follow a shorter lifecycle than public apps. The Configure and Build phases are the same, but private apps skip Test, Certify, and Publish — replacing them with a single Connect phase where you allowlist users directly.
| Phase | Private apps | Public apps |
|---|---|---|
| Configure | App Information, Account Linking | App Information, Account Linking |
| Build | Ring MCP, API Documentation | Ring MCP, API Documentation |
| Connect | Allowlist up to 5 Ring accounts | — |
| Test | — | Up to 10 staging users |
| Certify | — | Privacy & legal review |
| Publish | — | Gradual, beta, or full rollout |
Steps
- Navigate to the Ring section in the Amazon Developer Portal. The apps page has two tabs: Public Apps and Private Apps. Select the Private Apps tab, then click Create new app.
- Enter an Internal App name and under App type, select Private app — "Create a private integration exclusively for personal use or testing. Bypasses the certification process and Appstore listing."
- Check "I agree to the Ring Appstore Schedule to the Amazon Developer Services Agreement" and click Create New App.
- Download and save your app credentials, check the confirmation checkbox, then click Continue to App.
- Complete the Configure phase:
- In App Information, add an app logo (optional) and save.
- In Account Linking, enter your Account Link URL, Token Exchange URL, and optionally your App Homepage URL and Webhook URL. Save when done.
- Complete the Build phase — implement your Ring API integration using the Ring MCP server or the API documentation.
-
In the Connect phase, add the Ring accounts that will have access to the app. The Connect step becomes available once Account Linking is configured. Click Connect to expand the section — it shows the number of currently connected accounts (out of the maximum of 5) and two controls: Disconnect all and Connect Ring account.
To add an account, click Connect Ring account and sign in with the Ring account credentials, including the two-factor authentication code if prompted. Once authorized, the connected account count increases. Repeat for each account you want to add, up to 5.
- Your accounts can now find and access the app in the Ring App Store, where it appears with a private badge.
Related topics
- Certify Your Ring Application — Certification process and submission guide
- Getting Started with Ring Developer Experience — Registration, lifecycle overview, and key terminology
- Ring Appstore Schedule — Terms of the Ring Appstore Program
