I. Introduction

II. Instructions



I. Introduction




In order for ShipMonk to process your orders, we require that you map the shipping options you offer to your customer at checkout on your eCommerce platform (for example, Free Shipping, Standard Shipping, Rush Shipping, etc) to the shipping methods we have available.


Here are instructions on how to map your shipping options using the example shipping methods in the chart below. These hypothetical options would display (to customers) on your eCommerce store at checkout. Your shipping options may look similar or very different, but either way the mapping process is universal to any eCommerce store and can be adjusted to your liking. 



Delivery Time

Cost to Customer

Free Shipping (all U.S. orders)

5 - 7 days



2 - 5 days


Domestic Express

2 days


Domestic Overnight

Next day at 12pm


International Economy

4 - 10 days


International Express

2 - 4 days



If you want a detailed explanation for each option and our recommendation on what would work best for your storefront, visit our blog article on the subject.



II. Instructions


There are two methods you can use to map shipping: 

1. The proactive method in which you map the shipping settings BEFORE your order import to ShipMonk

2. The reactive method where you map AFTER your orders import to ShipMonk


We will cover both methods in this set of instructions. 




1. Proactive Method


Step 1. Hover over the settings gear at the top-right hand portion of the page and click "Stores". Find your store and click "View" to expand the settings for that store.





Step 2. Scroll down to the "Shipping Mapping" section 





Step 3. Click "Add new". Type the name of your first shipping option in the "Requested shipping service from marketplace" section EXACTLY as it appears on your checkout page. It must be identical for our system to map it properly. If it is not entered identically as to how it appears on your checkout page the orders will not map and be sent to Action Required for invalid or Not Chosen Shipping Method.


*NOTE* For these instructions, please remember to reference the chart in the Introduction for the example options we will be using. We'll start with Free Shipping (all U.S. orders). Notice how it's entered verbatim as it's displayed in the chart. 




Step 4.  For domestic shipping options, you will choose from the available shipping services based on the service level you are offering to your customers. After you select a shipping service you are finished unless you need to add an additional service setting which will be outlined in step 4B. 

For international shipping, you can either select a preset template of shipping services that ShipMonk believes are the best options for the speed described or customize your methods for the requested shipping service. If you are interested in utilizing the preset shipping services just choose the one that best fits the service level you are offering to your customers. If you’d prefer to take complete control and utilize custom mapping scroll down to Step 4A.

For the outlying islands, USPS is the only available carrier option. You can select ShipMonk Standard which will prompt our system to always choose the cheapest method between USPS First Class and Priority Mail or you can choose to utilize custom mapping to these two services. 

*NOTE* For our list of Outlying Islands and compatible shipping methods CLICK HERE


Pro Tip: The templates highlighted with a gold star are the ones with methods we at ShipMonk believe provide the best overall value.


Note: For the templates with multiple methods the cheapest method available will be used on each particular order.


Step 4A: To utilize custom mapping (only available for international or outlying islands) choose the custom option and select the add button at the bottom of the column. This will open a pop-up window with all available shipping services and you can choose your preferred method(s). 

Also, notice that you have the option to prioritize a shipping method. If a method is prioritized that will be the default method used on every order for which it is available. If no method is prioritized then we will use the cheapest available of the methods listed. If a prioritized method is unavailable for an order we will choose the cheapest option from the other carriers mapped. If you wish to remove a shipping service just click the red trashcan symbol to the right of the service you wish to remove.

Step 4B: You also have the ability to select the following carrier add-ons (if applicable depending on carrier & additional fees may apply):

  • Saturday delivery

    • A Saturday delivery charge is an added fee to supported shipping services for carriers to deliver a package to a recipient on Saturday, rather than the usual business days of Monday-Friday.

  • Signature required

    • When selected the carrier will require the package recipient or an authorized adult to be present upon and sign that they received their package. This is considered a value-added service and additional fees may apply.

  • Bill duties and taxes to the shipper (international shipments only)

    • If you select this option, the duties and taxes will be charged directly to you and not the recipient of your shipment. The duties vary depending on the country, but a rough rule of thumb is 15% of the retail value of the shipment will be billed to your account during the period adjustments.

If you wish to select or deselect an add-on to a method within the template, click the wrench icon for that method and a window will pop up with the add-on checkboxes that you can then select or deselect.

 Once you have chosen your desired shipping services and added any additional services move forward to step 5.  


Step 5. Click "Apply" and your shipping option will be mapped and show up in the table below. To make changes, you can click the wrench on the far right.



Step 6. Repeat steps 3-5 for each Shipping Option you plan to offer to your customers.  



You're done! Should you ever change or add another shipping option to your store please follow steps 1-5 again to properly map it. 




2. Reactive Method 


Step 1. Hover over "Orders" and click "Action Required" 





Step 2. Find orders that say "Invalid or not chosen shipping method" under "Order Status" and click on the "Order Number" for any of those orders. For this set of instructions, we'll be clicking on order number 276447 which is highlighted in green. 





Step 3. In the "Packaging and Shipping" of the order details page. Notice how "Requested Shipping Service" is outlined in orange. That signifies that a change needs to be made. In this case, we need to map "Express Shipping" to a carrier and method because it hasn't been done; therefore, the order cannot be submitted for fulfillment. To map a carrier to your method, click on "Map Shipping" in the "Requested Shipping Service" column.





Step 4. In the pop-up window select either a template or the custom combination of methods you would like to use.




You'll now notice, in the order, next to "Requested Shipping Service" that it shows the primary method you've chosen in the pop-up window. Now that the method is selected in ShipMonk for the Requested Shipping Service, the system will automatically apply that method to all current and future orders with the same Requested Shipping Service.


Also, at the top of the page where it says "Status", the status of that order will change to "Processing" indicating that the changes were successful and the order is now being processed before submitting for fulfillment. 





You're done! Follow steps 1-4 if necessary for any other orders in "Action Required" that display "Invalid or not chosen shipping method"