Setting Up Supertime and Getting 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.

Quick Links to Each Step:

  1. Review settings and customize your schedule. Once saved and enabled, Supertime will be active on your store cart page.
  2. 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.
  3. Review your store theme'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.
  4. 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.
  5. Update your customer email template. Drop the Supertime code into your email template to send your customers their selected dates and times.
  6. 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!
  7. Do you require date or time info on checkout? You may want to preload Supertime faster in your theme and disable the checkout button in your theme until Supertime loads.

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. 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 out of the box with many themes and configurations by auto-detecting where to place the widget in your store's cart. If needed, review how to use our custom placement mode.

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.

Step 2: Disable Additional Checkout and Dynamic Checkout Buttons and confirm that customers are only checking out through Supertime-enabled carts

Dynamic checkout and Additional Checkout buttons in your theme are designed to bypass the cart step and go straight to checkout, so there is no way for Supertime to capture a date with these methods. If Supertime information is required, We recommend disabling this so all your customers go through your cart page and fill out the Supertime form. Supertime works by providing cart attributes, so you'll need to disable dynamic checkout buttons as recommended by Shopify for compatibility

1. Remove your dynamic checkout buttons by disabling these settings in your theme and removing additional checkout buttons from your product and cart pages.

To remove dynamic and additional checkout buttons from your store, follow the steps provided below. Once you're done you should no longer see "Buy It Now" or branded payment options on your cart or product pages.

Remove dynamic checkout buttons on product pages

Steps (On Desktop):

  1. From your Shopify admin, go to Online Store > Themes.
  2. Find the theme that you want to edit, and then click Customize.
  3. Open the drop-down menu at the top of the page.
  4. Select Product pages.
  5. Click the Product pages section.
  6. Uncheck Show dynamic checkout button.
  7. Click Save.

Steps (On Mobile):

  1. From the Shopify app, tap Store.
  2. In the Sales channels section, tap Online Store.
  3. Tap Manage themes.
  4. Find the theme that you want to edit, and then tap Customize.
  5. Tap Templates.
  6. Select Product pages.
  7. Click the Product pages section.
  8. Uncheck Show dynamic checkout button.
  9. Click Save.

If you don't see the Show dynamic checkout button setting, then you need to update your theme or edit your theme code.

Remove dynamic checkout buttons on your home page

If your home page includes a featured product section with an Add to cart button, then you would need to remove dynamic checkout buttons on that section.

Steps (On Desktop):

  1. From your Shopify admin, go to Online Store > Themes.
  2. Find the theme that you want to edit, and then click Customize.
  3. Click Add section.
  4. Click Featured product, and then click Select.
  5. Enter your product details and uncheck Show dynamic checkout button.
  6. Click Save.

Steps (On Mobile):

  1. From the Shopify app, tap Store.
  2. In the Sales channels section, tap Online Store.
  3. Tap Manage themes.
  4. Find the theme that you want to edit, and then tap Customize.
  5. Tap Edit.
  6. Click Add section.
  7. Click Featured product, and then click Select.
  8. Enter your product details and check or uncheck Show dynamic checkout button.
  9. Click Save.

If you don't see the Show dynamic checkout button setting, then you need to update your theme or edit your theme code. For removing dynamic checkout buttons, you can also review this Shopify help article. For additional checkout buttons, you can review and this Shopify help article. You will need to find and remove these snippets in your theme. 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.

Side Note: If you have payment methods with accelerated checkouts, enabling certain payment methods may bypass Shopify's Local Pickup feature.

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.

If you do not have additional payment methods enabled for your store, you can skip this step.

Steps (On Desktop):

  1. From your Shopify admin, go to Online Store > Themes.
  2. Find the theme you want to edit, and then click Actions > Edit code.
  3. In the Sections folder, click cart-template.liquid. If your theme doesn’t have a cart-template.liquid, then click cart.liquid in the Templates folder.
  4. Find the following code and delete it:
  5. {% if additional_checkout_buttons %}      
      <div>        
        {{ content_for_additional_checkout_buttons }}      
      </div>    
    {% endif %}
    	
  6. Click Save to save your changes to the file.

The additional checkout buttons now appear on the checkout page instead of the cart page.

Steps (On Mobile):

  1. From the Shopify app, tap Store.
  2. In the Sales channels section, tap Online Store.
  3. Tap Manage themes.
  4. Find the theme you want to edit, and then click Actions > Edit code.
  5. In the Sections folder, click cart-template.liquid. If your theme doesn’t have a cart-template.liquid, then click cart.liquid in the Templates folder.Find the following code and delete it:
  6. {% if additional_checkout_buttons %}      
      <div>
        {{ content_for_additional_checkout_buttons }}
      </div>
    {% endif %}
    	
  7. Click Save to save your changes to the file.
  8. The additional checkout buttons now appear on the checkout page instead of the cart page.

If you don't see the Show dynamic checkout button setting, then you need to update your theme or edit your theme code.

2. 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.

3. 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.

4. Disable the checkout button in your cart by default to prevent checkouts without date collection on slow connections (Optional)

If a date or time slot is required to checkout on your store, 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, which can happen with customers on slower connections. If you perform this step, be sure to reverse this change if you need to disable or uninstall Supertime.

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. Here's an example of how to disable your checkout button on the Debut theme:

  1. Visit your store's Theme settings.
  2. 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)
  3. 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:
  4.   <input type="submit" name="checkout" value="{{ 'cart.general.checkout' | t }}" disabled>
    	
  5. 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.

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?

Note: If the below setup steps do not work for your store, you can use our override option by selecting "Use the following region and language for determining date and time format:"

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:

  1. Visit your Store Languages settings.
  2. In the Default language section click the "Change theme language" link.
  3. On the next page, select the correct language for your region from the drop-down menu.

  4. 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.

Note: for email notifications, etc. you will need to review customizing your formatting for your liquid templates.

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 %}

  1. Visit your Checkout Settings page.
  2. Scroll down to the Order processing section.
  3. 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.

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: {{ attributes["Supertime Delivery Date"] | date: format: "basic" }}
  • 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:

  1. Visit your Notification Settings.
  2. Click on the Order confirmation email template.

  3. 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: 

  4. 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!

Step 7: Load Supertime Faster and Disable Checkout Button by Default

Do you require Supertime data for checkout? You may want to perform these steps below.

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 shown slowly 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 preload Supertime in your theme.

Steps:

1. Copy and paste this snippet below:

<script async src="{{ "https://getsupertime.com/supertime.js?shop=" | append: shop.permanent_domain }}"></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, or the relevant cart liquid file if your cart is only present as a single cart page in your theme.
5. Paste the snippet above immediately below your <body> tag in that file. Or paste the snippet within your cart template.

Supertime will now load much sooner than if it was loaded alongside your script tags. Note: If you add this snippet to your theme, you will need to remove this manually when you need to uninstall Supertime.

You may also 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. 

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. Here's an example of how to disable your checkout button on the Debut theme:

  1. Visit your store's Theme settings.
  2. 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)
  3. 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:
  4.                 <input type="submit" name="checkout"                                     value="{{ 'cart.general.checkout' | t }}" disabled>
    	
  5. 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.

Optional Steps