Skip to main content

URL Parameters Reference

Updated over a week ago

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:

  • email

  • firstName

  • lastName

  • address1

  • address2

  • city

  • province (state/province code)

  • zip

  • country (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]&note=Reorder

URL Encoding

Remember to URL-encode special characters in your parameter values:

Character

Encoded

Space

%20 or +

@

%40

&

%26

=

%3D

,

%2C

Most email and SMS platforms handle URL encoding automatically when using merge tags.

Did this answer your question?