# Edit Your App Metadata

The Onside Developer Console gives you flexible and powerful ways to manage your app's product page information. You can choose to automatically synchronize your listing with App Store Connect or take manual control for instant updates.

<figure><img src="https://3698875069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV24VBLkTP47H3Kf48DFs%2Fuploads%2FYUuZuqKnhe10M6l0wfH5%2Fimage.png?alt=media&#x26;token=b913258e-f9ca-468a-b062-f64349755775" alt="" width="563"><figcaption></figcaption></figure>

***

### Sync with App Store Connect (Default Mode)

By default, your app's information is set to **Sync with App Store Connect**. This is the easiest way to keep your listings consistent across platforms.

<figure><img src="https://3698875069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV24VBLkTP47H3Kf48DFs%2Fuploads%2FIjgSrhE053IgN7J2QMs7%2Fimage.png?alt=media&#x26;token=8138018c-8789-44c8-a963-33269e17e249" alt="" width="318"><figcaption></figcaption></figure>

* **How it Works:** When this toggle is **ON**, Onside automatically pulls your app's metadata—such as its name, description, subtitle, and keywords—directly from your App Store Connect listing.
* **Update Speed:** When you release a new version with updated metadata on the App Store, the changes will typically appear on your Onside product page **within an hour**.

> This feature is designed to save you time. You only need to manage your metadata in one place (App Store Connect), and we handle the rest.

***

### Manual Editing Mode

If you want to tailor your app's listing specifically for the Onside audience or make instant changes, you can switch to manual editing.

To enable this, simply turn **OFF** the **"Syncing with App Store Connect"** toggle at the top of the Information page. A confirmation will appear, noting that editing is now enabled.

<figure><img src="https://3698875069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV24VBLkTP47H3Kf48DFs%2Fuploads%2FmpOj7sPDN4OUe81SWSXv%2Fimage.png?alt=media&#x26;token=1ddf0791-a4bb-4300-b731-a717dbb56be1" alt="" width="287"><figcaption></figcaption></figure>

Once in manual mode, you can edit the following fields:

{% tabs %}
{% tab title="Localizable Information" %}
This is the descriptive content that users see on your product page. All fields can be localized for different languages. Character limits are aligned with Apple's to ensure you can easily switch back to sync mode if needed.

* **Name:** Your app's official name.
* **Subtitle:** A short summary that appears under your app's name.
* **Description:** A detailed description of your app’s features and functionality.
* **Keywords:** Add up to 10 keywords that best describe your app to improve search visibility.
* **Support URL:** A link to your website where users can find help and support.
* **Marketing URL (Optional):** A link to a webpage with more marketing information about your app.

<details>

<summary><strong>Supported Languages for Localization</strong></summary>

Onside supports all languages available in App Store Connect. You can provide localized metadata for each language you support. The table below shows common European languages as an example.

| Country                                     | Default Language | Additional Supported Language |
| ------------------------------------------- | ---------------- | ----------------------------- |
| Austria (AUT)                               | German           | English                       |
| Belgium (BEL)                               | English          | Dutch, French                 |
| Bulgaria (BGR)                              | English          | -                             |
| Croatia (HRV)                               | English          | Croatian                      |
| Cyprus (CYP)                                | English          | Greek, Turkish                |
| ...and all other App Store Connect locales. |                  |                               |

</details>
{% endtab %}

{% tab title="General Information" %}
This section contains general details and classifications for your app.

* **Type:** The app's type (e.g., App, Game). This is synced and cannot be edited here.
* **Category:** The primary category that best describes your app. This can be changed from the App Store Connect category.
* **Spicy Category:** Onside offers a unique "Spicy" category for apps in genres that may have limited distribution elsewhere. This includes apps related to **Adult Content** (where legally compliant and age-gated), **Crypto**, or **Gambling-style Entertainment**. Selecting this ensures your app reaches the appropriate audience responsibly.
* **Copyright (Optional):** The name of the person or entity that owns the exclusive rights to your app.
* **Content Rights (Optional):** Clarify if your app contains, shows, or accesses third-party content. If it does, you must confirm you have the necessary rights to use it.
* **Age Rating:** The app's age rating, which is synced and cannot be edited here.
* **Primary Language:** The main language of your app.
  {% endtab %}
  {% endtabs %}

### Content That is Always Synced

{% hint style="info" %}
For consistency and security, some core app components are **always** synced from your App Store Connect account, even when you are in manual editing mode.

* **App Icon:** Your app's icon can only be updated on Xcode.
* **App Previews & Screenshots:** All visual previews and screenshots are pulled directly from your App Store Connect listing.
* **The App Build Itself:** The installable file (`.ipa`) is always sourced from your App Store Connect account.
  {% endhint %}

***

### Important Content Rules

* All metadata you provide (text and URLs) must be legal and adhere to our **Content Policies**.
* Explicit 18+ content is **not permitted** in the app's name, description, icon, or screenshots. Such content must only be available within the app itself, which should be correctly categorized as "Spicy" and have the appropriate age rating.

***

### Frequently Asked Questions

<details>

<summary><strong>How long do my manual edits take to appear in the Onside Store?</strong></summary>

Changes made in manual editing mode are typically live on your product page **almost immediately**, without needing to submit a new app build.

</details>

<details>

<summary><strong>Can I edit my app's icon or screenshots in the Onside Console?</strong></summary>

No. Currently, the app icon, screenshots, and video previews are always synchronized from your App Store Connect listing. To change them, you must update them on the App Store.

</details>

<details>

<summary><strong>What happens if I switch back from manual mode to "Sync with App Store"?</strong></summary>

If you re-enable the sync, your manually entered metadata will be overwritten by the current information from your App Store Connect listing during the next sync cycle.

</details>


---

# 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.onside.io/console/account-and-platform/edit-your-app-metadata.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.