# Share barcodes via bulk messaging services

Other apps or emailing services usually don't have access to Shopify customer IDs. However, such services can still distribute barcodes as long as they support custom templates with customer **email** variables. 

{% hint style="warning" %}
The app queries the email addresses provided via the link and embeds Shopify customer IDs into the barcodes. In order for this to work, the **email addresses must be associated with Shopify customers**.

\
Depending on the service used, email template variables may not be replaced with valid Shopify customer email addresses in preview or test emails, resulting in errors. To view the final result, please send an actual (non-test) email to an existing Shopify customer (can be fake) email address. This is a [known issue in Shopify Email](https://community.shopify.com/c/shopify-discussions/has-anyone-used-the-first-name-personalization-when-creating-an/td-p/2628527) affecting preview/test emails.
{% endhint %}

## Shopify Email app

To send barcodes and mobile wallet download buttons, include the following snippets into a custom Liquid section of your selected [Shopify Email](https://help.shopify.com/en/manual/promoting-marketing/create-marketing/shopify-email/create-email/custom-liquid) template.

### 1D barcode image

```
<img src="https://select-customer-barcode-prod.herokuapp.com/public-api/v1/barcodes/code128/{{shop.permanent_domain}}/emails/{{data.customer.email}}" />
```

### 2D QR code

```
<img src="https://select-customer-barcode-prod.herokuapp.com/public-api/v1/barcodes/qr/{{shop.permanent_domain}}/emails/{{data.customer.email}}" />
```

### "Add to Apple Wallet" button

```
<a download href="https://select-customer-barcode-prod.herokuapp.com/public-api/v1/wallet/apple/{{shop.permanent_domain}}/emails/{{data.customer.email}}"> <img src="https://barcodify-prod.s3.amazonaws.com/public/add-to-apple-wallet/Add_to_Apple_Wallet_rgb_US-UK.png" /> </a>
```

To localise the text of the "Add to Apple Wallet" button, simply replace `Add_to_Apple_Wallet_rgb_US-UK.png` with the selected language's file name in the snippet above. To see available localisations, download [localised images](https://barcodify-prod.s3.amazonaws.com/public/add-to-apple-wallet/add-to-wallet-localised-images.zip). For more information, check [Add to Apple Wallet Guidelines](https://developer.apple.com/wallet/add-to-apple-wallet-guidelines/).

### "Add to Google Wallet" button

```
<a href="https://select-customer-barcode-prod.herokuapp.com/public-api/v1/wallet/google/{{shop.permanent_domain}}/emails/{{data.customer.email}}"> <img src="https://barcodify-prod.s3.amazonaws.com/public/add-to-google-wallet/enUS_add_to_google_wallet_add-wallet-badge.png" /> </a>
```

To localise the text of the "Add to Google Wallet" button, simply replace enUS\_add\_to\_google\_wallet\_add-wallet-badge.png with the selected language's file name in the snippet above. To see available localisations, download [localised images](https://barcodify-prod.s3.amazonaws.com/public/add-to-google-wallet/add-to-wallet-localised-images.zip). For more information, check [Add to Google Wallet Guidelines](https://developers.google.com/wallet/generic/resources/brand-guidelines).

{% hint style="danger" %}
Please don't confuse [Shopify Notifications with Shopify Email](https://community.shopify.com/c/shopify-discussions/shopify-email-versus-notifications/m-p/2379388). To send barcodes via automated notifications such as order confirmation, check out the [instructions](/barcodify-customer-selector/getting-started/share-app-generated-barcodes-with-customers/share-barcodes-via-shopify-notifications.md).
{% endhint %}

### Troubleshooting

If you notice the "Expected a valid shop query parameter", when trying to download mobile passes as in the example below

<figure><img src="/files/wn5NavECf82rMPpt6wCH" alt=""><figcaption></figcaption></figure>

or the barcode images don't load up ![](/files/vtgosjug9NZV00TbpZ8h)

you may need to replace **{{shop.permanent\_domain}}** with your store's **myshopify.com** domain name, e.g. **my-store-name.myshopify.com** as it appears in your store's settings.

<figure><img src="/files/InNsT3BcbMEV7qCq4t4F" alt=""><figcaption><p>galmis-test.myshopify.com myshopify domain name</p></figcaption></figure>

For example, instead of&#x20;

```
<a download href="https://select-customer-barcode-prod.herokuapp.com/public-api/v1/wallet/apple/{{shop.permanent_domain}}/emails/{{data.customer.email}}"> <img src="https://barcodify-prod.s3.amazonaws.com/public/add-to-apple-wallet/Add_to_Apple_Wallet_rgb_US-UK.png" /> </a>
```

use

```
<a download href="https://select-customer-barcode-prod.herokuapp.com/public-api/v1/wallet/apple/my-store-name.myshopify.com/emails/{{data.customer.email}}"> <img src="https://barcodify-prod.s3.amazonaws.com/public/add-to-apple-wallet/Add_to_Apple_Wallet_rgb_US-UK.png" /> </a>
```

## Other providers

Usually, email providers do not have access to Shopify customer IDs or other data. If the email provider supports customisable templates with email variables, you can send the barcodes to your customers.&#x20;

Below are a few commonly requested services.

### Mailchimp

Mailchimp supports email variables called [Merge Tags](https://mailchimp.com/help/getting-started-with-merge-tags/). The merge tags are replaced with the underlying value (email in this case) the same way Liquid variables are. To send barcodes to your customers, replace **{{data.customer.email}}** with **\*|EMAIL|\*** and **{{shop.permanent\_domain}}** with your **store's myshopify.com domain name**, e.g. my-store-name.myshopify.com

### Klaviyo

Klaviyo supports [personalization tags](https://help.klaviyo.com/hc/en-us/articles/4408802648731). To send barcodes to your customers, replace **{{data.customer.email}}** with **{{email}}** and **{{shop.permanent\_domain}}** with your **store's myshopify.com domain name**, e.g. my-store-name.myshopify.com.


---

# 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://galmis.gitbook.io/barcodify-customer-selector/getting-started/share-app-generated-barcodes-with-customers/share-barcodes-via-bulk-messaging-services.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.