Skip to main content
1. Configure the Shipcloud app for Shopify

How to connect Shipcloud with Shopify

Ina Kahl avatar
Written by Ina Kahl
Updated over a week ago

Connect Shipcloud easily to your Shopify shop and create your shipping labels directly from your backend.


In this article, you will learn how to easily connect and set up the Shipcloud app with your Shopify backend.

In this article 👇


1. Download the Shipcloud app for Shopify

Log in to your Shopify backend and select "Apps" from the menu bar on the left. You will now see an app overview of your already installed apps on the right. Click on "Customize your store" to be redirected to the Shopify apps store.


Enter "Shipcloud" in one of the two search fields and press Enter. The Shipcloud app for Shopify will now be displayed.


Now select it to open the app detail page. There you can download the Shipcloud app for Shopify for free by clicking on the green button "Add app".

You will then be automatically redirected back to the app overview in your Shopify backend, where you will find the installed Shipcloud app.


2. Connect your Shipcloud account with Shopify.

Click on the Shipcloud logo in the app overview to open the user interface of the Shipcloud app. Now click on "Preferences" in the Shipcloud menu.


To be able to connect both systems, you need your Shipcloud API key. In your Shipcloud account, click on your email address in the top right corner, select "API Key" from the dropdown menu and copy the top API key (for your live environment).


Good to know: If you only want to test the technical functions of Shipcloud, you will need the Sandbox API key. However, this only allows you to create test shipping labels.


Paste it in the field "API key" in your Shopify backend and click ""Save". It may be necessary to perform a hard refresh to clear the cache and reload the page so that your API key is read and applied correctly.

Good to know: If you want to test the functions of Shipcloud first without affecting your live operation, you can store the sandbox key here.


3. Configure your Shipcloud app in Shopify.

In the menu item "Preferences" of the Shipcloud app in Shopify, you can make customizations.

Default carrier

Set here which carrier, service and package type should be set as default or pre-filled when creating a shipping label.

Good to know: You can still customize the preferred carrier when creating the label.


Package sizes

Store your package sizes or package templates here. This way you can specify the standard dimensions of your shipping boxes and do not have to enter them manually when creating the label.

To do this, click on the button "New package size" and enter a name for the package template as well as the corresponding package dimensions in the mask that opens. If you want to use one of your package templates as a pre-filled standard template when creating a shipping label, check the box. Finally, click "Save" to apply your settings.


Afterwards, the package template will appear in overview and can be edited and deleted from there. If you do not want to store any standard package dimensions, you can skip this step.

Good to know: Package templates allow you to batch process your orders even more efficiently.


Standard from address

Define here which shipping address should be displayed on your shipping label. You can select your company address stored in the Shopify backend or the shipping address stored in your Shipcloud account.


In addition, you have the option to store an alternative shipping address. For this, select the option “Define custom address" and store and save it in the mask that opens.

Good to know: Maintaining an alternate shipping address in Shopify is useful, for example, if you want your shipping labels to display an address that is different from your pickup address. Only your ship from address maintained in Shopify will then be used for label creation. However, if you want to transmit a different shipping address to the carriers for pickups, we recommend that you store this specific address as default ship from address in your Shipcloud account and request pickups directly in the Shipcloud webUI.


Pickup Requests

Specify here when your express shipments should be picked up. If you have not contracted a standard pickup for your express shipments with ANGEL or DHL activate the corresponding checkboxes here and specify a standard pickup time window, if desired. Then click on "Save". If you do not wish to use this service, you can leave these fields blank.

Good to know: You can only use this service in conjunction with your own contract with these carriers. If you ship via Shipcloud business rates, you can request pickups for UPS Express shipments via API Request. You can find out how to book sporadic pickups for your standard shipments (no express) here.


Fulfillment settings

Make general settings for the fulfillment status, shipping notifications and weight calculation here.

Enter information about the package contents in the first field "Paket-/ Sendungsbeschreibung" ("Package/Shipment Description"). Here it is recommended to work with dynamic references or with ,liquid vars. You can open the list of available liquid Vars by clicking on the black {/} sign.

In the field "Referenz" ("Reference") you define the reference for all your shipments. Again, it is recommended to use liquid Vars. For example, you can store the order number or the liquid var { {order.order_number } } here so that it will always be displayed as the reference number on your shipping labels.

Select the checkbox "E-Mail-Adresse des Kunden an Shipcloud übermitteln" ("Submit customer's email address to Shipcloud") so that your recipients can receive a standardized tracking email about the shipping status of their order from Shipcloud. On the other hand, if you select the checkbox "E-Mail-Adresse des Kunden an Versanddienstleister übermitteln" ("Submit customer's email address to carrier",) your recipients will receive a separate shipping notification from the respective carrier.

Check the box "Gewicht der Bestellpositionen verwenden" ("Use weight of order items") if you want all item weights from the shopping cart to be added automatically. To do this, you must have maintained your product details and previously assigned a weight to each item.

Define a default packaging weight in the field "Zusätzliches Verpackungsgewicht (g)" ("Additional packaging weight (g)") if you want this to be automatically added to the item weight. This setting is useful if your shipping boxes have a consistent weight.

If you use the weight of the order items and have specified a default packaging weight, the total weight will be calculated automatically and displayed on the shipping label.

Finally, click on "Speichern" ("Save") so that your settings are applied.

Sofern Sie das Gewicht der Bestellpositionen verwenden und ein allgemeingültiges Verpackungsgewicht angegeben haben, wird automatisch das Gesamtgewicht berechnet und auf der Versandmarke angezeigt.


Good to know: Settings you make here will be applied to all shipments.


Customs settings

Store standard information for your dutiable shipments in the fields "Content" and "Origin country" here. In the field "Content explanation" you can enter information about the article or alternatively define a liquid var as reference.

In addition, use the checkbox "Enable create customs declaration by default" to specify whether a customs declaration should be generated for all your shipments. Lastly, click "Save" to have your settings applied.

Good to know: You will need customs documents for your international shipments to a non-EU country. You can find more information here.


Return shipments

Specify here whether a return label should be created automatically and directly for all your returns. Then click on "Save". If you do not want to do this, you can skip this step.


Bank account

Enter your bank details for the Cash on delivery service here.

Good to know: The Cash on delivery service can only be added if you have your own contract.


Any further questions? We will be happy to help you.


These articles might also interest you 👇

Did this answer your question?