Thunkable Docs
Build an AppDrag and Drop DocsSnap to Place DocsAcademy
Drag and Drop
Drag and Drop
  • What is Thunkable?
  • 🗺️Getting Started
    • Getting Started Guide
    • Keyboard Shortcuts
    • Undo Redo
    • Thunkable Account
      • Account Management
    • Preview and Test your App
    • Versioning
    • Data Sources
      • Google Sheets Data Source
      • Airtable Data Source
      • Webflow Data Source
      • Local Table Data Source
    • Project Collaboration
      • Organizations
    • 🎓Sample Apps & Tutorials
      • Thunkable Community Forums
      • Sample Apps
      • Video Tutorials
        • Thunkable Live App
          • How to Test and Troubleshoot with Thunkable Live App
        • Data Source Tutorials
          • Connecting to Data Sources
            • Google Sheets
            • Local Table
          • Create Data in a Thunkable Data Source
          • Read Data in a Thunkable Data Source
          • Update Data in a Thunkable Data Source
          • Delete Data in a Thunkable Data Source
        • User Auth & Management
          • Firebase
            • User Sign-Up, Sign-In, and Auth
            • User Sign Out and Password Reset
          • Google
            • User Sign-Up, Sign-In, Sign-Out, and Auth
          • Apple
            • User Sign-Up, Sign-In, Sign-Out, and Auth
        • Projects
          • How to Save Versions of Your Thunkable Project
          • How to Copy and Customize Public or Sample Thunkable Projects
        • User Interface & Design
          • Screens
            • Save and Reuse Thunkable Screens
            • Change Thunkable Screens with a Button Click
            • Create Scrollable Screens in Your Thunkable App
          • Navigators
            • How to Use the Thunkable Stack Navigator
            • How to Use Thunkable Top and Bottom Tab Navigators
            • How to Use the Thunkable Drawer Navigator
            • Combine Figma Frames with Thunkable Navigators
          • Components
            • How to Use the Visibility Property to Create Modals in Thunkable
          • Data Visualization
            • Customize a Data Viewer
          • Text
            • Implement Text Input Validation
        • Alerts & Notifications
          • Display Alert Messages in Your Thunkable App
          • How to Create Three-Button Alert Messages
        • Files
          • Cloudinary
            • Store and Access Cloudinary Files in Your Thunkable App
        • Camera
          • How to Use the Device’s Camera
          • How to Use the Device’s Video Camera
          • Use the Device’s Camera as a QR or Barcode Scanner
        • Realtime Databases
          • Firebase
            • How to Read Data in a Firebase Realtime Database
            • How to Update Data in a Firebase Realtime Database
        • Advanced Blocks
          • Connect Your Thunkable App to a Web API
        • Thunkable Academy
          • Building Your First Thunkable App
            • Getting Started with Thunkable
            • How to Design a Thunkable App
            • How to Connect a Thunkable App to a Data Source
            • How to Make A Thunkable App Interactive with Blocks
          • Thunkable No Code App Creation Basics
            • Thunkable UI Components and App Features
            • Understanding Thunkable's Drag and Drop Block Builder
            • Design, Develop, Debug, and Deploy Your App
        • Hour of Code
          • 2021 - Build an Informational App
          • 2022 - Build a Scavenger Hunt App
          • 2023 - Build a Translator and Text-to-Speech App
        • App Building
          • How to Build a Translation App in Thunkable
          • How to Create an Image Recognition App with Thunkable
          • How to Create a Text-to-Speech App in Thunkable
  • 🎨App Design
    • User Interface (UI) Components
      • Basic Components
        • Button Component
        • Label Component
        • Rich Text Component
        • Image Component
        • Text Input Component
        • Layout Component
        • Group Component
      • Data Components
        • Simple List Component
        • Data Viewer Components
          • Data Viewer List Component
          • Data Viewer Grid Component
          • Custom Data Viewer
      • Input Components
        • Switch Component
        • Slider Component
        • Checkbox Component
        • Date Input Component
        • Time Input Component
      • Media Components
        • Animation Component
        • Video Component
        • Loading Icon Component
      • Embed Components
        • Web Viewer Component
        • Map Component
        • Canvas Component
        • PDF Reader Component
        • Rating Component
      • Modules
        • Introduction
        • User Guide
      • Generative AI
    • Screens
      • Save and Reuse Screens
      • Improve Thunkable Load Time
    • Navigators
      • Top Tab Navigator
      • Bottom Tab Navigator
      • Drawer Navigator
      • Stack Navigator
    • Figma Integration
  • 🛠️Blocks
    • Thunkable Blocks Overview
    • Core Blocks
      • Control Blocks
      • Logic Blocks
      • Math Blocks
      • Text Blocks
      • Lists Blocks
      • Color Blocks
      • Device Blocks
      • Objects Blocks
      • Variables Overview
        • Connect a Firebase Realtime Database
        • Variables Blocks
      • Functions Blocks
    • App Features Blocks
      • Speech Blocks
      • Sound Blocks
      • Share Blocks
      • Camera Blocks
      • Files Blocks
      • Sign In Blocks
        • User Sign Up, Sign In, and Authentication with Firebase
        • User Sign Up, Sign In, and Authentication with Google
        • User Sign Up, Sign In, and Authentication with Apple
      • Location Blocks
      • Push Notification Blocks
      • In-App Purchase Blocks (with RevenueCat)
      • Data Sources Blocks
      • Alerts Blocks
      • Timer Blocks
      • Sensors Blocks
        • Gyroscope
        • Magnetometer
        • Accelerometer
        • Location Sensor
      • Ads by AdMob
    • Advanced Blocks
      • Web APIs Blocks
        • CORS Policy
        • 🆓No Auth APIs
          • Update Data in a Data Source
          • CRUD Operations
          • Setting Headers
        • 📊Charting APIs
          • Create a chart template
          • Charting in Thunkable
      • Bluetooth Low Energy Blocks
      • OpenAI Services ChatGPT Integration Blocks
      • "Any Component" Blocks
      • JavaScript Web Bridge
  • ⚙️Settings
    • App Settings
      • Tablet View
    • Assets
    • Cloud Variable Viewer
    • Manage your Projects
      • My Projects Page
      • Thunkable Projects
      • Duplicate Project
      • Share Your App
      • Download Your App
        • Download Your App on iOS
        • Download Your App on Android
      • Add to Home Screen
      • Managing Project Storage
      • App Data Privacy
      • Delete Project
  • 📱Publishing
    • Overview
    • Publish to the Apple App Store
      • User Guide
      • Troubleshooting
      • Review Process
      • Tracking Usage Description
    • Publish to Google Play Store
      • User Guide
      • Troubleshooting
      • Review Process
    • Publish as a Web App
      • User Guide
      • Custom Domains
      • Troubleshooting
    • Testing
      • Testing on iOS via TestFlight
      • Testing on Android
    • Troubleshooting
      • Publishing Checklist
      • Generate Screenshots
  • 🎮Gaming
    • Gaming Overview
      • Canvas Label
      • Sprites
      • Sprite Gallery
    • Gaming Blocks
      • Events
      • Motion
      • Looks
      • Direction
      • Sensing
      • Add & Remove
      • Stage
  • 🗃️Additional Resources
    • Release Notes
      • Release Notes 2024
      • Release Notes 2023
    • Troubleshooting
      • Can't Sign in to Thunkable?
      • FAQs
    • Minimum Requirements
    • Bugs and Product Feedback
    • App Services and Emulators
