📐
Thunkable Docs
Build an AppDrag and Drop DocsSnap to Place Docs
Snap to Place
Snap to Place
  • 👋Welcome to Thunkable Docs
  • 👶Getting Started
    • Signing In
    • Your Thunkable Projects Page
    • Tutorials
    • Live Test your App
  • 🆕Create New Project
    • Project Settings
    • Project Assets and Sizes
  • Thunkable Sample Projects
  • Public Gallery of Projects
  • 🛠️ Components
  • 🔘User Interface
  • Button
  • Label
  • Text Input
  • List Viewer
  • Web Viewer
  • Switch
  • Slider
  • Alert
  • Loading Icon
  • Date Input
  • Time Input
  • PDF Reader
  • Rating
  • 📊Data Viewers
  • Data Viewer List
  • Data Viewer Grid
  • Custom Data Viewer Layout
  • Data Sources
  • 📐Layout
  • Top Tab Navigator
  • Bottom Tab Navigator
  • Stack Navigator
  • Drawer Navigator
  • Screen
  • Row
  • Column
  • 📷 Image
  • Image
  • Photo Library
  • Camera
  • Barcode Scanner
  • Image Recognizer
  • Animation by Lottie
  • Video
  • Video Recorder
  • 🗄️ Data
  • Local Storage
  • Local DB
  • Realtime DB by Firebase
  • Airtable
  • Media DB by Cloudinary
  • File Picker
  • Web API
  • 🌍Location
  • Maps by Google and Apple
  • Location Sensor
  • 💲Monetization
  • Ads by AdMob
  • In-App Purchase
  • 🌐Sensors
  • Gyroscope
  • Magnetometer
  • Accelerometer
  • Timer
  • Bluetooth Low Energy
  • 🔊Voice
  • Sound
  • Text to Speech
  • Speech Recognizer
  • Translator
  • Audio Recorder
  • 🤝Social
  • Share
  • Email Sign In by Firebase
  • Push Notifications by One Signal
  • 🎮Gaming
  • Canvas
  • Sprites
  • Sprite Gallery
  • Canvas Label
  • 🤖Gaming Blocks🎮
  • Events
  • Motion
  • Looks
  • Direction
  • Sensing
  • Add & Remove
  • Stage
  • Canvas Label
  • 🤖Blocks
  • Control
  • Logic
  • Math
  • Text
  • Lists
  • Color
  • Objects
  • Device
  • Variables
  • Functions
  • "Any Component" Blocks
  • 🖥️ App Services & Emulators
  • 🔒App Data Privacy
  • ➕Make Copy
  • 📥Download
  • 📤Share
  • 📱Publish
  • Publish to App Store (iOS)
    • TestFlight Overview
      • TestFlight in Depth
  • Publish to Play Store (Android) with AAB
  • Publish as a Web App
  • Generate Screenshots
  • 🔎Troubleshooting
    • Login Issues
    • FAQs
  • 📏Intro to Spacing
  • 🖼️ Intro to Sizing
  • 🔤Fonts
  • 💾Managing Storage
  • 📝Bugs and Product Feedback
  • Snap to Place Hour of Code Videos
Powered by GitBook
On this page
  • Steps to Success
  • Prepare for Submission
  • Set a Version Number
  • Review your App Permissions
  • Create an Apple Developer Account
  • Create an App-specific password
  • Register an App ID on App Store Connect
  • Create an App Listing on App Store Connect
  • Send a Build to App Store Connect
  • Start the Publishing process in Thunkable
  • Enter your Apple Developer Account details
  • Register Your App ID
  • Enter your App Name, Team ID, and Bundle ID
  • Create a Distribution Certificate
  • Provision your App
  • Enter your App-Specific Password
  • Create an App Listing on App Store Connect
  • Upload an Icon and enter your Build Number and Version Number
  • Congratulations
  • Next Steps - App Store Connect
  • Connect Your Build to Your App Listing
  • App information
  • Pricing and availability
  • Design assets
  • Export Compliance
  • Advertising identifier
  • Click Submit!
  • Update Your App
  • Troubleshooting
  • Adding Push Notifications
  • Remove your app from the App Store

Was this helpful?

Export as PDF

Publish to App Store (iOS)

How to publish your Thunkable Project to the Apple App Store

PreviousPublishNextTestFlight Overview

Last updated 7 months ago

Was this helpful?

Publishing your app to the App Store can be a rewarding process.

Apple requires a lot information for apps that are available in their App Store. As a result, the publishing process can feel long and will require at least 20 minutes to complete the necessary steps on the Thunkable website, which currently requires information from 4 different Apple websites. We recommend completing the steps before starting the publishing process in Thunkable.

Thunkable is continually looking for ways to streamline the publishing process and has made it possible for creators to publish from a non-Mac computer, which is normally required by the standard publishing process.

