Dr. Advanced Shipping

Frequently Asked Questions

Find quick answers to common questions about Dr. Shipping Calculator, an advanced shipping Shopify app. For further help, contact our support team!

Inserting Widgets Into Your Shop​
Inserting Widgets Into Your Shop
How do I configure this app?
  1. Choose which widgets you’d like to use. We recommend the Cart Summary and Free Shipping Bars (If you use free shipping tiers).
  2. Use the widget installation page to select where on your shop you’d like widgets to appear.
  3. (Optional) Configure the chosen widget to match the colors/sizes of your theme.
If you need to configure your Shipping rates, that will still be done in Shopify:
  1. Click “Shipping and Delivery” in the Settings of your Store
  2. Click “Manage Rates”
  3. Click the three dots next to any rate and then “Edit rate”
  4. Change the “Shipping speed”
  5. Click “Done”
  6. Click “Save” on top of the page!
This is our recommended approach, but there are many ways to combine the two apps.
  1. Disable any widgets you may have configured in Dr. Discount On Cart (no need to delete them, just flip the toggle next to each widget)
  2. Keep Dr. Discount On Cart enabled using the toggle on top of the app’s admin
  3. Configure this app’s Cart Summary widget on the cart page
  4. Discount functionality will be automatically added to the cart summary!
  5. (Optional) Customize the cart summary by going to the “Cart Summary Widgets” => “Customize Cart Summary”, select “All Available Options” to see everything.
  6. (Optional) Customize the discount field above it by going to the Dr. Discount On Cart admin page, and customizing the “Single Discount Field” widget.

Yes, this app works with any kind of theme, Online Store 2.0, and any drawer cart. Some types are more difficult to work with than others. For example, some drawer carts will automatically refresh if you try to inject a widget in them. We can handle any special case using a custom integration. Let us know if you need help.

At this time Online Store 2.0 app blocks are much less customizable than our standard self-installation widgets, but you can use either one. It’s up to you.

In certain themes, you can select either one and click “Expand” and that will work great. On other, that will create a selection that is too big. In this case, select only the subtotal amount, click “Replace”, then hover over the leftover subtotal label and click “Cut”.

Yes, all widgets can be placed on any page, however it is important to note that they always represent the state of the customer’s entire cart, and not only the product on which they are shown. We only receive the entire cart’s shipping rates, and there is no way to break up the price per product. That said, when placing widgets on a product page, please ensure that there is messaging that will suggest to the customer that this represents their cart and not only the product.

Unfortunately no, at this time this app only supports adding widgets to pages controlled by your theme. The Checkout page/flow is outside our control.

In order to ensure that the location you selected can be correctly identified every time a customer loads your shop, our installer will only let you choose an element that has either a ‘class’ or ‘id’ attribute. If a location is not supported feel free to reach out, and we’ll help you add a class/id as needed.

When you publish a new theme, the app may or may not be able to find the original location that you selected to add a widget to. We are responding to theme updates during normal business hours by reconfiguring your widgets for you as needed. There is a period of time after the theme change and before we check your shop, when the widgets may not appear. Feel free to create new widgets if you’re able to do so easily. When needed just ask us for help!

Setting up the widgets on a non-published theme is not much different from setting them up on the live theme.
  1. Go to the Shopify Themes admin, and click the theme preview for the theme you’re installing the widgets on.
  2. Go to the app admin, and do the widget installation as you normally would.
  3. When the shop is opened to choose where to place a widget, you’ll be looking at the previewed theme!

Note! Our app’s widgets are not stored in the theme! Instead, the app remembers where on the page you selected the widgets to be injected. This means that if you make a copy of the live theme, and set up widgets using the copy, the same widgets will also be visible on the live theme, as long as the app is set live! Thus, it’s usually better to set up the app while it’s disabled from the toggle on top of the app’s admin, and not using a duplicate theme.

Special Scenarios
My rates are manually defined by Shopify, and displayed by this app, but the estimated delivery times are missing?
When defining rates in shopify, please make sure to select an option in the “Transit time” dropdown (other than “no shipping time”), so that Shopify can calculate the delivery times, provide them to our app, and we can display them. Please note that the “Transit time” dropdown is not available in all countries – its visibility depends on the origin country of your shop. If you do not see this dropdown when editing rates, that it’s not available for you. Instructions:
  1. Click “Shipping and Delivery” in the Settings of your Store
  2. Click “Manage Rates”
  3. Click the three dots next to any rate and then “Edit rate”
  4. Change the “Transit time”
  5. Click “Done”
  6. Click “Save” on top of the page!

