STEP BY STEP GUIDE

Building Your Store

Koigo cart lets you to build a store by adding html tags for add to cart and view cart buttons to any website. It handles the order details and payment processing in a cart that overlays your page.   Your website controls the appearance of the Koigo cart buttons. You administer the cart, payment processing, shipping, invoicing and your products through the Koigo online app at koigo.io/app 

Getting Started

Sign up for the 30 day free trial at koigo.io/subscribe. You'll get a confirmation email - click on the link to confirm your email address and then login at koigo.io/app. Here's a screenshot of the app:  

Koigo app Dashbaord section

The Dashboard shows recent activity. 

In the panel on the the left are controls for the rest of the setup.     We'll walk through them in order.


Click Edit to enter basic information about your store that your customers can see. This includes your contact email, cart currency etc.

Download Link Lifespan: For security reasons, you'll want to limit this to a reasonable value so that your files aren't shared online. If you're selling physical products with files, you might want to make sure the Lifespan is long enough to allow for shipping of the physical product that it goes with. 

Similarly, the Max Hits should be enough to make sure the file can be downloaded but not so long as to encourage escessive sharing.

Shipping calculation includes non-phyisical items: Decide whether bundled downloads count towards any free shipping threshold you offer (see Shipping Rules, below). Sometimes customers will add files to get enough in the cart for free shipping. You decide if this is what you want.


Click Edit if you'll be charging tax.

You can set a Default Tax Rate that you charge to everyone, or add 'Regional Tax Rates' for countries and states or provinces. You can also give the tax a name and add a tax number that will appear in customer invoices.


Shipping rules determine how much you charge for freight or delivery and how it's calculated. If you're only selling downloads or you don't charge shipping at all, go ahead and skip this step.

Click Create to make a rule. You can make as many different Shipping Rules as you need.

Each Shipping Rule has a Name that identifies it in the Koigo app and a Label that the customer sees in the Koigo cart.

Shipping Rules are based on:

Shipping Countries/Regions - where the item is going

Pricing Calculation - how you'll calculate the rate. You can select Free, Flat Rate or Advanced Options. Advanced allows calculation of cost per item, percentage of order cost or by weight or weight range.

Additional Options - refine with thresholds for order size, free shipping etc

Flat Rate of $10 up to $75 order total:

Select Flat Rate Pricing, then under Additional Options > Set a Free Shipping Threshold select By Cost. Enter a currency value (eg $75) at which free shipping will be offered.


Charge shipping by weight range:

For example:
$10 up to 1 lb (Weight Range 1),
$20 over 1 lb up to 5 lb (Weight Range 2),
$30 over 5lb (Weight Range 3):

Under Calculation Type select Charge by Weight Range

Enter the Weight Units you want to use for the calculation, in this case lb, oz

Set your weight ranges and charges:

Weight Range 1: Min weight = 0 lb 0 oz, Max weight = 1 lb 0 oz, Charge = $10

Weight Range 2: Min weight = 1 lb 0 oz, Max weight, = 5 lb 0 oz, Charge = $20

Weight Range 3: Min weight = 5 lb 0 oz, Check 'Unlimited' for the Maximum Weight.


Koigo Cart collects order information from your customer and provides a secure interface to your payment processor. You can accept payments using Stripe or PayPal. Click Edit to connect Koigo to Stripe and/or PayPal.

If you select Stripe, you'll be given the option to open a new account or connect to an existing one.

For PayPal, enter the email address of the PayPal account that you will use to accept payments. If you haven't set up a PayPal account, visit PayPal.com to do so.

You can specify the available payment methods by the customer's location. If the customer selects a country or region that you haven't made available for Stripe or PayPal, that payment method will be hidden.


You can add products one at a time in the Product Manager or upload any number at once in Product CSV Import. The Item Number you enter here will be used in the cart to reference the product when you build your site.

For bulk uploads, you should download the CSV Template and fill in the values needed. Remember to save as a csv. Use commas to separate values; quotes aren't needed for text values. Don't save any additional formatting. You can use Excel, Open Office, Libre Office or any other csv program.


If you have digital products, you can use the File Manager to upload files one at a time, or File Uploader to upload multiple files. You can also manually send digital download links using File Manager. The file names you use here need to match the file name that you've used for the digital product in the Product Manager.

File Uploader lets you upload many files at once using a system dialog.


Invoice Manager lets you search existing invoices, and save or send invoices. If you've selected Send Order Confirmation Emails to Buyer under Store Settings, these are sent automatically when a purchase is made, but you can re-send them here.


HTML Tags generates tags that you use to build your shopping page.

Koigo generates two kinds of button tags for your site:

KoigoAdd() which builds an add-to-cart function, and

KoigoView() which builds a view-cart function.

You can style these however you like in your site using css, or use them in tags other than buttons, like cart icons.

1. Include the Koigo script tag in every page

<script src="https://js.koigo.io/v1" data-koigo="unique_identifier_from_your_dashboard"></script>

First, copy and paste the script tag in HTML Tags > Step 1 from the Koigo app into every page that will have a Koigo button. A good place is just before the closing </body> tag. The contents of thedata-koigo field is the unique identifier for your cart.

2. View Cart tags

Copy and paste a KoigoView() tag from HTML Tags>Step 2 wherever you want an View Cart button.

<button onclick="koigoView()" type="button">View Cart</button>

The resulting button will be displayed using the existing formatting from your page. If you've used css to style your buttons, Koigo will follow that style. You can use images or other elements for cart buttons - anywhere you can add an onclick method you can use KoigoView() to display the cart. For example, in our demo page we've used a cart icon to display the cart like this:

<i class="fa fa-shopping-bag" img onclick="koigoView()"></i>

Notice that clicking on the shopping bag has no effect here because the page you're reading doesn't have the Koigo script tag.

3. Add to Cart tags

The KoigoAdd() tag needs you to specify the item number that should be added when it's clicked.

<button onclick="koigoAdd('item_number')" type="button">Add to Cart</button>

Just replace item_number with an item number that you've already added in the Product Manager.

Of course, you can use onclick="koigoAdd('item_number')" with images or icons as well, and the styling will follow your css.

And that's it, you're all set!

Here's a sample html file with all of the script elements for a basic shopping page:

<!doctype html>
<html>
<head>
<meta charset="utf-8">
<!-- optional link to css styling for a custom button appearance -->
<link rel="stylesheet" href="your_styles.css">
</head>
<body>
<!-- pictures and description can go here -->
<button onclick="koigoAdd('item_number')" type="button">Add to Cart</button>
<button onclick="koigoView()" type="button">View Cart</button>
<!-- more content here -->
<script src="https://js.koigo.io/v1" data-koigo="unique_identifier_from_your_dashboard"></script>
</body>
</html>

See a live Koigo cart demo here


The ShipStation tab in Koigo app has the steps you take to be able to send orders to ShipStation*. You would need to sign up with them separately, and then follow our procedure to generate the 'endpoint' which supplies ShipStation with your order data. You'll need a custom username and password that Koigo app generates for you in the last step of the set up procedure.

*Koigo is not affiliated with ShipStation, but we're happy to provide an endpoint to use with their service. Trademarks belong to the registered owners.