In this document, the version of your app that you submit to the App Store is referred to as a build.

Apple holds a high standard for apps that are approved for distribution in the App Store so please to make sure your app is in compliance before you sign up for the Apple Developer Program

Steps to Success

Prepare for Submission

Set a Version Number

If this is your first time sending this app to App Store Connect, you can set the version number to 1. You will need to increment your version number, or increase it by 1, every time you submit a build to App Store Connect.

Review your App Permissions

User Tracking If your app shares trackable data with any third parties, you must tell your end user what data is being shared and why. This should be left blank if no trackable data is shared with third parties.

Create an Apple Developer Account

Create an App-specific password

If a developer uses a third-party platform like Thunkable to send an app build to App Store Connect, the developer needs to create an app-specific password.

You only need one app-specific password for Thunkable to send any build to App Store Connect on your behalf.

You do not need separate app-specific passwords for separate Thunkable projects.

You will need this password to send a new build to your App Store listing in the future, so make sure to record it securely.

Generate an app-specific password

Step 1: Enter your Apple ID and Password

Step 2: If prompted, enter your 6 digit authentication code.

Step 3: Once signed in, click on the Generate password... link highlighted above.

Step 4: Give your password a meaningful name so you will be able to recognise it later.

Step 5: You will not be able to retrieve this password once you click Done so make sure you save it some place safe.

Changing an App-specific password

To change an app-specific password, you will need to revoke your old password and generate a new password using the steps above. To revoke an app-specific password:

  1. In the Security section, click Edit

  2. Go to the App-Specific Passwords section and click View History

  3. Click the ⓧ next to an individual password to revoke it, or click 'Revoke All' to revoke all of your app-specific passwords

Register an App ID on App Store Connect

Every app published on the App Store must have a unique name. For example, there can only ever be one app called Thunkable Sample App. You can Register your App ID to reserve the name you want!

Step 6 in the tabs below shows you where to find your App Name, Team ID, and Bundle ID.

  • App Name: The app Name must be unique to the App Store and is what appears next to the app icon when it is downloaded on a user's phone.

  • Team ID: A unique account identifier that is linked to your Apple Developer Program membership. Apple will automatically create this for you, and it can be used for every app you publish.

  • Bundle ID: Also unique to your app, but not visible to your app users. Otherwise, a single Explicit App ID should work. Apple recommends reversing your domain name to create your bundle ID i.e. com.yourDomainName.yourAppName to avoid conflicts with other apps.

    • Note: Starting June 16, 2020, uploading apps to the App Store requires an explicit bundle ID. Wildcard bundle IDs are no longer available when creating app records.

Open your Apple Developer account page and choose the Certificates, IDs & Profiles option from the menu on the left hand side of the screen.

From the menu on the left, click on the Identifiers menu item

Click on the blue + icon to add a new ID to your account.

Choose App IDs from the list of options and then click on the blue Continue button to go to the next screen.

For the app Description enter the name you want to give your app and for the Bundle ID enter the bundle ID from your Thunkable project settings. Click Continue to review these details.

Once you are happy with these detail, click Register to confirm your app ID.

This new app ID is added to your list of app IDs.

Create an App Listing on App Store Connect

Once you have registered an App ID, you can create an app listing on App Store Connect. This is where you will manage your submission to the App Store.

Click My Apps to create a new app and to manage your existing apps.

Click the blue + button to create a new app

You will need to use the same App Name and Bundle ID you registered earlier. If you registered an 'Explicit App ID', you will enter it into the Bundle ID field above.

Now click on your app name to prepare your store listing.

Send a Build to App Store Connect

Start the Publishing process in Thunkable

Thunkable enables you to send your build directly to the App Store without the need for any specialized software or hardware. To begin the process, click on the Publish icon and choose Publish iOS from the drop-down menu.

A publishing dialog will pop up to guide you through the publication process. Please take a moment to read all the instructions.

Click the Get Started button to proceed.

Enter your Apple Developer Account details

Register Your App ID

If you did not register an App ID before getting started, now is the time to do so.

Enter your App Name, Team ID, and Bundle ID

Create a Distribution Certificate

This step should only need to occur once. Although you need a different provisioning file for each project, your Account Certificate should remain the same between any projects published with Thunkable. Once you issue a new certificate, that will be good for a period of 1 year from the date of creation. You should be able to publish as many apps as you want with that 1 distribution certificate for you (the publisher) and 1 provisioning file per app (per published Thunkable project) A certificate is specific to the email account that was used to create the certificate. I.E. If you are helping another Thunker publish their app, you would need to log in and publish from that users account using their certificate.

Two-factor authentication helps to keep your account secure and Apple has made it mandatory for new developers to turn two-factor authentication on. If you do have 2FA turned on, you'll need to complete the following steps to confirm your identity with Apple.

