# How to Use State Manager

## State Manager

The MOTAR State Manager denotes what status the a listing is currently in for each step of the creation process. All listings will start in Sandbox status until requirements have been met allowing the user to promote it to Production status.

{% hint style="info" %}
Requirements for publishing can be found at the following links: [Listing Publishing](https://docs.motar.com/how-to/motar-core-services/using-motar-studio/how-to-manage-each-listing-type) 
{% endhint %}

## State Manager Overview

All courses and listings will start in Sandbox status until requirements have been met allowing the user to promote the course or listing to Production status. The charts below break down each state in the flow for asset creation and how the user can progress to the next state.

### State Manager - Non-App Listings 

<table><thead><tr><th width="326" align="center">State Indicator</th><th>Description</th></tr></thead><tbody><tr><td align="center"><img src="https://540871446-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJV84grXWXSLppsAzVKx%2Fuploads%2FYlnSuruJm515YFSwkYRt%2FNonAppCreateListing.png?alt=media&#x26;token=7e28c6a7-988b-4cb0-899e-faf529c267de" alt="" data-size="original"></td><td><p><strong>Sandbox - Create Listing</strong></p><p>When a new listing is created and has not been saved yet. If the user exits the listing creation before moving past this state the listing will not appear on the user's studio listings.</p></td></tr><tr><td align="center"><img src="https://540871446-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJV84grXWXSLppsAzVKx%2Fuploads%2F5vueVXSlGF1jgDcAklyt%2FNonAppIncomplete.png?alt=media&#x26;token=663b6755-f86a-41c4-a7f2-e241f1590e29" alt="" data-size="original"></td><td><p><strong>Sandbox - Incomplete Listing</strong></p><p>All required fields on the Info tab have been entered, and data has been saved, but not all the required information in all required tabs has been entered. The listing will appear on the user's studio listing page.</p></td></tr><tr><td align="center"><img src="https://540871446-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJV84grXWXSLppsAzVKx%2Fuploads%2Fyu2IKsLPce3rXAXRYAgX%2FNonAppReadyToPublish.png?alt=media&#x26;token=01a4ee6c-d0ee-4f2d-82ab-a194fbc331a3" alt="" data-size="original"></td><td><p><strong>Sandbox - Ready to Publish on MOTAR</strong></p><p>All required fields in all required tabs have been completed and the listing has been saved. The listing is ready to be viewed on Hub, tested using a Sandbox Course, or to be published to Production.</p></td></tr><tr><td align="center"><img src="https://540871446-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJV84grXWXSLppsAzVKx%2Fuploads%2FTdDk884suE9WP5aPSSJN%2FNonAppPublish.png?alt=media&#x26;token=be504c6d-35b8-4866-9256-9efaa3475435" alt="" data-size="original"></td><td><p><strong>Production - Published</strong></p><p>When a user has promoted a listing by selecting the publish button and has chosen to either Keep Permissions or Set New Permissions. The listing is promoted to Production. </p></td></tr></tbody></table>

### State Manager - App Listings

<table><thead><tr><th width="326" align="center">State Indicator</th><th>Description</th></tr></thead><tbody><tr><td align="center"><img src="https://540871446-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJV84grXWXSLppsAzVKx%2Fuploads%2FPUH7axLJ6y5atSPNMS52%2FAppCreateListing.png?alt=media&#x26;token=128be0dc-7d14-4030-bf9c-337996eb3cde" alt="" data-size="original"></td><td><p><strong>Sandbox - Create Listing</strong></p><p>When a new app listing is created and has not been saved yet. If the user exits the app creation before moving past this state the app will not appear on the user's studio listings.</p></td></tr><tr><td align="center"><img src="https://540871446-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJV84grXWXSLppsAzVKx%2Fuploads%2F7nHtTkgJ6mXqalSvMMqE%2FAppLocalTest.png?alt=media&#x26;token=8c8c4097-1b76-44c3-9605-8a2b7781a0eb" alt="" data-size="original"></td><td><p><strong>Sandbox - Local Test Only</strong></p><p>All required fields on the Info tab have been entered, and data has been saved, but not all the required information in all required tabs has been entered. The app will appear on the user's studio listing page.</p></td></tr><tr><td align="center"><img src="https://540871446-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJV84grXWXSLppsAzVKx%2Fuploads%2F3KmtwImzpBqU65tuMER3%2FAppUnderReview.png?alt=media&#x26;token=3c42adea-9b58-4692-b34d-8705ef8031b1" alt="" data-size="original"></td><td><p><strong>Sandbox - Under Review for Production</strong></p><p>After a user submits the app for review, the state manager updates to under review. The user will be unable to make any changes to the app during this time.</p></td></tr><tr><td align="center"><img src="https://540871446-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJV84grXWXSLppsAzVKx%2Fuploads%2FFbOazm7PxbvC8OHhiZZk%2FAppReadyToPublish.png?alt=media&#x26;token=abdcd231-3d12-4b08-9afb-9effed70f32c" alt="" data-size="original"></td><td><p><strong>Sandbox - Ready to Publish to Production</strong></p><p>All required fields in all tabs have been completed, the app has been approved, and the app has been saved. The app is ready to be viewed on Hub, tested using a Sandbox Course, or to be published to Production.</p></td></tr><tr><td align="center"><img src="https://540871446-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJV84grXWXSLppsAzVKx%2Fuploads%2FhvPKZen1kFaTUdcClrFu%2FAppPublish.png?alt=media&#x26;token=70055d03-58d2-4525-b2dd-3a8fcdd88362" alt="" data-size="original"></td><td><p><strong>Production - Published</strong></p><p>When a user has promoted an app by selecting the publish button and has chosen to either Keep Permissions or Set New Permissions. The app is promoted to Production. </p></td></tr><tr><td align="center"><img src="https://540871446-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVJV84grXWXSLppsAzVKx%2Fuploads%2FAiGK1Fy22kgU54nLR1G8%2FAppPublishReview.png?alt=media&#x26;token=f9c3feb6-5e81-4e18-af41-d4b1abab3134" alt="" data-size="original"></td><td><p><strong>Production - Listing Edits Under Review</strong></p><p>When a user has a Production App and wishes to make changes to it, they must resubmit it for review. The previously approved version of the application is still available on Hub during this Production Review. </p></td></tr></tbody></table>