Powered by GitBook
On this page
  • Overview
  • 1. Project Settings
  • App Description
  • App Name
  • Default App Layout
  • Icon
  • Splash Screen Image
  • 2. Publishing Settings
  • App (Bundle) ID
  • Public App
  • Auto-increment Version
  • Optimize Fonts
  • Play sounds in background
  • Ignore Notch Area
  • Notch Area Background Color
  • Android Publishing Details
  • iOS
  • 3. Integrations
  • Firebase Settings
  • Google OAuth Settings
  • Google Map Settings
  • AdMob Settings
  • Cloudinary Settings

Was this helpful?

Export as PDF
  1. Settings

App Settings

PreviousJavaScript Web BridgeNextTablet View

Last updated 7 months ago

Was this helpful?

Overview

App settings is where you configure and customize various aspects of your app. It is organized into the following sections:

To view or change your app settings:

  • On your project's Design tab, click the gear icon in the left sidebar.

1. Project Settings

App Description

This describes your app and how you intend it to be used. While it is unnecessary to fill this out in Thunkable, if you publish your app, you must enter this information on Thunkable, the Apple App Store or the Google Play Store.

App Name

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. This name is also used to set the page title when you .

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.

Default App Layout

The best practice is to set your project's default app layout before you add components to your app screens. If you add components to your app screens and then change your project's default app layout, your designs will not automatically respond to the new size and layout, meaning that neither the size of your existing components nor the distance between components will change.