Thunkable

In the publishing dialog, click the link that says Click to Download CSR. This is your Certificate Signing Request file and you will need it to generate an iOS Distribution Certificate.

Apple

You may already have an account certificate in your account. You can only have two certificates per account so you may need to revoke a certificate before you can create a new one.

Click on the blue + icon to create a new iOS distribution certificate.

Choose iOS Distribution (App Store and Ad Hoc) from the next list and click Continue.

Click the blue Download button to save a copy of this certificate to your computer.

Back in Thunkable, click the Upload Certificate button and choose the .cer file that you have just created.

Provision your App

Provisioning profiles are required by Apple to install an app on a device. You need to create a .mobileprovision file in your Apple account and then return to Thunkable to upload this file.

Apple

Make sure you are creating a Distribution profile and that the App Store option (highlighted above) is selected. Click Continue to choose an App ID.

From the drop down menu, choose the ID for the app that you are trying to publish. Click Continue to go to the next page.

Choose a certificate and click Continue.

Finally, give your provisioning profile a meaningful name and hit the Generate button.

Once the provisioning profile has been generated you can then Download it to your computer.

The profile has a .mobileprovisionfile type. You now need to go back to Thunkable and upload this file.

Thunkable

Back in Thunkable, upload your .mobileprovision file and click the Next button to proceed.

Enter your App-Specific Password

Create an App Listing on App Store Connect

If you did not create an app listing on App Store Connect before getting started, now is the time to do so.

Upload an Icon and enter your Build Number and Version Number

You're almost there! Review your app icon and your Build Number and Version Number.

App icon: This app icon appears when a user downloads your app from the App Store. Our recommended size is 192 x 192 px. This icon must not have any transparent pixels.

Build and Version Numbers: The version number is visible to your users when they download a new version of your app. The build number needs to increase with each version and is only visible to you. You can opt to let Thunkable automatically increment your build and version numbers.

Congratulations

You should shortly receive an email from Thunkable to let you know that your build is being sent to the App Store. There are still a number of steps that you need to complete on App Store Connect before your app can be published, but that's everything completed from the Thunkable side of things - congrats!

Next Steps - App Store Connect

You will need to provide some information to Apple about your app before it can be reviewed and published.

Connect Your Build to Your App Listing

You should receive an email from Apple that says your app is ready in the App Store Connect website. This may take up to an hour.

To view your build:

  • Go to your App Store Connect dashboard

  • Select the app listing of the build you have just uploaded

You will see the app listing homepage. This page contains the tabs App Store, Features and TestFlight.

(If there are any issues, you’ll get an email from us telling you what you’ll need to fix.)

Back in the App Store tab, scroll down to the section titled Build and click the button that says Select a build before you submit your app.

You will see a dialog that allows you to select a build to attach to this app listing. Select your chosen build and click Done.

App information

Pricing and availability

Set a price point for your app. Apps can also be distributed for free.

Design assets

The final section requires screenshots for both iPhone and iPad and a high resolution icon.

Export Compliance

You may need to answer a question about export compliance. Select Yes when asked if your app uses encryption.

Advertising identifier

After submitting your app for review, you may asked, "Does this app use the Advertising Identifier (IDFA)?"

The app will still be able to be published but you will want to check the following three boxes:

Note, you should not check the box labeled Serve advertisements within the app.

Click Submit!

Now your app listing is ready for Apple to review!

Update Your App

Troubleshooting

You do not see your app uploaded to App Store Connect

  • Download. One way to check if your app is build-able is to download it to your phone first. Two common download errors are:

    • You uploaded an icon that has the same name as an existing asset that you have uploaded

    • Your app icon is not an image file

  • Icons. Apple additionally does not allow you to have any icons with any transparent colors. We recommend app icons to be 192 x 192 px

  • Certificates. If you have an existing Apple Developer Program account with 2 iOS certificates, you'll have to revoke one. Apple only allows developers to have 2 iOS certificates at a time and Thunkable creates one when it publishes to your account

  • Provisioning profile. After you revoke your certificate, it is possible that one or more of your provisioning profiles will become inactive. To publish successfully, you'll also need to delete any inactive provisioning profiles

  • Login. Apple ID or password were entered incorrectly. Since we don't store either one, there's no easy way for us to check so enter it slowly

  • Apple ID and privacy terms. You must accept Apple's new Apple ID and privacy terms.

Your app on iOS is inaccessible and your end user sees an error screen saying your app is unavailable.

  • You switched to the Free plan.

  • Your App (Bundle) ID doesn't match your Active Bundle ID and you may need to enable it in your Account Settings before the app can be used.

Changes can take up to 24 hours to be applied. If you change the status by mistake please change it again as soon as possible to avoid issues.

