> For the complete documentation index, see [llms.txt](https://docs.shoffi.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shoffi.app/for-app-owners/managing-your-apps.md).

# Managing your apps

## Editing an existing app

Find the app you want to edit on the `My Apps` page. Under `Actions`, click `Edit app`.

From that page, you can change affiliate terms, update the app logo, and add app resources. If you need to change a disabled field, contact support.

## Refreshing your Partners API client access token

If you created a new Partners API client in your Shopify Partner account, or your current token stopped working, you can replace it yourself:

1. Open the app on the `My Apps` page and click `Edit app`.
2. Scroll to `Shopify partner details` and click `Edit token`.
3. Paste a **new** Partners API client access token from Shopify (not the one already saved in Shoffi). It starts with `prtapi_`, and the API client needs the `View financials` and `Manage apps` permissions. If you paste the current token, Shoffi blocks Validate and asks you to create a new one first.
4. Click `Validate connection`. Shoffi checks the token against Shopify right away.
5. Once it's validated, click `Save` in the bar at the top of the page.

{% hint style="info" %}
Your `Partner ID` and `App ID` stay locked. If either of those changed, contact support.
{% endhint %}

If validation fails, double-check that you copied the whole token and that the API client has both required permissions. Shoffi keeps using your previous token until a new one is validated and saved.

{% hint style="info" %}
For security, the token is only ever shown masked — `prtapi_`, then `xxxx…`, then its last 4 characters — so you can tell which token is saved without exposing it. It can never be read back in full, so when you refresh it, paste the whole new token.
{% endhint %}

{% hint style="warning" %}
**Important:** If you change your app's affiliate terms, the new terms apply only to new referrals from that point forward. Previous referrals keep the terms that were active when the referral started. Affiliates are not notified if you only change **Advanced Terms** (Disable manual referrals, Require invoice, or Custom Terms And Conditions).
{% endhint %}

## Integration errors on My Apps

If an app's status is **Incomplete**, `My Apps` shows a warning that the app has not finished integration. Open the app and finish the remaining steps.

If Shoffi detects a problem that blocks matching new referrals (for example expired Shopify Partners credentials, or BigQuery access revoked), a warning banner appears on your `My Apps` page with steps to fix it. Open the app settings and fix the issue as soon as you can so new referrals keep matching.

The same banner appears if you subscribe again after your account was deactivated, because Shoffi no longer holds your Partners API client access token. Re-enter it under the app's Shopify partner details, validate the connection and save. See [Frozen and Deactivated accounts](/subscriptions/frozen-and-deactivated-accounts.md#coming-back-after-deactivation).

## App ID already exists

The new-app form rejects a Shopify app id that is already connected to a Shoffi account. You cannot claim or overwrite it from the form.

[Contact support](https://shoffi.app/contact-support/) with the numeric App ID and the account email that should own it. Support checks where it is connected and removes it from the other account. After that, submit the app again.

If you still have the original Shoffi login, use that account instead of creating a second one. Apps on a deactivated account are not editable until you subscribe again and re-enter the Partner API token. See [Frozen and Deactivated accounts](/subscriptions/frozen-and-deactivated-accounts.md#coming-back-after-deactivation).

## Deleting an app

There is no delete button. [Contact support](https://shoffi.app/contact-support/) and name the app.

Support confirms before removing it, because affiliates on that program are notified. Removal is not instant; support does it and writes back when it is done.

`Partner ID` and `App ID` on an app you are keeping stay locked. To point Shoffi at a different Shopify app, that is a delete-and-add, not an edit. A new Partner API token for the same app is self-serve: `My Apps` → `Edit app` → `Shopify partner details` → `Edit token`.

## The plan is already full

Each plan has a cap on integrated apps. The form will not add another app past that cap. See [Plan limits](/subscriptions/plan-limits.md#integrated-apps).

* Upgrade from `Settings` → `Change plan` if you need more apps.
* Or tell support which existing app to remove. Affiliates on the removed app are notified, then you can add the new one.

Support sometimes raises the cap for a single account. That is an exception, not a control in the dashboard.