> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.delm.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Quickstart guide

Welcome to Delm! This guide provides a high-level overview of how the app works and routes you to the right setup for your store.

---

## 1. How Delm works

Delm is built on a "decoupled" architecture. This means we separate **how it looks** from **how it calculates**.

* **The widget (display):** What the customer sees. It is "context-aware," automatically detecting the customer’s location (IP), language, and selected variant.
* **The rules (calculation):** The logic behind the scenes. Your rules for processing, shipping, transit, and delivery are defined once and applied to all widgets.

**Why this matters:** You can change your shipping schedule in one place, and it updates every widget across your store instantly.

---

## 2. Setting up your calculations

Delm comes with **pre-configured rules** for processing, shipping, transit, and delivery so you can get started immediately. However, to ensure real-world accuracy, these should be customized to match your specific logistics and warehouse operations.

* [How is the delivery date calculated?](/en/article/how-is-the-delivery-date-calculated-1pce3c3/) – A deep dive into the 5-step engine.
* [How do I set different processing times?](/en/article/how-do-i-set-different-processing-times-92n2nl/) – Configuring your warehouse schedules.
* [How do I set different transit times?](/en/article/how-do-i-set-different-transit-times-bpbdg1/) – Configuring your carrier durations.
* [What are exceptions and how do they work?](https://help.delm.app/en/article/what-are-exceptions-and-how-do-they-work-o17mc5/) – A detailed look at how our rule engine works.

---

## 3. Displaying the widget

Once your rules are set, you need to add the widget to your theme. There are two primary ways to do this depending on your theme version and desired location.

* [How can I display delivery dates?](/en/article/how-can-i-display-delivery-dates-1pj7h7e/) – A general overview of all display methods and supported locations.
* [How can I display delivery dates using the app block?](/en/article/how-can-i-display-delivery-dates-using-the-app-block-va2rii/) – Recommended for modern Online Store 2.0 themes.
* [How can I display delivery dates using Liquid?](/en/article/how-can-i-display-delivery-dates-using-liquid-1wmebip/) – **Advanced/Developers:** For manual installation in legacy themes, cart drawers, or collection pages.
* [How can I hide delivery dates?](/en/article/how-can-i-hide-delivery-dates-18z50zv/) – Instructions for hiding dates based on specific conditions (e.g., hiding for Gift Cards).

---

## 4. Design and customization

You have full control over the HTML, CSS, and language of your widgets.

* [How do I use starter templates?](/en/article/how-do-i-use-starter-templates-go5rut/)
* [How do I translate widgets?](/en/article/how-do-i-translate-widgets-1a1jt7s/)
* [How do I change the date format?](/en/article/how-do-i-change-the-date-format-wjiroa/)

---

## 5. Troubleshooting

If the widget isn't appearing or the dates seem incorrect, start here:

* [Why is the widget not showing up?](/en/article/why-is-the-widget-not-showing-up-3sf7fe/)
* [Why does the widget display wrong data?](/en/article/why-does-the-widget-display-wrong-data-1677wbz/)
* [Why is the widget not updating when I change variants?](/en/article/why-is-the-widget-not-updating-when-i-change-variants-1rwa8lh/)

---

## Technical support

If you need further assistance, you can search our help center for specific articles or reach out to us directly via the chat widget in the Delm app. Please note that personalized configuration or custom code assistance requires a plan with **Premium Support**.