> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://regiostech.crisp.help/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).

# How to Create Shareable Links

Similarly to built-in Shopify discounts, you can create links to your store that will apply a specific discount code to the cart when visited.

## Use Cases

- Share discount via link.
- Direct to specific collections/products with discount pre-applied.

## Step 1 - Create a Discount Code

1. **Create a discount code, NOT an automatic discount.**
2. **You must save the discount first before you can get a link.**
3. After saving the discount, go to the home screen of the app, then click on your discount to open its "Edit product/order/shipping discount" page.

## Step 2 - Find the "Promote > Get a shareable link" button

On larger screens (eg. desktops), you'll see a "Promote" button at the top right of the screen. Click that, then "Get a shareable link."

On smaller screens, such as tablets, you'll see an "Actions" button at the top right of the screen. Click that, then find the "Promote" section, and click "Get a shareable link."

If you don't see the "Promote > Get a shareable link" button:

- Are you sure you created a discount code, NOT an automatic discount?
- Have you already saved the discount?

## Step 3 - Copy the Link

The app will get a list of shareable URLs for this discount from Shopify's API. Click "Copy link" to copy a link to your clipboard.

## Creating Your Own Shareable Link

The functionality for shareable links is built-in to Shopify.

For example, if you visit `yoursite.com/discount/CODE`, it will apply whatever the discount code is to the cart.

However, this does not work for automatic discounts, because they do not have a "code" that you can add to the URL.

### Creating Shareable Links to Collection Pages

Add `?redirect=/collections/HANDLE` to the end of the URL.

`%2F` is the same as `/`, so if the above gives you issues, try `?redirect=%2Fcollections%2FHANDLE`.

For example, if you want a link that automatically applies the discount code `15OFFSHIRTS` and takes a customer to your "Shirts" collection:

`yoursite.com/discount/15OFFSHIRTS?redirect=%2Fcollections%2Fshirts`

### International Stores and Locales

For multi-market stores, append `&country=ISO_CODE` (e.g., `AU` for Australia, `GB` for UK) to preserve or set locale.

**Example:** `yoursite.com/discount/VIP40?redirect=%2Fcollections%2Fshape-tape&country=AU`

**Key Notes:**

- Test thoroughly; collections may default to base locale (e.g., US) per Shopify behavior.
- Set `country` dynamically for customers (no app automation yet).
- Chech the official Shopify documention: [Promote discounts](https://help.shopify.com/en/manual/discounts/managing-discounts/promote-a-discount-using-a-shareable-link), [Deep links](https://changelog.shopify.com/posts/direct-customers-to-their-country-or-region-with-deep-links).

## Your Feedback Matters

Your review helps keep this small business running. Please [leave one](https://apps.shopify.com/regios-automatic-discounts#modal-show=ReviewListingModal) on the Shopify App Store.