Shopkit setup

One of the first things you should do after installing Shopkit is set up your Site Options. To get started, click Site Options in the top menu.

Let’s walk through the different sections:

1. General

Site name

This should be your business name. It will show up in the title of your visitors’ browser windows, and on PDF invoices.

Featured products

Featured products show up in the left sidebar on every page, directly beneath your logo. This is useful for promoting special deals.

Show quantity in stock

If this box is checked, your visitors will be able to see how many items are remaining in each product’s inventory.

Order notifications

Add email addresses to this section for each person you want to notify when a new order is placed. You can notify different people for certain products. To notify someone of all orders, keep the Products field blank.

Error notifications

Add an email address here to notify someone when Shopkit runs into a technical error.

2. Shipping & tax

Mailing address

Check this box if you want to make sure your customers give their mailing address when they place an order.

Weight unit

Choose the unit of measurement you want to use if you plan to calculate shipping by weight.

Shipping methods

You can add as many shipping methods as you want, and restrict them by country. Want to offer worldwide ground shipping, free shipping to your country, and airmail shipping to select countries? It’s simple with Shopkit.

Click Add the first entry or the + Add button to the right of the Shipping methods box. A pop-up window will appear with the fields required for this shipping method.


Method is the plain-language description of this shipping method. It could be something like Ground shipping (2-4 weeks), or Free delivery. Customers will see this text in the drop-down menu when they check out.

Countries lets you select which countries can have this shipping method. If someone isn’t from an applicable country, they won’t be able to select this shipping method.

The next four fields offer different ways to calculate the shipping rate. Flat rate charges the same amount for each transaction, no matter how many items there are or how expensive or heavy the transaction is. Per item rate lets you charge a certain amount for each item in the cart, no matter how heavy or expensive it is.

Rate by total weight and Rate by total price are more complex, and they let you define different shipping tiers depending on the total weight or price.

You’re not limited to one calculation method. This is where Resolve multiple shipping rates comes in. If you decide to define multiple calculation methods, you can select whether the highest or the lowest rate should apply. This lets you do awesome things like a base flat rate, plus an incremental per item rate if people order a lot of items.

Once you fill out all the information for the shipping rate, click Add to close the pop-up window. Be sure to Save your changes!

Tax rates

You can define an unlimited number of tax rates to cover all the possible countries your shoppers might be coming from. As you did with the shipping methods, click Add the first entry or + Add to define a tax rate.

In the pop-up window that appears, enter the tax rate in decimal format in the Tax rate field. (For example, if your sales tax is 13%, type 0.13).

In the Countries drop-down list, select the countries that this tax rate applies to. You can choose All countries to define a tax rate that applies to all the countries which haven’t been specifically selected.

Default country

This dropdown menu helps Shopkit calculate shipping and tax if we don’t know the visitor’s country yet.

Include tax

Check this box, and all prices in your shop will be handled on a tax-inclusive basis. The formula Shopkit uses to calculate tax when this option is selected is: tax = (tax rate * price) / (1 + tax rate)

3. Payment

Currency options

Enter the appropriate values for Currency code, Currency symbol, Symbol position, Decimal point, and Thousands separator to determine how prices are formatted in your shop.

Because the currency symbol is defined here, you don’t need to put symbols in other price fields, for example when defining shipping rates or product prices.

Pay later settings

Choose which types of users are allowed to pay later. By default, this is restricted to administrators.

Payment gateway settings

You’ll need an account with at least one payment gateway – Square, Stripe, or PayPal – to start selling with Shopkit. Be sure to set the Status to disabled if you don’t want to use a gateway.

4. Discounts

Here, you can add as many Discount codes and Gift certificates as you like. Each code comes with a link that you can share.

5. Design

Last but not least, the Design tab is where you can change the site’s logo, colours, and background image.

License setup

Be sure to add your Kirby license key and Shopkit license key in site/config/config.php. This needs to be done directly in the text file; there is no option to add the license key from the Panel.