This guide explains how to configure the Display & Position settings to customize the Estimated Time of Arrival (ETA) widget on your Shopify store.
Configure to show on store
Activate App
- Purpose: Enable or disable the ETA widget across your store.
- How to Use:
- Activate App: Switch the toggle to “On” to enable the widget.
- Deactivate App: Switch the toggle to “Off” to hide the widget.
Add App to Store Theme
Choose how to integrate the ETA widget into your store theme. Three methods are available:
- Add App Block: Easily add the widget as a block using Shopify’s theme editor. Click “Add block” to insert the widget into your store’s desired section.
- Embed App: Place the widget through Shopify’s theme editor without writing code. Click “Embed app” to automatically position the widget in your theme.
- Manual (Custom Liquid Code): For advanced customization or precise widget placement.
- Copy the provided HTML snippet:
<div class=”ot-estimated-shipping”></div> - Insert it into the desired section in the Shopify theme.
- Copy the provided HTML snippet:
Note: If using Page Builder, embed the app in Shopify’s Theme Editor and add the custom liquid code in the Page Builder’s editor.
Configure for Specific Places
Control where the ETA widget appears on your store.
Pages
- Purpose: Specify which pages the ETA banner displays on.
- Options:
- Product: Show widget on product pages.
- Home: Show widget on the home page.
- Collection: Show widget on collection pages.
- All Pages: Display the widget across all store pages.
- Custom Positioning: Custom code positioning.
Note: Rules with conditions may not display correctly on non-product pages due to Shopify’s limitations.
Show Banner When Inventory Is Not Tracked
- Purpose: Display the ETA banner for products or variants that do not have “Track quantity” enabled in Shopify admin.
- How to Use: Click “Grant inventory permission” to provide necessary access, then toggle on feature.
Date Mode of Delivery Estimates in Cart and Checkout
Choose how the ETA widget displays delivery estimates in the cart and checkout process.
Static date | Dynamic date | |
Compatibility | Any theme | Shopify themes |
How it works | This displays a static delivery date when the product is added to the cart and remains unchanged, even if the customer revisits the cart later. | This dynamically updates the delivery estimate based on the current date, ensuring accuracy if the customer revisits their cart. |
Placement | ||
Cart page | ✓ | ✓ |
Cart drawer | ✓ | ✓ |
Cart popup | ✓ | x |
Checkout, Thank you, Order status page | ✓ | x |
✓ | x | |
Orders | ✓ | x |
How to check if a theme is compatible with dynamic date?
Inspect the cart page or drawer in the “Elements” tab. Ensure it includes cart-item
, cart-item__details
, and dl
(written exactly like this) in the correct nesting order from outer to inner elements.
Show Message Text in Email
Since Shopify doesn’t allow third-party apps to modify emails directly, you can manually add the delivery estimates by following these steps.
Note that these instructions usually work for Shopify’s default email template. If you use a different template, it might not work as expected. Please contact us for support.
- Go to Store Settings > Notifications > Choose email template that you want to add message text
- Inspect the line in a product cell (press F12 or right-click > Inspect) below which you want to display delivery estimates. The best practice is below the discount code. Copy the span class, here is:
class="order-list__item-discount-allocation"
3/ Click Edit code. Ctrl F and paste the class you have copied to search its location. Then paste this code below {% endif %} and above </td>Copy
{% for p in line.properties %}
{% unless p.last == blank %}
{{ p.first }}: {{ p.last }}
{% endunless %}
{% endfor %}
FAQs: Why banner is not displaying
If your banner isn’t appearing on the store, even when you think the rules are set correctly, there might be some overlooked conditions.
If none of the rules are showing, it’s usually easier to diagnose the problem. However, if only some rules aren’t displaying, troubleshooting can be more complex. In that case, feel free to contact our support team for assistance.
1. App is not embedded or App block is not added
If the app isn’t displaying correctly, it could be due to a missing integration with your theme.
Possible issues
- The app is not embedded within the current theme.
- The app block hasn’t been added to the theme.
Resolution:
- Review the Setup Checklist: Go to the Home section of the app to verify whether it’s embedded in your current theme.
- Manually check: Open the Theme Editor to ensure the app block has been added to the appropriate page sections.
2. App is embedded but still not displaying on store
For most cases, you can inspect the issue using the browser’s Developer Tools:
- On MacOS, press: ⌥⌘I
- On Windows, press: Ctrl+Shift+C
Once there, navigate to the Console tab to identify any errors or warnings.
Here’s how you can check and resolve common issues:
2.1 No rule is set for the product
Console message: No rule matched condition
This indicates that the banner is not displaying because no applicable rule has been found for the product.
Possible issues:
- The product is not included in any rule.
- The product is specifically excluded from a rule.
- The product belongs to a collection that is excluded from a rule. Note that a product can be part of multiple collections, so check all relevant collections.
- The detected location is not covered by any rule.
Resolution: Review display condition of rules to ensure the product, collection, and location align with the intended rules. Adjust the rules as needed to include the product or collection.
2.2 Product is out of stock
Console message: Out of stock! Current variant's inventory quantity: [inventory]
This indicates that the product variant does not have available stock.
Resolution: To ensure that the banner appears even when the product is out of stock, try enabling the show message when out of stock option in the rule setup. This will allow the banner to display regardless of inventory status.
2.3 App is not set to display on page
Console message: isShowOnCurrrentPage false
This suggests that the app is not configured to display the banner on the current page.
Resolution: Review Display & Position settings to ensure the banner is enabled for the page where you expect it to appear.
2.4 App is not enabled
Console message: enableAppSetting false
This means that the app is currently disabled, preventing any banners from being displayed.
Resolution: Try to activate app. Once activated, the banners should begin displaying as per the configured rules.
2.5 There is no workday
Console message: isValidWorkingDays false
This indicates that no working days have been configured.
Resolution: Review settings of workdays, cut-off time, blackout dates.