How do I set up Supertime and get started?
Please follow the set up steps below for getting started. You can follow along by reviewing each step below here, or reading by the rest of this guide.
Supertime works in automatic detection and placement modes for the free themes in the Shopify Theme Store and also many popular themes. You can learn more about our compatibility with themes in the Shopify Theme Store.
Quick Links to Each Step:
- Review settings and customize your schedule. Once saved and enabled, Supertime will be active on your store cart page.
- Disable Additional Checkout and Dynamic Checkout Buttons and confirm that customers are only checking out through Supertime-enabled carts. Supertime is a cart-based app. Dynamic checkout or additional payment methods in your cart will bypass Supertime at checkout. Review this article on how to configure your store.
- Review your store's language settings. Supertime uses this to determine the correct date and time format for your region. You may also need to customize your store's date format in your liquid templates.
- Update your order status page. Copy and Paste the Supertime code into your order confirmation page template so customers can see their details at checkout.
- Update your customer email template. Drop the Supertime code into your email template to send your customers their selected dates and times.
- Enable Supertime and perform a test order. Place a test order to make sure you have configured Supertime settings to your needs and are working correctly. And you're done!
Want to further customize Supertime? Review our customization articles. Having trouble? Review our troubleshooting guide.
Step 1: Review Settings and Customize Your Schedule
Here's an overview of Supertime settings below. To access your Settings, click on the Settings Tab after accessing the Supertime app in your Shopify Admin's Apps section:
Once you have configured Supertime to your liking, remember to Enable Supertime.
Create Your Delivery Methods and Schedules
Use this section to select which dates you want to show your schedule for, and enable the timeslot option to offer timeslots with a specific start and end time, and the specified increments. Note that you can only select end times that are possible based on the provided increment. You will be able to customize your delivery method with additional settings, customized schedules, and timeslots.
How to Edit Your Delivery Method and Schedules
Use this section to customize your delivery method with the right settings that let you show your customers the right dates and timeslots for selection in Supertime.
Supertime uses a rolling window to calculate your available dates or timeslots. The first timeslot starts from the minimum fulfillment days (either calendar days, or 'schedule days') from today, pushed out by a day if it's past the cut-off time, and the schedule window extends for the number of days in your 'max fulfillment days'.
So in the above example: the first available time would be 2 schedule days from today (since we have just weekdays in the schedule, 2 weekdays from today) if it's before 6:00pm, or 3 if it's after 6:00pm, and we show timeslots for 10 weekdays from that date.
Click here for more on how order limits, and cut-off and prep times work.
Creating different schedules for different days of the week
In your Supertime settings, click the edit icon next to the Delivery Method you would like to do this for. Then, under the schedules section, select a day (Monday, for example), and create your times for that day. Then click the Add New Schedule button and do the same for Tuesday, Wednesday, and so on.
Once done, click the Save button at the top of the page, and then you will have to click Save one more time on the settings page to apply your new schedule to your site.
Blackout Dates
Need to remove a date from selection? Use this feature to remove holidays, time off or specific days in your business. You can do this for a specific method only as well.
Customizing the location of Supertime
Supertime works in automatic detection and placement modes for the free themes in the Shopify Theme Store and also many popular themes. You can learn more about our compatibility with themes in the Shopify Theme Store. If needed, review how to use our custom placement mode. The settings are located in this section.
Text Labels
Customize instructions that you provide to your customers in this section. These are all the text labels will be shown to your customers that can be customized. Supertime auto-translates the rest based on your store's locale.
Additional Settings
You can customize how you Tag your orders (e.g. add dates and times), and you can also add Supertime Details into your order notes in this section.
Once you have configured Supertime to your liking, remember to Enable Supertime.
Step 2: Disable Additional Checkout and Dynamic Checkout Buttons and confirm that customers are only checking out through Supertime-enabled carts
Do you have additional payment methods like G Pay, Apple Pay, PayPal, etc. enabled in your store? You'll need to remove additional checkout buttons on the cart page if you have Additional Payment Methods by following the steps below. Option 1 will defer showing the additional checkout buttons to the checkout stage.
If you do not have additional payment methods enabled for your store, you can skip this step. Once you have removed these buttons, then these payment methods are provided in the checkout page instead, and there are no checkout paths where a customer could bypass date and time collection in your cart.
Option 1: Remove These Buttons Directly In Your Theme Code
Steps (On Desktop):
- From your Shopify admin, go to Online Store > Themes.
- Find the theme you want to edit, and then click Actions > Edit code.
- In the Sections folder, click
cart-template.liquid
. If your theme doesn’t have acart-template.liquid
, then clickcart.liquid
in the Templates folder. - Find the following code and delete it:
- Click Save to save your changes to the file.
{% if additional_checkout_buttons %} <div> {{ content_for_additional_checkout_buttons }} </div> {% endif %}
The additional checkout buttons now appear on the checkout page instead of the cart page.
Steps (On Mobile):
- From the Shopify app, tap Store.
- In the Sales channels section, tap Online Store.
- Tap Manage themes.
- Find the theme you want to edit, and then click Actions > Edit code.
- In the Sections folder, click
cart-template.liquid
. If your theme doesn’t have acart-template.liquid
, then clickcart.liquid
in the Templates folder.Find the following code and delete it: - Click Save to save your changes to the file. The additional checkout buttons now appear on the checkout page instead of the cart page.
{% if additional_checkout_buttons %} <div> {{ content_for_additional_checkout_buttons }} </div> {% endif %}
Option 2: Update Your Theme by following these instructions from Shopify
More detailed instructions can be found here from the Shopify team.
Option 3: Remove these buttons by configuring your Payment Providers.
The simplest way to remove the additional checkout buttons that correspond to payment providers that are visible in your cart. You can change your payment providers by visiting the Payments page of your Shopify admin Settings.
If these payment providers are needed as payment types, then complete the steps provided in Option 1 instead.
3. Review your store's configuration and disable third-party applications that allow users to checkout from your store.
Since Supertime is a cart-based application, if you have third-party applications that enable checkout by creating their own drawer or cart, re-enable the use of the checkout button (for example, a Terms of Condition application), or nudges a customer to go to checkout directly, these paths will bypass date and time collection for Supertime. To ensure the correct operation of Supertime, you will need to also disable the checkout functionality found in these applications.
4. Review that Supertime is showing up in all of your carts on your theme
Review that Supertime is showing up in all of your carts on your theme. Supertime's automatic placement mode may not be compatible with your cart. If this is the case you will need to use our custom placement mode.
5. Disable the checkout button in your cart by default to prevent checkouts without date collection on slow connections
Supertime by default is loaded using Shopify's script tag feature, which means we are loaded after the initial page is loaded, which can lead to Supertime being loaded slowly on slow connections especially if you happen to have a lot of scripts, apps or plugins in your storefront. If a date or time slot is required to checkout on your store, you may want to follow the steps below.
You may want to additionally restrict your customers from being able to checkout with the additional step of disabling your checkout button by default. Otherwise, your customers may be able to checkout before apps like Supertime have loaded in your theme's cart.
- Common occurrences: if you have tried applications that interact with your cart and checkout flow, these can prevent Supertime or the methods below from disabling your checkout button even if you have uninstalled the apps if you have not removed the code snippets created by these third party applications in your cart (e.g. apps from popular vendors like HulkApps)
You can update your theme to disable the checkout button by following the instructions below. Supertime will manage your checkout button's state once it is loaded in your cart.
Method 1: Disable the button directly in your theme
Here's an example of how to disable your checkout button on the Debut theme:
- Visit your store's Theme settings.
- Click the Actions button and select Edit Code. Find your template file where the checkout button would be (e.g. in our case, it's in Sections > cart-template.liquid)
- Add disabled within the <button> or <input> field of the checkout button as an attribute. It should look like the following lines of code for the Debut theme:
- Click the Save button. Your checkout will be disabled by default, and Supertime will enable this button automatically, especially when your customers have provided required information for checkout.
<input type="submit" name="checkout" value="{{ 'cart.general.checkout' | t }}" disabled>
Method 2: Insert a Snippet of Code to Disable Your Checkout Button on Load
Note: This method works if your theme has checkout buttons that have an attribute of name="checkout" and your checkout button is an <input> or <button> element, and your cart isn't a custom loaded via JavaScript.
Steps:
1. Copy and paste this snippet below - this snippet will search for your buttons and set the checkout buttons to be disabled on load before Supertime is loaded:
<script> document.addEventListener("DOMContentLoaded", function(event) { var checkoutButtons = document.body.querySelectorAll('button[name="checkout"], input[name="checkout"]') checkoutButtons.forEach(function(button) { button.disabled = true; }); }); </script>
2. Visit your store's Theme settings.
3. Click the Actions button and select Edit Code.
4. Find your theme.liquid file if you have a cart that is present on all your pages.
5. Paste the provided snippet immediately below your <body> tag in that file (or above the </body> tag)
6. Perform a test checkout
Enable Supertime and perform a test to review all the places where your customers can checkout. Place a test order to make sure you have configured Supertime settings to your needs and are working correctly.
Step 3: Review Your Language and Region Settings
Is your date format MM/DD/YYYY and you want it to be DD/MM/YYYY (or vice versa)? Are you looking to change your time format from 12h to 24h time?
Option 1: Use our Override Option
1. Click on "Use the following region and language for determining date and time format":
2. Select your desired Language/Region.
This will control the date/time format in the Supertime widget in your store, and in the order status code snippet.
Option 2: Update Your Store's Locale
Supertime uses your store theme's language settings to determine the correct date and time format for your region. Click here to review your store theme's language settings to make sure you have configured your language settings correctly. If your store is in English, please review step 4 to change your date format to dd/mm/yyyy.
Steps:
- Visit your Store Languages settings.
- In the Default language section click the "Change theme language" link.
- On the next page, select the correct language for your region from the drop-down menu.
- You may need to select "Other Languages" to find your region. For example, there are multiple English options to support multiple regions. The standard English setting on Shopify uses North American date/time formats (mm/dd/yyyy, 12-hour time). You may need to change to a region that shows date/time formats that suits your locale.
For example: Australian English will show a different date format (dd/mm/yyyy) to American English. If you only see one English option, click on "Other languages..." and then select English, and you will be able to select your region there.
5. Once you have selected your theme language and region, press Save.
Other Date/Time Format Settings
For email notifications and other liquid templates, you can use a localized format that you place in your theme, or you can also provide a custom date format directly in your templates as seen in the snippet examples in Step 5.
For your tag and notes date formats, you will need to review your settings in your Additional Settings section:
Step 4: Add Supertime details to the post-checkout confirmation / order status page
Do you want to show the date/time a customer has picked on their Order Confirmation page?
You can show the selected date, time and delivery method for a customer's order on the post-checkout confirmation page by using Shopify's Additional Scripts feature. Paste the following snippet into the Additional Scripts box on your Checkout settings page:
{% if order.attributes %} <script> SupertimeOrder = { deliveryMethod: "{{ order.attributes["Supertime Delivery Method"] }}", deliveryDate: "{{ order.attributes["Supertime Delivery Date"] }}", timeslot: "{{ order.attributes["Supertime Timeslot"] }}" }; </script> <script async src="{{ "https://getsupertime.com/supertime.js?shop=" | append: shop.permanent_domain }}"></script> {% endif %}
Optionally, if you want to customize the "Delivery Details" title text and add your own instructions text, use this snippet and add your own text:
{% if order.attributes %} <script> SupertimeOrder = { deliveryMethod: "{{ order.attributes["Supertime Delivery Method"] }}", deliveryDate: "{{ order.attributes["Supertime Delivery Date"] }}", timeslot: "{{ order.attributes["Supertime Timeslot"] }}", deliveryDetailsText: "Order Pick-up and Local Delivery Instructions", additionalInstructionsText: "We will be in touch to confirm your availability." }; </script> <script async src="{{ "https://getsupertime.com/supertime.js?shop=" | append: shop.permanent_domain }}"></script> {% endif %}
- Visit your Checkout Settings page.
- Scroll down to the Additional Scripts section.
- In the Additional Scripts text box, paste in the code snippet shown above. Your "Additional Scripts" section should now include this snippet and look something like this:
Click the Save button at the bottom of the page to save your settings.
The deliveryDate and timeslot values will follow the settings that you have provided in your Supertime settings.
You may also customize your Order Confirmation page using Additional Scripts in a more custom manner using these liquid variables:
- Date:
{{ attributes["Supertime Delivery Date"] | date: format: "basic" }}
- Time (24 hour time):
{{ attributes["Supertime Timeslot"] }}
- Time (12 hour time or custom time formats):
{{ attributes["Supertime Timeslot"] | slice: 0,4 | time_tag '%-I:%M %p' }} - {{ attributes["Supertime Timeslot"] | slice: 8,12 | time_tag '%-I:%M %p' }}
- Delivery Method:
{{ attributes["Supertime Delivery Method"] }}
Refer to this article in the Shopify Help Center for additional details.
Step 5: Add Supertime details to my customer order confirmation email
Do you want to include Supertime details in your customer's order confirmation emails? Supertime supports that!
You can show the selected date, time and delivery method for a customer's order collected through Supertime using Shopify's order attribute tags. Paste the following snippets into your customer notification templates in your Notifications settings:
- Date (using localized date formats) :
{{ attributes["Supertime Delivery Date"] | date: format: "basic" }}
- Date (DD/MM/YY, using custom date formats):
{{ attributes["Supertime Delivery Date"] | date: '%d/%m/%Y' }}
- Date (MM/DD/YY, using custom date formats):
{{ attributes["Supertime Delivery Date"] | date: '%m/%d/%Y' }}
- Time (default - 24 hour time):
{{ attributes["Supertime Timeslot"] }}
- Time (12 hour time or custom time formats):
{{ attributes["Supertime Timeslot"] | slice: 0,5 | time_tag: '%-I:%M %p' }} - {{ attributes["Supertime Timeslot"] | slice: 8,12 | time_tag: '%-I:%M %p' }}
- Delivery Method:
{{ attributes["Supertime Delivery Method"] }}
For more details on how to customize email notifications, review this article.
To add Supertime details to your customer SMS notifications, review this article.
Steps:
- Visit your Notification Settings.
- Click on the Order confirmation email template.
- Copy and paste directly into your template, or select your own snippets from above within your capture_body block (e.g. above endcapture in your email):
<p>Date: {{ attributes["Supertime Delivery Date"] | date: format: "basic" }}</p> <p>Time: {{ attributes["Supertime Timeslot"] | slice: 0,5 | time_tag: '%-I:%M %p' }}-{{ attributes["Supertime Timeslot"] | slice: 8,12 | time_tag: '%-I:%M %p' }}</p> <p>Method: {{ attributes["Supertime Delivery Method"] }}</p>
For example, in your order confirmation email, you'll want this code just within your capture_body block:
- Click the Save button.
Step 6: Enable Supertime and Perform a Test Order
Enable Supertime and perform a test order.
Place a test order to make sure you have configured Supertime settings to your needs and are working correctly. And you're done!
Optional Steps
-
Want to further customize Supertime? Review our customization articles. Having trouble? Review our troubleshooting guide.