Troubleshooting by Symptom: Widget Missing, No Delivery Date on the Order, Cannot Proceed to Purchase
screens: Theme editor (app embed / section) / left menu "Option" and "Products"
verified_from: The theme widget (theme-develop) / the checkout validation Function / the theme extension block definition / human-facing FAQ / actual replies to inquiries
note: Causes are "candidates". Do not assert without seeing the merchant's store. Ask for the information in ESCALATE.
SUMMARY
A page for narrowing the cause from the symptom. Do not assert a cause; guide the candidates in the order of checks. One symptom has several possible causes, and many cannot be decided without looking at the store.
The delivery date and time are written by the widget as cart attributes (the order’s “Additional details”). “Not on the order” happens either because the purchase route cannot carry cart attributes, or because the JavaScript did not run before it was written.
Premises (facts of the mechanism)
T-1 The widget writes these to the cart attributes: the delivery date label = date / the delivery time label = time /
(the delivery area label = the selected value) / the key of an input text = the input / the delivery method label = the chosen delivery method.
The key names are the same as the label settings in the admin (if you change a label, the key changes too).
T-2 __ccValid is written only when "Validation for delivery date" (checkout date validation) is ON.
The value is a string holding the selection as a JSON array. The checkout validation (a Shopify Function) reads it.
T-3 __ccSlot is written only when "Customize shipping methods at checkout" (Pro) is ON.
The value has the form "<delivery method number>::<group number>".
T-4 In a cart that is out of scope for date/time selection (a cart excluded by the hidden-products settings. G-8 / G-9),
the widget does not appear, and the attributes above are empty (deleted). Values already entered are not kept on the order (G-10).
T-5 If the app embed (App embed, called "Embeded" in the English theme editor) is active, the widget code is loaded on every page.
If it is placed as a "section" (the "Cart(Section)" block), it is loaded only on the page of the template where it was placed.
Set only one of [embedded apps] or [Cart(Section)]. Setting both loads the code twice.
T-6 Dynamic checkout (buttons such as "Buy it now" / Apple Pay) cannot carry cart attributes, by Shopify's specification.
T-7 The checkout validation, when the cart attribute is "inValid", shows the default error and stops the purchase.
Symptoms: the order of checks
SYM-1 The widget does not appear in the cart
Order of checks:
1. Is the app embed (App embed) active, or is a section placed in the cart template?
→ if neither, it is not displayed (T-5).
2. Are all the products in the cart "hidden products"? Is "Hidden has priority" ON with even one hidden product in the cart?
→ G-8 / G-9. In this case the configured "product note" may be shown instead (G-11).
3. If viewed on the product page: is the product-page section (widget mode) placed?
The settings for the cart page and for the product page are separate.
4. If none of the above applies, go to ESCALATE. A theme-side cart (such as a drawer) or interference from other apps
cannot be asserted without seeing the merchant's store.
- If “the purchase button cannot be pressed / does not appear”: when “Hide the purchase button until the delivery date widget appears” in the theme editor’s app embed is ON, the purchase button stays hidden until the widget appears. Resolve the reason the widget does not appear first, or turn this setting OFF.
SYM-2 The delivery date and time are missing from the order’s “Additional details”
Candidate causes (in the order of checks):
1. The purchase was made from dynamic checkout (buttons such as "Buy it now" / Apple Pay) (T-6).
→ ask them to turn the button OFF. Especially when the delivery date is required.
2. The cart was out of scope because of the hidden-products settings (T-4 / G-8 / G-9). In this case empty is by design.
3. Interference from another app. Likely when attributes other than the delivery date remain on the order and only the delivery date is missing.
→ confirmation with the provider of the interfering app is needed.
4. An external payment function such as deferred payment erased the attributes. Likely when all delivery date attributes are missing.
5. A device problem or a delay in communication prevented the app's JavaScript from loading. Not reproducible.
- If it happens frequently, ask them to contact support with a “collaborator request code” (for the investigation).
- For stores where the delivery date is important (frozen food, fresh flowers, etc.), the countermeasure is “Post __ccValid on load” in SYM-4.
SYM-3 __ccValid / __ccSlot appears in the order’s “Additional details”
Cause: these are values needed for the feature to work.
- __ccValid: "Validation for delivery date" is ON (T-2)
- __ccSlot : "Customize shipping methods at checkout" (Pro) is ON (T-3)
Action: if you use those features, they are required. If you only want to avoid keeping the value, set up a Shopify Flow workflow
that deletes it from "Additional details" after the order (a file is provided in the human-facing manual).
Note: turning the feature OFF stops them from appearing, but the feature itself (validation, shipping method customization) also stops working.
SYM-4 Cannot proceed to purchase at checkout / an error appears
Candidate causes:
1. "Validation" is ON and the delivery date attribute is not attached (the widget did not run, dynamic checkout, etc.)
→ the validation message (set in "Validation message for delivery date verification") appears.
2. The delivery date selected is a date that cannot be selected by the settings (before the shortest date, after the longest date, a blockout date, etc.)
→ a date error message appears. It also happens when the cart was left for several days.
3. A required field (delivery time, delivery area, input text) is empty.
4. "Post __ccValid on load" is ON and the widget code did not load
→ __ccValid stays "inValid" and the validation stops the purchase with the default error (T-7).
→ the customer has to go back to the cart and reload the page.
- “Post __ccValid on load” is a setting item of the theme editor’s app embed (or section). It is for stores where the delivery date is required and that want to stop the purchase when loading failed. There is a risk of losing customers (they cannot proceed to purchase).
- Validation cannot be done with the cut-off time (O-3).
SYM-5 An order was placed with a delivery date before the shortest date
Cause: for example the customer selected a valid date in the cart, then left it for several days before completing checkout.
The cart is validated, but the app does not validate on the checkout screen.
Action: turn ON "Validation for delivery date" (it validates at checkout that the date is on or after the shortest date).
Exception: with a payment method that goes through another site (for example KOMOJU), when the customer is moved to the payment screen
and completes it several days later, the validation does not work. Guide a note text, or ask them to consider another method that allows re-specifying.
SYM-6 The delivery date and time entered in the cart are not reflected on the order
Check SYM-2 item 1 (dynamic checkout) and item 3 (other apps) first. Also tell them the following.
- Right after switching from another delivery-date app, the other app’s code may remain and interfere. Even if it is hidden, it interferes if the code remains. Ask them to uninstall it and check.
- The following app has been confirmed not to work together with this app: Hulk Products Options.
SYM-7 The widget layout is broken
Action: write CSS in the app's "Settings of CSS" (in the app embed in the theme editor) to adjust it.
- Start selectors from .cc-calendar-overall (to avoid affecting other layouts).
- The notation "%}" cannot be used. When using it, add a semicolon as in "width: 100%;".
- There are proven CSS snippets per theme in the human-facing manual.
- Proven case where only the note (remarks) is right-aligned: add `.cc-calendar-overall .note{justify-content:unset}` to the embedded app's CSS.
- If it breaks only for certain selections (delivery method / store pickup, etc.), ask them to identify the element that breaks in that state (screenshot).
SYM-8 The delivery date and time do not appear in the email
See PROC-O3 and ESCALATE in the page Setup: options. The app does not rewrite emails automatically; the method is to paste the code into the template (O-2).
SYM-9 Orders go through with only the delivery time empty (another app may be overwriting it)
Symptom: __ccValid says the time is selected, but the order's delivery time is empty (the date is there). It happens with customers who place orders in quick succession.
Way of thinking:
- This app updates __ccValid and the delivery time together in the same process. A mismatch is unlikely to happen with this app alone.
- Case: another app's code (message card / gift type) wrote the delivery date and delivery time into the cart with a delay and overwrote them afterwards.
Order of checks:
1. Does the value of __ccValid (the 5th element of the array being true = time selected) disagree with the order's delivery time?
2. Does the store have other apps that take messages, gifts or cart operations (those that rewrite cart attributes)?
3. Does another app's code update the "delivery date" or "delivery time" attributes?
Action: ask the other app to stop updating the delivery date and delivery time.
This app cannot guarantee the timing of another app's writes (the one written later remains).
SYM-10 The × of the calendar does not respond / closes slowly on a smartphone
- Handled on the app side (2026-04): the tap area of the × button was enlarged to 44×44px and duplicate event registration was cleaned up.
- If it is still slow: a script of the theme or another app may be the cause.
Case: a script on the cart page fetched /cart.js with synchronous XHR every 0.5 seconds and blocked the main thread.
Check: store URL, device and OS (iPhone / Android), other scripts / apps on the cart page.
SYM-11 The display of the delivery date and time is slow / the initial display takes time
- The app's JavaScript itself loads with little delay. The widget is displayed to match the "checkout" button on the cart page,
so on stores where the theme or other apps generate the button late, the display may be late too.
- Action: fix the display location. Place <span id="cc-delivery-date-time-app"></span> where you want it
(FAQ "Can the delivery date and time be shown anywhere?").
- Check whether another app keeps fetching /cart.js all the time (for example a payment or purchase-related external app).
- Having two #cc-calendar-overall in the HTML is by design (a hidden template is cloned to make the displayed one). It does not cause the delay.
SYM-12 The delivery time options appear in Google search results
- Cause: the widget's text (options, date cells, setting JSON) is placed in the DOM of every page, so Googlebot may read it by running JavaScript and mix it into search snippets.
- Handled (2026-04): the data-nosnippet attribute was added to the widget's elements. It is already reflected in all stores; no setting change is needed on the merchant side.
- When it takes effect: snippets already indexed disappear gradually after Google re-crawls (days to weeks).
- If it does not disappear / depends on the environment: search results look different by account and time. Ask for the page name and the page where the symptom appears via a site: search.
SYM-13 An unfamiliar date such as “Tomorrow 18:59” appears under store pickup
- It may not be this app's display but Shopify's "estimated pickup time" for local pickup.
- Check: Shopify admin → Settings → Shipping and delivery → Local pickup → the "estimated pickup time" setting of that location.
SYM-14 “Validation for delivery date” cannot be turned ON because of the saved size
- Because of Shopify's storage size limit, the size cannot be increased. The app already compresses the data.
- Action (make it smaller):
1. Reduce the number of groups (the surest way)
2. Keep holidays and blockout dates to a minimum (up to about the longest date + 1 month)
3. Set "Automatically delete dates before ..." (automatic deletion of holidays and blockout dates)
SYM-15 The Save button keeps spinning and the settings cannot be saved
- Case: an old "advanced delivery time" setting had not been deleted properly and caused an error in the data at save time.
The merchant cannot see the cause; the data has to be checked and fixed.
- Do not assert; ask for the information in ESCALATE (a collaborator request code is needed).
SYM-16 The cart contents suddenly become empty
- This app has no process that operates on the products in the cart. If it happens even with the app embed turned OFF, this app is not the cause.
- Case: another gift app was the cause.
- Check: does it reproduce with the embed OFF, when does it happen (operation / page), and which other apps are installed.
QA
- Q: There is no delivery date and time on the order. Is it a bug in the app? A: Do not assert. Ask them to follow SYM-2. First ask whether attributes other than the delivery date remain and whether it came from dynamic checkout.
- Q: I want to remove __ccValid. A: It is needed for the feature (SYM-3). If you only do not want to keep it, delete it with Shopify Flow.
- Q: I want to make the delivery date input sure to be required. A: Use the “required” setting + turn ON “Validation for delivery date”. To also detect loading failure, turn ON “Post __ccValid on load” (SYM-4; risk of losing customers). Turn OFF the dynamic checkout buttons.
- Q: Can the delivery date be obtained from dynamic checkout too? A: No (T-6). Turn the button OFF.
- Q: It does not appear on the customer’s device but appears on mine. A: If you cannot reproduce it, do not assert. Ask for the browser, device, network condition and product URL. Non-reproducible loading failures are item 5 of SYM-2.
ESCALATE
| Situation | Information to request |
|---|---|
| The widget does not appear (SYM-1 does not apply) | Store URL, product URL, products in the cart, theme name, browser, a screenshot showing whether the app embed is active |
| The order has no delivery date and time | Order number, a screenshot of “Additional details” (whether other attributes remain), purchase route (dynamic checkout or not), the payment methods and other apps in use |
| It happens frequently | The above plus a “collaborator request code” (to log in and investigate) |
| Stopped at checkout | The displayed message, store URL, products in the cart, validation settings (ON/OFF and the ON/OFF of “Post __ccValid on load”) |
| The layout is broken | Store URL, theme name, a screenshot of the broken part |
| Orders go through with only the time empty | Order numbers (several), the value of __ccValid, the order’s additional details, other apps installed (message / gift type) |
| Cannot save / the Save button keeps spinning | Store URL, the steps, a collaborator request code |
| Display is slow / the × does not respond | Store URL, device and OS, browser, other apps on the cart page |
SEE
- Does it support dynamic checkout?
- The delivery date and time entered in the cart are not reflected
- It is placed on the online shop but the layout is broken
- Orders may be placed with a delivery date earlier than the shortest date
- __ccValid or __ccSlot is now included in the order’s “Additional details”
- Some orders have no delivery date and time
- Validation for the delivery date at checkout
- What is a collaborator request code?
- Can the delivery date and time be shown anywhere?
- Holiday Calendar Settings