Collapse Menu
FastSpring App
Developer Tools
Contact Support

Linking to Your Storefronts


This article explains the URLs used for your Web Storefronts and Popup Storefronts.

There are various URLs you can use to access your FastSpring Storefronts:

  • With Web Storefronts, you use hyperlinks to send customers from your websites, social media, or email messages to your FastSpring Storefronts. Web Storefront links can go to your Storefront's Homepage (like a product catalog), or directly to a specific product page. The links can be for live orders or test orders.
  • With Popup Storefronts, the Storefront lives in a secure iframe on your own web page, so you do not use hyperlinks that point directly to the Storefront. Instead, the Storefront loads when your page loads, using a JavaScript snippet provided by FastSpring in the FastSpring App. The JavaScript snippet includes your Popup Storefront's URL, which can be for live orders or test orders.

Every FastSpring Store has a unique subdomain, which is set at the time of Store creation and cannot be changed afterward.


Web Storefront Links

In the following examples, the Store subdomain (also called the "Base URL") is "acme," and the Store has two Storefronts:  the default Storefront and a "holiday" Storefront. It has products with IDs of product1, product2, and product3.

Homepage Links

The following example URLs would go to the Homepage of your Web Storefront, which displays the products you have selected in the Homepage products settings:


Product Page Links

To continue the example of a Store with a base URL of "acme," the following URLs would show the product page for the product with ID product2. Product pages show a single product with all its upsells, cross-sells, and related offers. On these pages, the product is automatically selected/placed in the cart to speed up the ordering process.


Notes About Web Storefront Links

You can also link to the Storefront with any number of GET parameters for analytics purposes - like ?_ga=... or &kmi=..., which are passed to the analytics and tracking scripts loaded on the page. Note, however, that GET and POST parameters cannot change or affect an order flow.

You can also link to Storefronts by using the FastSpring API to generate a session URL. To do that, you need to POST order details to the /sessions endpoint. The API responds with a unique session id that you can append to the Storefront URL like this:{session id}. Alternatively, calling the Store Builder Library's fastspring.builder.checkout({session id}) loads the session in the Storefront specified upon loading the library.


Finding Your Web Storefront URLs via the FastSpring App

There are two main ways to locate your Web Storefront URLs in the FastSpring App. The first is to select the Storefronts menu and the Web Storefronts tab. Then, click the Links command for the Storefront whose URLs you want to locate.


The Links dialog opens. Here, you can find a variety of live and test URLs for various pages of the Web Storefront. There are URLs for the Homepage and the Product Pages for specific products (click the drop-down and choose any product in the Store), as well as the code to load the Store Builder Library using the selected Web Storefront.

Click the blue Open link next to the desired URL to open the page in a new tab of your browser. You can also copy the resolved URL from your browser's address bar and use that to create links from social media, your website, or email campaigns.

Popup Storefront URLs

Although you cannot link directly to a Popup Storefront using a hyperlink, every Popup Storefront does have a URL. The URL can be found by selecting the Storefronts menu and the Popup Storefronts tab and then clicking the Place on your website command for the desired Popup Storefront.


In the resulting Checkout on your Website dialog, the Popup Storefront's URL appears as the value between the quotation marks for the data-storefront attribute:

Important:  As with Web Storefronts' URLs, you can use Popup Storefronts for live or test purchases. The inclusion of ".test" between the base URL and "" causes the Storefront to load in test mode. When you are ready to begin processing live customer orders, remove the ".test" from the Storefront's URL. For more information about how to implement Popup Storefronts, please see Adding a Popup Storefront to Your Website.