Yes, this app allows you to promote multiple free shipping tiers. To set this up, go to the Free Shipping Bar Customization page, and include the {{ratename}} placeholder in the messages in the “Dynamic Text Variants” section. Then enable the option named “Multi-Free-Rate Promotion”.

Yes, this app allows you to display on the cart the same rates that Shopify calculates and displays on the Checkout page.

If you notice that shipping rates are missing on the cart page, but are visible in Checkout, please let us know!

Most of the time the same rates that are visible on Checkout will also be visible on the cart, displayed by our app. In rare cases we’ve seen that rates generated by another app may not be present on the cart. For example, the Shipeasy app would not return any rates on the cart when it’s in testing mode. Other shipping carrier apps can have the same behavior if they require you to enter some specific data on Checkout in order to trigger their rates while in test mode.

If local delivery rates are set up within the Shopify Shipping and Delivery admin, then the app will display them similar to all other available rates. You need to make sure that you’re using Shopify’s latest Local Delivery configuration.

To set up local delivery, please follow this guide.

Local delivery rates that are set up in 3rd party apps that modify shipping rates should be displayed on cart by default. Please ensure the 3rd party app that’s generating your rates is fully active (if the 3rd party app is inactive and requires custom parameters on Checkout in order to display rates, these rates won’t show up on cart).

No, unfortunately we cannot access the local pick-up data, and it is not returned when we get the available shipping rates, since it’s not really shipping. The only option that we have seen shop owners use successfully is to use the “Custom Note” feature and add a note at a desired position within the cart summary that says something similar to “Local pick-up available in Boston, MA.”

Unfortunately we cannot calculate tax at this time. We hope we’ll be able to add this functionality in the future.

We can filter out unwanted prefixes from shipping rate names (“Advanced Shipping Rates”), just let us know, and we’ll take care of it ASAP.

This suggests that you are using either a volume discount, or product options app, that is modifying cart item prices visually, and applies price changes to the Checkout using special draft orders. To fix this, our app needs to be integrated directly with the volume pricing/product options app that you’re using. Let us know, and we’ll look into it!

Draft order apps that we already integrate with:

You can change all labels that the app generates from English into another language (using the app settings), however there is no multiple-language functionality in this app at this time (all settings can only be set to one version at a time, English being the default). The only way we’ve seen other shops use multiple languages with our app, is using one of these apps in combination with ours. We’re not affiliated with them and any other translation app that includes “3rd party app translation” should work.

 

Weglot Instructions!

Tutorial: How to translate dynamic content?

Translating dynamic elements is done by finding their CSS selector:

By default, our app does not require that your customers enter a city/suburb, however if you use certain 3rd party apps to calculate shipping, the city/suburb input may be required! Without it, you’ll see the “no available rates” message. To enable the city/suburb input, enter a value in the “City/Suburb Placeholder” field in the settings of the cart summary and/or the expandable calculator widgets (whichever ones you’re using).

Developers Only!
How do I configure the app to update the subtotal amount to include shipping?

Add the class docapp-sync-subtotal to the element that contains the subtotal amount. As long as you’re using the Cart Summary widget on the same page, the amount will be updated.

The app exposes an event that you can listen to. Use the data inside the event payload as needed. document.body.addEventListener('docapp-shipping-rate-chosen', (e) => {console.log(JSON.stringify(e.payload));});

Add the class docapp-replaces to the element after locating it in the theme files.

Yes, you can using this test utility link to force the app to behave as if the provided IP address is the customer’s IP address. Just change “109.71.40.1” to any valid IP address. Keep in mind that if you provide a data center or other non-personal-use IP address, it is very likely that no location will be detected!

https://{shop-url}.myshopify.com/cart?docapp-shipping-test-ip=109.71.40.1

To clear the IP override use this link:

https://{shop-url}.myshopify.com/cart?docapp-shipping-test-ip=

Add the code below to the head section in your theme.liquid file, and add the country codes that correspond to the countries that you’d like to display: <script>window['docappShippingAllowedCountryCodes'] = ['US','CA'];</script>

Add the code below to the head section in your theme.liquid file, to define the province codes that are allowed for a given country. Only the countries with defined allowed provinces will be filtered. Other countries will still display all available provinces.

<script>window['docappShippingAllowedProvinceCodes'] = {"{'US': ['NY']}"};</script>