In This Article:


    In This Article:


      When to use it

      Storefronts in Salsa are a special way of processing online payments.  Building a storefront essentially consists of two steps:  creating one or more Store Items (a single thing that might be sold online -- such as a book or a bumper sticker); and, creating one or more Storefronts, each of which consists of a set of Store Items that you specify.

      How to get there

      To edit the store items you create, click the "List Store Items" option in the storefronts menu, under the Donation Management tab.  Click "details" to edit an existing store item, or choose "Create an Item" from the Storefront menu in the navigation bar to create a new one.

      To edit the storefronts you create, click the "List Storefronts" option in the storefronts menu, under the Donation Management tab. Click "details" to edit an existing storefront, or choose "Create a Store" from the Storefront menu in the navigation bar to create a new one.


      Store Items

      Name: This is the name the item will have when it appears on the storefront page.

      Description: The description will appear next to the item name and image (if you include an image URL) in the storefront page. This field accepts custom HTML code, with the usual caveats that all custom HTML should be tested before the storefront is made accessible by supporters/shoppers. Salsa Support is not responsible for custom HTML that inhibits or changes the designed usage of the storefront feature.

      Price: This is the price of the item, and may be entered either as an integer (in which case Salsa will change it to include ".00" cents), or a decimal number.

      Note: Storefronts are not set up to collect sales taxes. If you will be required to do that, you may want to fold the sales tax into the cost of the items (if possible).

      Number In Stock: When an item is ordered, the Number in Stock is reduced by one, and when the count reaches zero, the Status of the item will change from In Stock to Sold Out. If you do not intend to use Salsa to control inventory and/or have an effectively unlimited supply and do not want the item to be deactivated from purchase automatically, set an impossibly high number.  

      NOTE: You can only set a total amount limit for items in your stock.  You can't limit the number of a specific item that a supporter can add to their cart at one time. You can state explicitly in the details of the item that they can only purchase x number of items at a time, but there isn't an automated way to limit the number purchased in a transaction (to any less than the total in stock).

      Status: Status determines whether an item is In Stock, Sold Out, In Stock (But Inactive), Discontinued, Not Available, or Other. Items in non-active statuses will remain in the storefront, but cannot be purchased.


      Note: This section lets you add explanatory text in addition to the item description field.

      Image URL: Add the URL for an image here and it will display alongside the item name and description in the storefront page. By default, the image should be 88x69 pixels (if you'd like to customize the image size for your storefronts you can modify the web template).

      Order: This field takes a numeric option, and determines where in the storefront page listing this item will be displayed.


      Options: This field takes custom HTML code, here's an example of code you can use or modify to add sizing options (recorded per-item) to a store item such as a shirt.

      <b>Choose your size</b>

      <select name="option1"><option value="S">S<option value="M">M<option value="L">L<option value="XL">XL<option value="XXL">XXL</select>

      Keep the "option1" syntax regardless of what kind of custom order information you're trying to solicit. An open-ended "enter any text" (for a personalized phrase to print or engrave) might look like this:

      Personalize your item: <input type="text" name="option1">

      Each storefront purchase creates a donation record. The custom option values created with these code strings will save the user's input into that donation record, in the Order_Info field.

      Shipping and Handing: To include shipping costs to an item, enter an amount here. This price will be added to the total order when the checkout process is complete.

      Bulk Shipping: Check this box to combine shipping costs for multiple quantities of items purchased.  (if a supporter purchases 3 of the same item, they only get charged shipping for one item)


      Detailed explanation: This provides a space to enter a more detailed explanation for the store item. The details then show up when you click on the "Show details and purchase" link from the initial store front page.


      Thumbsize: Inactive field; this is a hook for future development, but does not currently do anything.


      Reference Name: This field is a reference that will appear internally within your account for identification purposes, and will not be shown to your supporters.

      Header: The content added to this box will appear at the top of your storefront. Use the WYSIWYG editor to stylize content and add images.


      PreSubmit Footer: Content added to this section appears at the bottom of the the checkout page, where an individual submit their personal information to purchase a store item.


      Store Item Keys: This box lists all store items created in your Salsa headquarters.  Choose the store items you wish to be available on this storefront by selecting as many as you like -- click one and drag to select multiple in a row. Hold Ctrl (PC) or Command (Mac) to select individual items.


      Redirect Path: You can enter a URL here where your supporters will be taken after purchasing. Include http:// or https:// in your URL to ensure a proper redirect.

      Exclude Amex: If your credit card processor does not allow American Express cards, check this box to exclude them from the from.

      Exclude Discover: If your credit card processor does not allow Discover cards, check this box to exclude them from the form.


      User Fields: Make sure to include First Name, Last Name, Email Address, and Address information because these fields are necessary to process a credit card transaction.

      • You can add more fields, including custom fields, by clicking Add a new field and selecting the new field from the drop-down menu.
      • You can make any field required by clicking the "required" check box next to it.
      • Remove fields by clicking the button with the minus symbol to the right of the field name.


      To change the order of the fields, Click the Use Field Order Shown Below box, then change the order of your saved fields by click the drag handle next to any field, and holding down your mouse button as you move it up or down the field list.


      Groups Key: This box lists all groups created in your Salsa headquarters. Choose the groups you wish to automatically add supporters to when they purchase an item. Click one and drag to select multiple in a row. Hold Ctrl (PC) or Command (Mac) to select individual items.

      Email Trigger Keys: This box lists all autoresponses created in your Salsa headquarters. Choose the autoresponses you wish to send when someone makes a purchase. Click one and drag to select multiple in a row. Hold Ctrl (PC) or Command (Mac) to select individual items.


      Template: To brand your page appropriately, you can choose by clicking on the appropriate thumbnail one of the web templates you've created, which will then act as a wrapper for the page's entire content. If you don't choose a specific template, your Default Template will be used.

      Tracking Code: Use this field to enter a default tracking code for all purchases in this store. This tracking code will populate to both the supporter and the donation.

      Merchant Gateway: Select which gateway you want this page to use. Only applicable if you have multiple gateways on your account.


      Was this article helpful?
      0 out of 0 found this helpful
      Have more questions? Submit a request


      • Where can I find custom examples of storefront pages?

        Comment actions Permalink
      • How can I see a history of purchased items?

        Comment actions Permalink
      • This answer is a touch late in coming, but there's a built-in report available under the Donations tab called "Storefront Purchases." More generally, a custom report on donations constrained to the condition Transaction Type = "Purchase" will return store purchases. You'll probably want Order Info returned as a report column, as this is the field where storefronts drop purchase data.


        Comment actions Permalink
      • Is there a way to use discount codes in the store?

        Comment actions Permalink
      • Hi Coby,

        There's not a built-in feature for discount codes, but you could add in an additional product with a negative price.  If a user purchased both products they'd have a discounted total.

        Out of the box, there'd be no validation on that - anyone could "purchase" the discount product.  It would be possible to add a custom field which would require the user to enter a code in order to add the discount product.  This would be a customization that you'd need to speak to your account manager about adding.

        Comment actions Permalink
      • Is there a way to provide a zoomed in/enlarged image of the product? That is, a small sized thumbnail of it, which can be enlarged?

        Comment actions Permalink
      • Why are storefront images so distorted? What is the correct aspect ratio to size a thumbnail so that it doesn't get both stretched AND cropped on the store page? Thank you!

        Comment actions Permalink
      • Hi Christina,

        Good question! This detail was originally left out of our documentation but I've added it now. By default the image should be 88x69 pixels.

        Comment actions Permalink
      • Thank you!

        Comment actions Permalink
      • Great instructions on setting up store items, I find only one problem with adding the size selection is that it will not keep track of inventory of the different sizes.  I would like to see more work on the store front section of salsa as for now it is very limited.

        Comment actions Permalink

      Article is closed for comments.