# Sharing

## Where is my share link?

The easiest way to find your external share link is by going to your [Apps](https://appetize.io/apps) or [App Builds](https://docs.appetize.io/app-management/listing-apps#app-builds-page) page and selecting **share** under the app, App Group or build that you want to embed on your website.

<figure><img src="https://2147444700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJUveBCJfn0GR8-hlqi%2Fuploads%2Fro8Wl5iKd0sBn88Dsnam%2FScreenshot%202025-03-21%20113309.png?alt=media&#x26;token=baf5e694-9eeb-4cd5-85e1-2561b33a03d6" alt=""><figcaption><p>Find your share link by clicking the share button</p></figcaption></figure>

Currently, `Share` will share a specific build of your application. Soon, we will introduce new sharing features that will allow you to share the latest build without changing the URL.

<figure><img src="https://2147444700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJUveBCJfn0GR8-hlqi%2Fuploads%2Fgit-blob-94a38f5dbf9df52439372e80e198c59ff49d3b95%2Fimage.png?alt=media" alt="" width="386"><figcaption><p>Example Share dialog</p></figcaption></figure>

## App Identifier

App builds hosted on Appetize are distinguished by their unique Application Identifier. On Android, this identifier corresponds to the [Application ID](https://developer.android.com/build/configure-app-module#set-application-id), while on iOS, it is known as the [Bundle Identifier](https://developer.apple.com/documentation/appstoreconnectapi/bundle_ids).

You can access the [latest build](#user-content-fn-1)[^1] of a particular application like this:

```
https://appetize.io/apps/{platform}/{appId}
```

{% hint style="warning" %}
By default, only users linked to your organization and signed in to Appetize will have access to your App Identifier link.
{% endhint %}

This link can also be further filtered to a specific type of build by passing in the preferred metadata e.g.

* By tag `https://appetize.io/apps/{platform}/{appId}?tag=dev`
* By version `https://appetize.io/apps/{platform}/{appId}/{versionName}`

## Build Identifier

*Previously known as publicKey*

When you upload an app build to Appetize, you receive a link to view your app. This link includes the app's assigned **buildId**, and looks like this:

```
https://appetize.io/app/{buildId}
```

By default, anybody who has your app's build link, i.e. its **buildId** (previously known as **publicKey**), will have permission to run your app.

Your app link can be easily shared with whomever you'd like, or [embedded](https://docs.appetize.io/platform/embedding-apps) into your own applications.

{% hint style="info" %}
Some customers want to restrict access, so that only authenticated users may run their app (or certain features). See [App Build Permissions](https://docs.appetize.io/platform/app-management/app-permissions) for more information on how to do this.
{% endhint %}

[^1]: The **latest build** refers to the most recent version of your app on Android, identified by the [versionCode](https://developer.android.com/studio/publish/versioning#versioningsettings) , and on iOS, by the [CFBundleShortVersionString](https://developer.apple.com/documentation/bundleresources/information_property_list/cfbundleshortversionstring) and [CFBundleVersion](https://developer.apple.com/documentation/bundleresources/information_property_list/cfbundleversion).


---

# 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.appetize.io/platform/sharing-apps.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.
