Documentation menu

Lead times

Tier 1. Lead times tell shoppers when a made-to-order piece arrives. Treadle turns each lead time into dates counted from today, in one format everywhere: "Arrives 24 Nov – 8 Dec", or "Arrives 1–15 Dec" within one month. The dates follow the selected size and fabric, and move when a shopper picks a slower fabric grade.

The fabric picker's folded grade rows, Grade C, Velvet +$600 · adds 4 weeks and Grade D, Leather +$1,200 · adds 6 weeks, above the title block's fields, with Arrives 28 Nov – 12 Dec
Each grade's added weeks, and the arrival dates in the title block (Treadle, Harlow sofa).

Where lead times show #

PlaceWhat it showsSetting
Product page, title blockThe Arrives field, for example "24 Nov – 8 Dec"Title block fields block
Product page, fabric pickerEach slower grade's "adds 4 weeks"Always on, when grades have lead times
Product page, Delivery and assembly rowThe arrival, with the lead time's label under it ("Built in modules, 10–12 weeks")Detail row: Show the lead time
Sticky add to cart bar"Arrives 24 Nov – 8 Dec"Sticky add to cart block: Show lead time
Product cards and To scale rowsThe arrival of the variant the card showsTheme settings > Product cards > Show lead time
Cart drawer and cart page, per line"Arrives 24 Nov – 8 Dec", worked out again on every cart viewAlways on
Cart drawer and cart page, notesThe order's arrival in the Arrives cell, and "Ships together when Wren lounge chair is ready" when one piece holds up the rest. On the cart page, the Lead time note under the dates: "The dates are estimates, from each piece's lead time."Cart section: Show the longest lead time. Cart drawer: Theme settings > Cart > Show the longest lead time in the cart drawer
Order in your admin and at checkoutLine item property "Lead time: 6–8 weeks"Theme settings > Lead times > Save lead time on the order
Order in your adminCart attribute "Longest lead time"Theme settings > Lead times > Save the longest lead time on the order
Order confirmation emailBoth of the aboveNeeds the email snippet

How the arrival is worked out #

Arrives = the base lead time + the weeks the selected fabric's grade adds.

  1. The base is the selected variant's custom.lead_time, if it has one (a size that takes longer). Otherwise it's the product's custom.lead_time.
  2. The grade adds its lead time's Min weeks less the product's Min weeks, never less than 0. A fabric's own Lead time field, when filled in, counts instead of its grade's.
  3. Without a product or variant lead time, the grade's lead time is used on its own.
  4. Without any of them, the theme shows Theme settings > Lead times > Default lead time. It's empty by default, so a piece with no lead time shows no arrival at all.

The dates count Min weeks and Max weeks from today. A lead time entry without weeks shows its label instead of dates.

Examples, with the product set to "Made to order, 6–8 weeks":

  • Grades A and B have no lead time. They add nothing: "Arrives 24 Nov – 8 Dec".
  • Grade C, Velvet, is set to "Special order, 10–12 weeks". It adds 4 weeks. The folded grade row reads "Grade C, Velvet · +$600 · adds 4 weeks", and picking a velvet moves Arrives to "22 Dec – 5 Jan".
  • The Corner size takes longer. Give the Corner variants "Special order, 10–12 weeks". The grades add their weeks on top of that.

A grade can't make a piece arrive sooner than its base. The rows always count from the product's lead time, so they don't change with the selection. How grades add weeks has a full table.

Product cards use the same rule for the variant the card shows, the cheapest one. Cards show the default lead time only if you turn on Use the default lead time when none is set.

Set up lead times #

1. Create the Lead time metaobject definition #

  1. In your admin, go to Settings > Metafields and metaobjects.
  2. Under metaobject definitions, click Add definition.
  3. Name: Lead time. Check that the type below the name reads lead_time.
  4. Click Add field four times and add these fields:

    Field nameTypeKey
    LabelSingle line text, one value. Tick Requiredlabel
    Min weeksIntegermin_weeks
    Max weeksIntegermax_weeks
    NoteMulti-line textnote
  5. Check that Label is the display name. Shopify uses the first text field unless you change it.
  6. Under Access, tick Storefronts.
  7. Click Save.

2. Create the two metafield definitions #

  1. Go to Settings > Metafields and metaobjects > Products and click Add definition.
  2. Name: Lead time. Namespace and key: custom.lead_time.
  3. Click Select type, choose Metaobject, keep One entry, and pick the Lead time definition.
  4. Under Access, tick Storefronts. Click Save.
  5. Go back, click Variants, and create the same definition there: name Lead time, key custom.lead_time, Metaobject, one entry, Lead time.

3. Add lead time entries #

  1. Go to Content > Metaobjects > Lead time and click Add entry.
  2. Fill in the fields, for example:

    LabelMin weeksMax weeksNote
    In stock, ships in 1–2 weeks12
    Made to order, 6–8 weeks68Built by hand in our workshop after you order.
    Special order, 10–12 weeks1012Velvets are cut to order.
    Built in modules, 10–12 weeks1012
  3. Click Save. A few entries are usually enough. When your workshop gets busier, edit one entry and every product using it changes.

The label shows under the arrival in the Delivery and assembly row, so a label that gives a reason ("Hand-shaped shell, 10–12 weeks") tells shoppers why a piece takes longer.

4. Give products a lead time #

  1. Open a product in Products.
  2. In the Metafields card, click Lead time and choose an entry.
  3. Click Save.

To change many products at once, select them in the product list, click Bulk edit, and add the Lead time column.

5. Give slower grades a lead time #

If you use fabrics, open each grade that takes longer in Content > Metaobjects > Fabric grade and choose its lead time. Leave the included grades empty.

Theme settings #

In the theme editor, open Theme settings > Lead times:

  • Default lead time: used when the variant, the product and the fabric's grade have no lead time. It's plain text, empty by default, so a product without a lead time shows no arrival. Fill it in only if it's true of every such product, for example "Made to order" or "Made to order. Ships in 8–10 weeks". Plain text has no weeks, so it shows as written, not as dates.
  • Save lead time on the order:
    • Visible at checkout (Lead time): the shopper sees "Lead time: 6–8 weeks" under the item at checkout, and it's on the order. The weeks include what the fabric's grade adds.
    • Admin only (_lead_time): saved on the order but hidden at checkout. You see it in the admin.
    • Don't save: nothing is added to the order.
  • Save the longest lead time on the order: adds a "Longest lead time" cart attribute. It shows under Additional details on the order in your admin.

Lead time block #

The product templates show the arrival in the title block's Arrives field. If you want it as a line of its own instead, add a Lead time block to the Product section:

  • Show estimated ship dates: adds "Estimated to ship Nov 20 to Dec 4" under the arrival. Off by default.
  • Show the lead time note: shows the entry's Note under the arrival.
  • Rule below: a thin line under the block.

The dates don't account for holidays or your cut-off time, so treat them as a guide.

Troubleshooting #

  • The product page shows no arrival, or the default text instead of dates. Check that the Lead time definition has Storefronts access, that the metafield on the product points to an entry, and that the entry has Min weeks and Max weeks.
  • A velvet doesn't move the date. The grade has no lead time, or its Min weeks aren't more than the product's.
  • One fabric arrives sooner than the others in its grade. That fabric has a lead time of its own. Clear its Lead time field.
  • Two fabrics of the same size disagree. One of the variants has a stray lead time of its own. Clear the variant's custom.lead_time.
  • The cart says one thing and the order another. The cart works out the arrival again on every view. The order keeps the value saved when the item was added to the cart. If you changed a lead time in between, they differ.