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],first_name:John,last_name:Doe
Available inline fields:
emailfirst_namelast_nameaddress1address2cityprovince(state/province code)zipcountry(country code)phone
Example with full address:
?c=email:[email protected],first_name:John,last_name: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.