The default configuration for a gift card product page managed by the Loopz Gift Cards app will add a button below the "Add to Cart" button, that when clicked, opens the gift card customization popup where a customer can configure their gift card. Once the gift card is configured, it's added to the cart and line item properties are added to the cart line item containing the gift card product with the details of the customer's gift card configuration. Loopz Gift Cards used those properties to issue the gift card one the order is placed.

This article details those line item properties so you can create a custom form embedded in the gift card product page to capture the details required to customize the gift card.

To add a form to the gift card product page use the Shopify Forms app or a third party form app. Configure the form the capture the recipient name and email, optionally the sender name and email and a toggle to select between instant and scheduled delivery of the gift card. The scheduled delivery option should display a date time picker component to select the date and time when the gift card should be delivered. The output of the form needs to be mapped to the line item properties described below.

The following line item properties can be added to the line item containing the gift card product. When these line item properties are present, Loopz Gift Cards will use them when issuing a new gift card. Otherwise details from the Shopify order are used.

Property names that start with a '_' should not be shown to the customer in the cart or checkout page. Shopify's default themes will hide properties that start with a '_' in the cart and checkout page. If you're using a custom theme, you might need to add code to your theme to exclude those properties from being shown.

For non-english stores, we also support the following languages for the publicly visible property names that you can use.