# Download Your App on Android

## Overview

All Android apps built with Thunkable are built with Android API 35 and target Android 15.

## Initiate an Android App Download

{% hint style="warning" %}
To avoid download errors, we recommend [adding an App Icon and Name](https://docs.thunkable.com/settings/project-settings) to your project before downloading.
{% endhint %}

To download your app to an Android device:

1. Click the **Publish and Download** icon.
2. Select **Download Android**.<br>

   <div align="left"><figure><img src="https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LAn5scXl2uqUJUOqkJo-84897653%2Fuploads%2FDTAxmjjiTO45w357wdah%2FPublish%20and%20Download%20-%20dropdown%20menu.png?alt=media&#x26;token=7720744f-8d66-477b-9550-bda4e92a25dd" alt="" width="321"><figcaption></figcaption></figure></div>

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>The number of monthly downloads you are allowed varies per <a href="https://thunkable.com/pricing">Thunkable plan</a>. This number resets when your next billing cycle begins</p></div>
3. Enter your email address in the provided field
4. Click **Send**.

You will be sent an email with a link to download your app.

For some [Thunkable plans](https://thunkable.com/pricing), the number of monthly downloads varies per download type.

We offer two types of downloads for Android:

a. Testing downloads (expire after 72 hours)

b. Distribution downloads (these do not expire).

<div align="left"><figure><img src="https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LAn5scXl2uqUJUOqkJo-84897653%2Fuploads%2FwU89MsegucCSh6D7Q7Bc%2Fdownload%20android.png?alt=media&#x26;token=de23bff9-3a57-4682-82b8-9046a25d5ddd" alt="" width="417"><figcaption></figcaption></figure></div>

## Download Android App

When you receive the email with the download link:

1. Open the email on your Android device.
2. Click the **DOWNLOAD YOUR APK** button.&#x20;

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Google Chrome's browser settings may prevent you from downloading the APK file. If you have an issue, open the email in Firefox or Safari and download your APK file.</p></div>
3. Select your preferred browser.
4. Click **Download**.&#x20;

### Trust Thunkable

To install the app on your Android device, you must indicate that you trust Thunkable. To do that:

1. Open your Android device's **Settings** menu.
2. Navigate to **Lock Screen and Security**.&#x20;
3. Set the **Unknown Sources** option to true.

<div align="left"><img src="https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LAn5scXl2uqUJUOqkJo%2F-LAn5wecEraNWaG7Ig2g%2F-LAn66w-RSz5u5Xihb7i%2Fdownload-%E2%9C%95-fig-4.png?generation=1524497156650703&#x26;alt=media" alt=""></div>

In addition, you may be alerted that Play Protect has blocked an unsafe app. This is because you are downloading the app outside of the Play Store. If that is the case:

1. Select the APK file you downloaded to your device.
2. Click **Install**.
3. Click **More details**.
4. Click **Install anyway**.
5. Click **Open**.

<figure><img src="https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LAn5scXl2uqUJUOqkJo-84897653%2Fuploads%2Fc5gN84BCPlXhaH6WVbmQ%2FAPK%20Screenshots%20(1).png?alt=media&#x26;token=8558d535-9605-495d-9680-d3b0ad63041b" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Anyone installing your app directly, instead of from the Play Store, will need to change the setting on their phone to allow installation of apps from Unknown Sources.
{% endhint %}

## General Download Limits

The number of monthly downloads you are allowed varies per [Thunkable plan](https://thunkable.com/pricing). This number resets when your next billing cycle begins.

## Troubleshooting

### App Cannot be Built

If you receive an email saying that your app cannot be built, it may be the result of one of the following:

* Ensure your app icon image:
  * does not have the same name as another project asset
  * is an image file
  * does not contain transparent pixels. Apple does not allow icons with transparent colors.
* Ensure your App (Bundle) ID adheres to the following:
  * It is a series of short strings of text separated by periods (e.g. com.thunkable.creator.app).
  * It is all lowercase.
  * It begins with a letter.
* Ensure your asset names only contain Roman alphabet characters (with no accents) and numbers.
  * Examples of asset names that could cause errors: image(1).jpg, imãge.jpg
  * Examples of asset names that won't cause errors: image1.jpg, image.jpg
* We are having trouble with our build servers. Please try again in 30 minutes.

### **Cannot connect to storage.googleapis.com**

If you cannot install your app and get the message "Cannot connect to storage.googleapis.com," it is likely the result of the following:

* Ensure you do not have special characters such as "&" in your [App Name](https://docs.thunkable.com/project-settings#app-name).

### **There was a problem parsing the Package**

If you install your app on an Android device and see the message "There was a problem parsing the Package," it is likely the result of the following:

* Ensure your App (Bundle) ID adheres to the following:

  * It is a series of short strings of text separated by periods (e.g. com.thunkable.creator.app).
  * It is all lowercase.
  * It begins with a letter.

***

{% hint style="success" %}
**Have feedback on this doc?** Please take a moment to share your feedback here: [Thunkable Docs Feedback](https://docs.google.com/forms/d/e/1FAIpQLSfCwn5L2xyla-LSLZX0DSWFcFeJ43qp-r1tELCacuVS2zduLA/viewform?usp=sf_link). Your valuable insights will help us improve and better serve you in the future.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.thunkable.com/settings/manage-your-projects/download/download.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.