Use the dropdown menu to select your app's default layout. The options are:

  • Phone + Portrait

  • Phone + Landscape

  • Tablet + Portrait

  • Tablet + Landscape

Icon

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.

Ensure the file you upload does not have the same name as another asset used in your app. This will result in an error.

Icon 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)

Splash Screen Image

To access your app's splash screen image settings:

  1. Navigate to the project’s Design tab.

  2. Click the Settings icon in the left sidebar.

  3. Click the ellipsis icon at the bottom of the Project Settings section to access the advanced settings.

Picture

To customize your app’s splash screen picture:

  1. Click in the Picture field.

  2. Click Upload files and select an image from your computer, or select an image from your app’s current assets.

Splash Screen Picture Requirements:

  • The picture must be square. Rectangle pictures will not render correctly.

  • The ideal dimensions for your splash screen picture are 1152x1152 pixels.

  • If you want a transparent background, a PNG file is recommended.

Note: If you do not select a custom splash screen picture, your app icon image will be used by default.

Background Color

To customize the background color of your app’s splash screen:

  1. Click in the Background Color field.

  2. Use the color picker or input the HEX or RBGA codes to select your preferred color.

Note: If you do not select a custom splash screen background color, white will be used by default.

Sample Splash Screens

2. Publishing Settings

App (Bundle) ID

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 ë).

For auto-populated App (Bundle) IDs, if there are characters in the project name that are not alphanumeric (or an underscore), they will be omitted in the App (Bundle) ID.

Public App

Auto-increment Version

Optimize Fonts

If this switch is set to true, Thunkable will automatically remove all unused fonts from your built app. Removing unused fonts will reduce the overall size of your app for downloading and/or publishing. Only fonts set in the design tab will be kept. Fonts set by blocks will also be removed.

Play sounds in background

If this switch is set to true, the sound will keep playing even when the app is minimized.

Ignore Notch Area

In app development, the "notch area" refers to the space on the screen of a mobile device where the front-facing camera, sensors, and sometimes the speaker are located. By default, Thunkable adds the notched-out safe area at the top of the screen, resulting in a non-rectangular display shape.

If you set the Ignore Notch Area property to true, the screen background color will extend to fill the screen. However, if you do this, to avoid your app elements being blocked by the notch, you must manually address this in your app design.

Notch Area Background Color

By default, the notch area background color is white. You can change this color here if you wish, however. This is an app-level setting, and you won’t be able to customize the color at the screen level.

Android Publishing Details

Version Name

Version Code

iOS

Version Number

Tracking Usage Description (iOS only)

iOS Permissions

When you add components that require permissions to your app, like the camera or map, you must add purpose strings for any relevant component in your app if you want to publish it to the App Store.

3. Integrations

Firebase Settings

Google OAuth Settings

Google Map Settings

AdMob Settings

iOS and Android App ID

Keystore

Cloudinary Settings

This feature may only be available for Creators on certain Thunkable plans. Please refer to our for more information.

This feature may only be available for Creators on certain Thunkable plans. Please refer to our for more information.

For publishing to the iOS , 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 , the current requirement is 500 x 500 px. For the , it's 1024 x 1024 px.

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

Creators on certain Thunkable plans can set their app to private. A private app will not be displayed in the Thunkable Public Gallery. Learn more about public and private apps here: and more about our Thunkable plans here: .

When you publish to the or the , you must 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).

Set a for this version of your Android app.

Set a for this version of your Android app.

Set a for this version of your iOS app.

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. To learn more about when to include a tracking string,

If your app uses , , , or requires users to , you can enter your personal API keys for these integrations in the app settings.

To learn more about the Firebase integration, please see here: .

To learn more about the Google OAuth integration, please see here: .

To learn more about the Google Map integration, please see here: .

Enter the AdMob app ID for your iOS and/or Android app. To learn more, see here: .

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

To learn more about the Cloudinary integration, please see here: .

⚙️
pricing page
pricing page
Google Play
App Store
Android splash screen image dimension guide
App Store
Play Store
click here.
Firebase Sign-in
Google Sign-In
Map
Find your app IDs & ad unit IDs
Publish to Android > Keystore
Cloudinary
publish as a web app
Project Settings
Publishing Settings
Integrations
Thunkable pricing page
sign in
App Store
version number
Public vs. Private Projects
App Store
Play Store
version name
version code
translation
image recognition
media upload to the cloud