> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.shipaid.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Gorgias Integration Setup and Troubleshooting

Connect SHIPAID to Gorgias so your support team can view existing shipment Issues and apply available resolutions from the ticket sidebar. Your team stays in control of each decision and your store’s resolution policy.

## Before you start

- An active SHIPAID account with your Shopify store connected.
- A Gorgias account with **the same Shopify store** connected.
- A Gorgias administrator who can install and manage apps, plus access to the correct store in SHIPAID.
- For Store Credit, Discount, or Gift Card actions, the corresponding resolution option must be enabled in SHIPAID.

This integration works with Shopify shipment Issues. It does not create Issues or manage return requests from Gorgias.

## 1. Install SHIPAID in Gorgias

1. Sign in to the Gorgias helpdesk you want to connect.
2. Open **Settings → Apps → App Store**, search for **ShipAid**, and open the app. You can also start from [ShipAid’s Gorgias App Store listing](https://www.gorgias.com/apps/shipaid). Older Gorgias screens may call the app directory **All Apps**.
3. Select the app’s connect or install button. If prompted, choose the intended Gorgias account.
4. Review the requested permissions and select **Authorize App** to complete the connection.
5. When installation finishes, return to Gorgias’s integration settings. SHIPAID creates its integration and sidebar widgets automatically; you do not need to enter API keys or build an HTTP integration manually.

You can also find the marketplace link in SHIPAID under **Settings → Integrations → Partner Integrations → Customer Service Tools → Gorgias**.

## 2. Confirm the connection

1. Choose an existing, unresolved Issue in SHIPAID and note its order number and customer email.
2. Open a Gorgias ticket for that same customer email. Expand the right-hand sidebar and refresh the ticket if needed.
3. Look for a card titled **ShipAid Issue \[number]**. Confirm that its Issue number, order number, customer details, and status match SHIPAID.
4. Select the Issue link to open the full record in SHIPAID.

> **Verification path:** Gorgias ticket → right sidebar → ShipAid Issue \[number] → matching order and status.

Viewing the card is enough to check the connection. Resolution buttons perform real actions; use them only when you intend to resolve the customer’s Issue.

An owner or administrator can inspect the generated connection under **Settings → Account → HTTP integration → Manage → ShipAid**. The **Events** tab helps identify unsuccessful integration requests.

## 3. Configure available resolutions

In SHIPAID, open **Settings → Resolution → Resolutions**. Enable the options your team is allowed to offer and select **Save**. For Store Credit, Discount, or Gift Card, check both the main **Enable Store Credit** setting and the matching choice under **Store Credit Options**.

Keep your normal store policy and agent permissions in place. The integration does not decide whether an Issue should be approved or denied.

## 4. Use SHIPAID in a Gorgias ticket

The Issue card can show the Issue and order numbers, dates, tracking link, reason, items, Issue total, guarantee information, customer details, and status. A tracking link may show **N/A** when no tracking identifier is available.

1. Open the customer’s ticket and review the matching Issue card.
2. Choose the appropriate available action: **Refund, Reorder, Store Credit, Discount, Gift Card, Deny**, or **Other**.
3. Where the form asks for items, select **All**. Individual-item or partial resolutions are not supported in this widget; handle those in SHIPAID.
4. Complete any amount and note fields. Set **Notify Customer** to **YES** or **NO** as appropriate.
5. Review the action, then submit once. A successful action returns **Resolution applied successfully**. Check the Issue in SHIPAID before retrying an uncertain result.

After an Issue is resolved, its actionable widget may disappear. It can reappear when that customer has a new eligible Issue. The same Issue cannot be resolved a second time.

## Troubleshooting

### Authorization fails or installation cannot find my store

Confirm that you are a Gorgias administrator, that you authorized the intended helpdesk, and that the same Shopify store is already connected to both Gorgias and SHIPAID. Complete any interrupted authorization screen. If the browser blocked the authorization window, allow that window and retry the setup.

### The Issue widget is missing or empty

Confirm that an Issue already exists in SHIPAID, that it belongs to the connected Shopify store, and that the Gorgias ticket’s customer email matches the Issue customer email. Refresh the ticket and expand the sidebar. An ordinary order without an Issue will not produce an Issue card. A resolved Issue’s actionable widget can disappear as expected.

### A resolution is unavailable or fails

Confirm that the Issue is still unresolved, select **All** rather than individual items, and check that the desired resolution is enabled in SHIPAID. For credit-related actions, select the matching Store Credit Option and save. If the result is unclear, inspect the Issue in SHIPAID before trying the action again.

### The integration reports a request error

Ask a Gorgias owner or administrator to open **Settings → Account → HTTP integration → Manage → ShipAid → Events**. Note the failed request’s time and error. Confirm that the underlying Shopify connection is active in both products, then contact SHIPAID if the error continues.

### I use several Shopify stores or need to change helpdesks

Verify each store’s connection separately. Do not assume one installation covers every Shopify store in a Gorgias account. Reconnecting can replace the existing SHIPAID widgets, so contact SHIPAID before changing the connected store or combining multiple stores in one helpdesk.

## Disconnect or reconnect

To remove the app, a Gorgias administrator can open **Settings → Apps → Installed Apps → ShipAid → Delete app** and confirm. To reconnect, follow the installation steps above. For multiple stores, coordinate with SHIPAID first.

Do not use SHIPAID’s **Disconnect Store** control for this task; that disconnects the Shopify store itself.

## Need help?

Email [support@shipaid.com](mailto:support@shipaid.com) or use chat at [help.shipaid.com](https://help.shipaid.com/). Include your Shopify store domain, Gorgias account subdomain, affected Issue number, the step that failed, and the error wording.

*Last reviewed: October 19, 2026.*