--- title: Create a Project description: Set up a project for one app across its App Store and Google Play listings. --- A project in Apptonomy represents **one app across both stores**. You add the app's App Store listing, its Google Play listing, or both, and everything else — audits, keywords, the live listing, notifications — hangs off that project. Create one when you start work on a new app. ## Before you start - Any role in the organization can create a project: Owner, Manager, or Standard. Connecting store credentials during setup needs the Owner or Manager role. - Your plan needs an available project slot. If you're already at your plan's project limit, the **New Project** button shows an upgrade prompt and the wizard won't open — see [Plans & entitlements](/docs/billing/plans-and-entitlements). - Have the app in mind. You can find it by name, paste a store URL, or connect store credentials during setup. None of that is required to finish — you can skip credential linking and add it later. ## Open the wizard 1. Go to your organization's **Projects** list. 2. Click **New Project**. The wizard opens in a dialog titled **Create Project**. A one-line reminder under the heading states that each project represents one app across its App Store and Google Play listings. ## Walk the wizard ### 1. Find your app The first step asks **What app?** and gives you three tabs: - **App Search** — type the app name into **Search for your app by name**. Results show the icon, developer, and which store each result is on. Pick one. - **Listing URL** — paste an App Store or Google Play listing URL. Use this when search doesn't surface the app. - **Unpublished App** — for apps not yet on a store. This tab appears only when **Launch Readiness Check** is switched on for your organization; it opens a form for your draft listing text and creatives. After you pick a result, a confirm card appears with a **region and language** picker. Adjust the App Store region or Play Store country/language if the defaults are wrong, then continue. **New search** clears the selection if you picked the wrong app. :::note[Which store you pick first is the "primary" store] The store of the app you enter first becomes the project's primary store. The wizard then offers to add the other store as a second listing. ::: ### 2. Connect store credentials (optional) Apptonomy offers to connect your store account for the app you just chose. Connecting unlocks reading your live listing details, publishing approved changes, and analytics. You can connect now or skip and do it later from project settings. For what the connection grants and how to set it up, see [App Store linking](/docs/store-setup/appstore-credential) and [Google Play linking](/docs/store-setup/playstore-credential). ### 3. Add the other store (optional) Next the wizard asks **Add a \{store\} listing?** (naming the opposite store from the one you entered). A project can hold both an App Store and a Google Play listing for complete cross-store coverage. - Click **Add \{store\} Listing** to add it. Apptonomy looks up the matching app on the other store in the background, so the next screen is often pre-filled for a one-click confirm. You can still search, paste a URL, or adjust region and language. - Skip if this app only ships on one store. If you add the second store, you get the same optional credential-connect step for it. ### 4. Name the project The wizard suggests a name derived from the app's store listing. Keep it or type your own in **Enter project name**. This is the name you'll see in the project switcher and lists. ### 5. Choose an audit cadence On **Automated Audits**, pick how often Apptonomy re-runs the ASO audit and emails the results: **Off**, **Monthly**, **Biweekly**, **Weekly**, or **Daily**. - Available cadences depend on your plan. Faster cadences require a plan that includes them; the wizard only shows the ones you're entitled to and defaults to the fastest available. - When enabled, audits run at **6:00 AM UTC** on the chosen cadence, and reports go to the account owner; other members can opt in from their email preferences. - If your plan doesn't include automated audits, the step says so and you can still run audits manually anytime. You can change this later in the project's scheduled-audits settings. ### 6. Review and create The summary shows a card for each store you added, with its listing details and whether credentials are **linked** or **not linked**. Click **Create Project**. ## Verify it worked The project is created and you land on its **Watchtower** dashboard. The new project appears in the project switcher and the organization's project list. If you connected credentials, the store shows as linked; if you skipped, you can connect from settings later. To get your first scores, run an audit — the Watchtower shows a **Run Full Audit** button when no audit exists yet. See [The Watchtower dashboard](/docs/projects/watchtower). ## Troubleshooting ### The New Project button shows an upgrade prompt instead of opening the wizard {#new-project-button-shows-upgrade} You're at your plan's project limit. The wizard is gated before it opens so you don't build a project you can't save. Upgrade or free a slot, then retry. See [Plans & entitlements](/docs/billing/plans-and-entitlements). ### Search can't find my app {#cant-find-app-in-search} Switch to the **Listing URL** tab and paste the app's App Store or Google Play listing URL. New or region-limited listings sometimes aren't in the search index yet, but the URL path resolves them directly. ### The confirm card shows the wrong region or language {#wrong-region-language} Use the region and language picker above the confirm card to set the correct storefront before continuing. Apptonomy pulls the listing text from the storefront you select here. ### I closed the wizard and lost my progress {#lost-progress-on-close} Once you've selected the first app, closing the wizard asks you to confirm before discarding. If you confirm, progress is cleared and you start over. Nothing is saved until you click **Create Project** on the final step. ## Related - [Navigating a project](/docs/projects/navigation) - [The Watchtower dashboard](/docs/projects/watchtower) - [App Store linking](/docs/store-setup/appstore-credential) - [Google Play linking](/docs/store-setup/playstore-credential)