Start typing to search...

List your app in the App Store

After you create, test, and publish your app, you can share its production URL or list the app in the Koji App Store.

The Koji App Store is the marketplace for all Koji apps. When creators edit their Koji profile, they can choose to add an app from the App Store.

By listing in the Koji App Store, you can take advantage of the traffic in the App Store to get exposure for your app. Koji also announces noteworthy apps in social media posts.

This topic shows how to create a Koji App Store listing after you move your app to production.

Preparing your marketing assets

You need the following marketing assets for your App Store listing:

  • A 500x500-pixel icon to be displayed with your listing in the App Store.

  • A 1200x630-pixel thumbnail to be displayed when your listing is shared in other social media sites.

  • Up to 10 videos and screenshots of your app.

  • The production URL of your app. To get this URL, go to the app’s associated Project Details, click View Published Koji, and copy the URL from the browser’s address bar.

Tip
For a smoother process, prepare your marketing assets before you create your listing.

Creating an App Store listing

To create your App Store listing,

  1. Go to your Developer Portal page.

  2. Click My App Templates.

  3. Click New App Template.

  4. Give your listing a name.

    This name is not published in the App Store; it is used to identify your listing.

  5. Fill in the App Template Details.

    Important
    All texts and images in your listing must meet Koji’s Terms of Use requirements.
    • Icon – The 500x500-pixel icon displayed with your listing.

    • Name – The title of your listing. Note that the title could be truncated depending on the width of the browser page; therefore, place distinguishing words near the beginning.

    • Subtitle – A short tagline that appears below the app name in category lists.

    • Description – Features and benefits of your app.

    • Share Image – The 1200x630-pixel thumbnail that is displayed when your app listing is shared in other social media sites.

    • Videos and Screenshots – Up to 10 videos and screenshots of your app.

    • Bundled App – The production URL of your app.

    • Price to Remix – The price (in US dollars) that the creator pays to publish their customized version of your app. Creators are charged only when they publish their customized version in their Koji profile. You keep 85% of this amount; Koji receives 15%. Leave blank to allow the creator to publish their customized version for free.

    • Transaction Fee Percent – The percentage you wish to collect from each transaction if your app allows in-app purchases. You keep 60% of this percentage; Koji receives 40%. Leave blank to collect the default percentage (15%).

      For example, if you set this to 10% and the user paid $10 in the app,

      • The creator who added your app to their profile receives $9.00.

      • You receive $0.60.

      • Koji receives $0.40.

    • This template is open source – If enabled, other developers can view and fork your app’s source code.

    • This template is intended primarily for developers to fork – If enabled, your app listing will include a Fork button (instead of a Use button) and the message:

      This app is designed for developers to use when creating new apps.

    • Variants – (Optional) URLs to the App Store listings of other variations of the app.

    • Attachments – (Optional) Links to other sites that provide more information about your app, such as documentation about your app, YouTube tutorials, news articles, and product comparisons or reviews.

  6. Click Save and Publish.

    Note
    The version number of your published listing is different from the version number of your published app shown in your Project Details.
  7. Fill out and submit the request form to add your listing to the App Store.

    You will be notified when your listing is approved and posted in the App Store.

Updating an App Store listing

When you publish a new version of your app, you don’t need to update your App Store listing because the permanent link to your app remains the same.

However, if you need to change the description or screenshots in your listing, you must create a new listing. The old listing is not modifiable.

  1. Go to your Developer Portal page.

  2. Click My App Templates.

  3. Search for the listing you want to update.

  4. Click the Manage button for the listing.

  5. In the App Template Details page, click the Create New Version link.

    Most of the settings from the old listing will be copied to the new one.

  6. Click Save and Publish.

    If you’re not ready to publish your new listing, you can also do the following:

    • To save your changes without publishing, click the Save Changes button.

    • To discard the draft, click the Delete Version link.

  7. Fill out and submit the request form to add your listing to the App Store.