How can I prefill options via URL parameters?

If you want to send a link to customers with pre-filled options selections, you can use query parameters in the URL.

Query parameters

The query parameters are name value pairs that are appended to the end of the URL in the following format:

?_f&option_name1=option_value1&option_name2=option_value2a,option_value2b

Activation parameter

The "_f" parameter is required to activate the prefilling of options.

Currently, this is only possible via JavaScript, you can execute the following code in the developer tools console to generate a shareable link:

// trigger share event { url: true } updates the URL with the option selections
window.dispatchEvent(new CustomEvent('options:share', { detail: { url: true }, cancelable: true, bubbles: true }));

Limitations

File uploads: if you want to prefill the upload option with an external file URL and use it on the live preview, make sure the file URL allows cross-origin with wildcards.  Else, it's best to upload via our app and use the share logic from above.

Live preview: the modifications are not shareable (e.g element positions, crop selections).

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.