Adding Push Notifications

To publish an app to the App Store that contains Push Notifications, you need to:

  • send an app that does not contain Push Notifications to App Store Connect

  • send the new version of your app to App Store Connect

Between sending these two versions of your app to App Store Connect, you will need to create a new .mobileprovision file. Here's a quick overview of what that process looks like.

Click on Provisioning Profiles > All to see your current iOS provisioning profiles. Notice that the app you just created is now invalid so we need to generate a new one.

Open the inactive profile and click on Edit to generate a new one.

Scroll to the bottom of the page and click Generate.

On the next screen, click the Download button and the .mobileprovision file will be saved to your downloads folder.

Remove your app from the App Store

  1. On the “App Store” tab, click on “Pricing and Availability”

  2. Click the “Remove from Sale” radio button

  3. Then click the “Save” button to unpublish your app

You can see these buttons in the screenshot below:

Please note that if your Apple Developer account expires, your apps will no longer be available for download in the App Store.

Removing your app from the Play Store will not delete it from devices which have previously downloaded the app.

You will need to set a version number in your project. You can set your version number in the under iOS > Version Number.

Apple requires that you explain to users why you may need access to sensitive services like a camera, photo library and microphone. You can add these explanations in the under iOS Permissions.

To learn more about when to include a tracking string,

You will need an Apple Developer Account to publish an app to the App Store. To obtain a developer account you must enroll in the . An Apple Developer Account costs $99/year.

Certain educational institutions qualify for free Apple developer accounts. To check if your school or university if eligible, please visit .

Go to the and create an app-specific password.

Sign into your

Go to the to register a new App ID. Click through the tabs below to see each screen in the ID creation process.

Go to the and follow the steps below to create your App Store listing with the App Name and Bundle ID you registered earlier.

Enter the Apple ID that is associated with your . Click the Next button to proceed.

In the next tab, you will be prompted for your App Name, Team ID and Bundle ID. If you are unsure of what these are, please refer , above.

Go to the in your Apple Developer account to generate an iOS Distribution Certificate.

Upload the you download from Thunkable and click Continue to get your certificate.

Open up the in your Apple Developer account and click the blue + button to get started.

Paste your into the empty text box and click the Next button to proceed.

If your build is submitted successfully, it should appear under the TestFlight tab in this app listing homepage. is a tool from Apple that allows you to test your app before it is submitted for release in the App Store.

Now you can review the App Information included in your App Store tab. You can review Apple's advice on filling in your app information on .

The high resolution icon will be featured in the App Store listing and must be 1024 x 1024 px with no transparency. To generate this icon, we recommend a tool .

You can see the screenshots you need in Apple's .

You can create your own iOS screenshots in your browser. Learn more here:

To update an existing App Store listing, follow the instructions on Apple's website .

For Step 6, Upload your new build to App Store Connect, follow the instructions in .

Membership. To publish to the App Store, you'll need to sign up for . This currently costs $99 / year.

App Store Connect. Make sure to on creating a new app on iTunes Connect

You see a message saying "ITMS-90809: Deprecated API Usage - Apple will stop accepting submissions of apps that use UIWebView APIs". This is a warning, but you can still publish your app. See the documentation for more details.

Go to the to see your published Bundle IDs. You will see how many published apps you have available and be able to select which published app you wish to keep active.

add push notifications to your app project ()

If you want to remove your apps from being listed in the App Store, open your app listing on and follow these instructions:

Project Settings panel
Project Settings panel
click here.
Apple Developer Program
this Apple site
Apple ID account website
Apple ID account page
Apple Developer website
App Store Connect website
Certificates page
Profiles list
TestFlight
this webpage
like this
screenshot specifications document
Generate Screenshots
here
Apple Developer Program Membership
Web Viewer
settings page
App Store Connect
Prepare for Submission
Send a build to App Store Connect
Next Steps - App Store Connect
Set a Version Number
Review Your App Permissions
Create an Apple Developer Account
Create an App-Specific Password
Register an App ID on App Store Connect
Create an App Listing on App Store Connect
Start the Publishing Process in Thunkable
Enter your Apple Developer Account Details
Register Your App ID
Enter your App Name, Team ID and Bundle ID
Create a Distribution Certificate
Provision your App
Enter your App-Specific Password
Create an App Listing on App Store Connect
Upload an Icon and enter your Build Number and Version Number
Apple Developer account
Read our instructions here.
Register an App ID on App Store Connect
Certificate Signing Request
app-specific password
Read our instructions here.
Connect Your Build to your App Listing
App Information
Pricing and Availability
Design assets
Export Compliance
Advertising Identifier
Click Submit!
Send a Build to App Store Connect
review Apple's policies and guidelines
Prepare for Submission
see instructions here
follow this step