> For the complete documentation index, see [llms.txt](https://aidocs.thunkable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://aidocs.thunkable.com/getting-started/project-settings.md).

# Project Settings

### Overview <a href="#overview" id="overview"></a>

App settings is where you configure and customize various aspects of your app.

To view or change your app settings:

* On your project page, click the **gear icon** in the left sidebar.

### 1. Shared Settings <a href="#id-1.-project-settings" id="id-1.-project-settings"></a>

#### App Name <a href="#app-name" id="app-name"></a>

The app name is the public name you choose for your app. It is what is displayed on the Google Play Store or Apple App Store and that users see when they install your app on their device.&#x20;

The best practice is to select a short one or two-word app name. The maximum length of an app name is 30 characters.

The app name is different from the project name, which is displayed at the top of your project. While the project name is Thunkable-specific and may include details specific to your team, the app name is user-facing.

#### App Icon <a href="#app-name" id="app-name"></a>

Your app icon is the image that represents your app on your users' mobile devices. This icon will also appear on your listing in the Google Play Store or Apple App Store and as your project icon on Thunkable.

{% hint style="info" %}
This feature may only be available for Creators on certain Thunkable plans. Please refer to our [pricing page](https://thunkable.com/#/pricing) for more information.
{% endhint %}

For publishing to the iOS [App Store](https://docs.thunkable.com/publishing/publish-to-app-store-ios#upload-an-icon-and-enter-your-build-number-and-version-number), 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 Google Play and Apple App Stores, you will need to create a separate icon with a higher resolution. For [Google Play](https://developer.android.com/google-play/resources/icon-design-specifications#creating_assets), the current requirement is 500 x 500 px. For the [App Store](https://developer.apple.com/design/human-interface-guidelines/ios/icons-and-images/app-icon#app-icon-sizes), it's 1024 x 1024 px.

{% hint style="info" %}
**Note:** Your app icon image will be used on the splash screen.
{% endhint %}

### 2. Android Settings <a href="#id-2.-publishing-settings" id="id-2.-publishing-settings"></a>

#### Package name <a href="#app-bundle-id" id="app-bundle-id"></a>

This is a unique identifier for your app on the Play Store. This field is auto-populated upon project creation, but if you choose to modify it, please ensure you follow the requirements below.

**App (Bundle) ID Requirements:**

* The maximum length is 155 characters.
* It must have at least two segments (one or more dots) - ex. `com.domain.creatorname.appname`
* Each segment must start with a letter (i.e. none of the segments can begin with a number).
* All characters must be alphanumeric or an underscore.
* A character cannot have an accent (e vs ë).

**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.

### 3. iOS Settings <a href="#id-2.-publishing-settings" id="id-2.-publishing-settings"></a>

#### Bundle ID <a href="#app-bundle-id" id="app-bundle-id"></a>

This is a unique identifier for your app on the App Store. This field is auto-populated upon project creation, but if you choose to modify it, please ensure you follow the requirements below.

**App (Bundle) ID Requirements:**

* The maximum length is 155 characters.
* It must have at least two segments (one or more dots) - ex. `com.domain.creatorname.appname`
* Each segment must start with a letter (i.e. none of the segments can begin with a number).
* All characters must be alphanumeric or an underscore.
* A character cannot have an accent (e vs ë).

**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, such as the camera, you must add purpose strings for any relevant components in your app if you want to publish it to the App Store.

**Tracking Usage Description**

If your app or any external service your app interacts with is gathering any type 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.&#x20;

If your app does contain AdMob, you could set the following Tracking Usage Description:&#x20;

This identifier will be used to deliver personalized ads to you.