App Settings

To view or change your app settings, click on the Settings gear icon in the menu on the left.

App Description

This is a description of your app and how you intend it to be used. It is not necessary to fill this out in Thunkable. If you publish your app you will need to enter this information, whether on Thunkable or the App Store or Play Store.

App Name

Your app name is the name you choose for your app. This is the name that is displayed on the Google Play Store or Apple App Store, and that users see when they install your app on their device. This name is also used to set the page title when you publish as a web app.

We recommend a short one or two word app name.

Avoid using the character "&" in your app name: at the moment, it prevents your app from being installed on your device

Default App Layout

Building an app in Tablet View is a Pro feature. Learn more about Pro.

This is where you can change the default designer layout for your app. Use this dropdown to set the default size of your project, choosing from the following options:

  • Phone + Portrait

  • Phone + Landscape

  • Tablet + Portrait

  • Tablet + Landscape

We recommend setting your Default App Layout before you start adding components to your app. Your layout will not automatically respond when you change your Default App Layout. Your existing components will not change size, and the distance between components will not change.

We recommend choosing a Default App Layout before you start adding components to your screen(s).

Project Name

This is not your app name! This is just the name of your project on Thunkable. When you create a new project, you will be prompted to create a project name. You can change this name at anytime by clicking on your project name in the top bar.

App (Bundle) ID

A unique identifier for your app on the App Store or Play Store.

This should follow a pattern like com.domain.creatorname.appname

Make sure none of the segments of this package name begins with a number. Ensure none of the letters in this package name has an accent (e vs ë).

Icon

Your app icon is the picture that represents your app on your mobile device. This icon will also appear on your listing in the Google Play Store or App Store, and as your project icon on Thunkable. Users on our personal plans will see the default "Made with Thunkable" icon appear when their apps load.

If your company needs to remove the Thunkable branding from an app, this option is available as a project setting to Business and Team customers.

Learn more about our plans.

Please ensure the file you upload does not have the same name as another asset you use in your app. This will cause an error.

Best Practices

Property

Setting

Size

192 x 192 px (minimum)

Shape

Square (equal height and width)

File Type

Preferably .png (vs. jpg or other file types)

For publishing to the iOS App Store, you will also need an app icon that does not have any transparency, or it may cause an error.

For publishing your app to the Play and App stores, you will need to create a separate icon with a higher resolution. For Google Play, the current requirement is 500 x 500 px. For the App Store, it's 1024 x 1024 px.

Public/Private App

PRO Thunkable users have the option to set their app to Private. A private app will not be displayed in the Thunkable Public Gallery. Learn more about Thunkable PRO here.

Auto-increment Version

When you publish to the App Store or the Play Store, you will need to increment (increase) your version number each time. If this switch is set to true, Thunkable will automatically increment your project's version number each time you publish your app (iOS) or download your app (Android).

AdMob Settings

iOS App ID

Enter the AdMob app ID for your iOS app. More info from AdMob here.

Android App ID

Enter the AdMob app ID for your Android app. More info from AdMob here.

Tracking Usage Description (iOS only)

If your app or any external service your app interacts with are gathering any kind of identifiable information, this must be explicitly disclosed to the end user of your app using an in-app prompt. If you do not include this and your app engages in tracking, Apple will reject your submission and ask you to resubmit while including an appropriate tracking string. To learn more about when to include a tracking string, click here.

Android

Version Name

Set a version name for this version of your Android app.

Version Code

Set a version code for this version of your Android app.

Keystore

Import and export an Android Keystore to/from your app. Learn more about the Android Keystore here.

iOS

Ignore Notch Area

This property enables you to remove the Safe Area View which Thunkable adds to the app automatically. If you set this property to be true, the screen background color will extend to full screen and there won’t be any white area. However, you need to manually take care of the notch in your app design, like adding extra space, in order to avoid the app element being blocked by the notch.

Notch Area Background Color

This property enables you to set the safe area view color. With this, you can customize the background color of the white area. Please note, this is an app level setting and you won’t be able to customize the color at the screen level.

Version Number

Set a version number for this version of your iOS app.

iOS Permissions

When you add components that require permissions to your app, like the camera, you will need to add purpose strings to your app if you want to publish it to the App Store.

You will be able to add purpose strings for any component you have added which explicitly requires a purpose string.

API Keys

If you use blocks for Translating, Image Recognition or Uploading media to the cloud, or use a Firebase database to support your cloud variables or Signing In, you can enter personal API keys for these components in the project settings.

Last updated

Change request #1203: