This page documents all URL parameters available for dynamic links.
Line Items (li)
Add products to the cart using variant IDs.
Format:
?li=VARIANT_ID:QUANTITY
Multiple items (comma-separated):
?li=VARIANT_ID_1:QUANTITY_1,VARIANT_ID_2:QUANTITY_2
With selling plan (for subscriptions):
?li=VARIANT_ID:QUANTITY:SELLING_PLAN_ID
With attributes:
?li=VARIANT_ID:QUANTITY:::KEY=VALUE
Examples:
?li=12345678:1 ?li=12345678:2,87654321:1 ?li=12345678:1:99999999 ?li=12345678:1:::gift_message=Happy Birthday
Customer (c)
Pre-fill customer information at checkout.
Shopify Customer ID:
?c=SHOPIFY_CUSTOMER_ID
Klaviyo Customer ID:
?c=klaviyo:KLAVIYO_PROFILE_ID
Inline customer data:
?c=[email,[email protected]:firstName,John:lastName,Doe]
Available inline fields:
emailfirstNamelastNameaddress1address2cityprovince(state/province code)zipcountry(country code)phone
Example with full address:
?c=[email,[email protected]:firstName,John:lastName,Doe:address1,123 Main St:city,New York:province,NY:zip,10001:country,US]
Cart Attributes (attr)
Attach key-value pairs to the order.
Format:
?attr=[KEY,VALUE]
Multiple attributes (comma-separated):
?attr=[KEY_1,VALUE_1:KEY_2,VALUE_2]
Example:
?attr=[source,instagram:campaign,spring2026]
Cart Note (note)
Add a note to the order.
Format:
?note=Your note text here
Example:
?note=Gift order - please wrap
Combining Parameters
You can combine any parameters using &:
?li=12345678:2&c=[email,[email protected]]&attr=[source,email]¬e=Reorder
URL Encoding
Remember to URL-encode special characters in your parameter values:
Character | Encoded |
Space |
|
|
|
|
|
|
|
|
|
Most email and SMS platforms handle URL encoding automatically when using merge tags.
