Documentation menu

Drawings

Treadle draws every product as a technical drawing at true scale: a front elevation, a side elevation and a plan from above. The drawings come from each product's dimensions and a few shape settings. They appear on the product page next to the photo, in collections, lineups, the cart, search and the homepage sections, all at stated scales such as "1:25".

You don't upload anything. Fill in the width, depth and height, pick a drawing type, and the theme draws the piece. The shape settings then adjust the arms, legs, back and cushions until the drawing looks like the photo.

The Harlow sofa's photo with its front elevation directly under it, standing on a hatched floor line, dimensioned 180 cm wide and 78 cm high, labeled Generated drawing, Front elevation 1:25, with a scale bar
The front elevation under the photo, at a stated scale (Treadle, Harlow sofa).

What a drawing needs #

DataWhereNeeded for
Width, depth and heightProduct metafields custom.width, custom.depth, custom.height (type Dimension). Variants can have their own.Every drawing and every fit check. Without width or height the piece shows "Made to size" instead of a drawing. Without depth the side view and plan are left out.
Drawing typeProduct metafield custom.drawing_typeThe silhouette. Without it the piece is drawn as a dimensioned box (the envelope).
Shape settingsProduct metafields custom.arm_style, custom.leg_style, custom.back_style, custom.body_style, custom.cushionsThe details of the silhouette. All optional.
DropProduct or variant metafield custom.dropPendants only: the distance from the ceiling to the top of the shade.
ShadesProduct metafield custom.shades (whole number, 1 to 12)Linear pendants only: the number of shades on one bar. Optional.

The exact definitions, with types and choices, are in the definitions reference. Create them once in Settings > Metafields and metaobjects, then fill them in on each product in the Metafields card.

Dimension values can be in millimeters, centimeters, meters, inches, feet or yards. The theme converts them to centimeters for drawing and shows them in the shopper's units.

Drawing types #

Pick one value for custom.drawing_type. The value is the key in the first column; the second column is what the theme calls it.

ValueDrawsFit check
sofaA sofa with arms, back and seat cushionsWidth against the wall
sectionalA corner sofa, an L with the return on the rightWidth and depth against the room, and the width against the wall
chaiseA chaise sofaAs a corner sofa
armchairAn armchair, or a wingback with a high back and armsNone. Cards show W × D × H instead
dining_chairA dining chairNone
stoolA stool, with a footring above 55 cm highNone
ottomanAn ottoman or poufNone
benchA benchNone. Cards show W × D × H instead
bedA bed with headboard, mattress, duvet and pillowsHeight against the ceiling
dining_tableA dining tableWidth and depth against the room
side_tableA side or coffee tableNone
sideboardA sideboard with doorsWidth against the wall
shelfShelving with shelves about every 36 cm, in bays of up to 85 cmWidth against the wall, height against the ceiling
pendantA pendant shade with its cord, canopy and ceiling line, or a bar of shades with custom.shadesClearance above the shopper's table at each drop
wall_lightA wall light in profile against its wall. Cards and lineups state its depth, how far it reaches from the wallNone
table_lampA table lamp, standing on a drawn side table in room viewsNone
floor_lampA floor lamp, or an arc lamp when the width is more than 0.55 × the heightNone
genericA dashed box with diagonals, dimensioned (the envelope)The doorway only

See Your space and fit for what each fit check compares. Only sofas, corner sofas, chaises, sideboards and shelving are measured against the shopper's wall. Every piece also gets the doorway check, except lights and pieces under 60 cm on their smallest side. Types without a fit check show their doorway line in the cart, the sticky add to cart bar and the set schedules.

Sizes that change the shape #

A variant can override the product's type with its own custom.drawing_type. Use it when one size is a different body, such as the corner version of a sofa: the 2-seater and 3-seater variants draw as sofa, and the Corner variants set sectional.

A variant's own custom.width, custom.depth, custom.height and custom.drop win over the product's. You only need variant values for the measurements that change. The drawing, the fit lines and the title block's W × D × H redraw when the shopper picks another size.

Shape settings #

The shape settings are shared across types, so each one means something slightly different per type. Leave a setting empty to get the type's default. An empty arm style draws as square.

Arm style (custom.arm_style) #

On seating, tables and ottomans:

ValueSofas, corner sofas, chaises, armchairsTables, stools, ottomans, dining chairs
squareSquare armsTables, stools and side tables: a square or rectangular top.
roundedRolled arms, with a scroll in the side viewTables: a round or oval top. Ottomans: round.
trackTrack arms: a slab with a soft top, no scrollTreated as square.
flushLow, thick arms (about 40% of the way from the seat to the top), fully rounded on top, in line with the baseTreated as square.
noneArmless. On a curved sofa: a kidney sofa whose back wraps round into two rounded endsDining chairs: no armrests.
domeTreated as square.Treated as square.

On lamps, wall lights and beds the arm style picks the shade or the headboard:

ValuePendantsTable lampsFloor lampsWall lightsBeds
squareA drum, or a cylinder when the shade is at least 0.85 as tall as it is wideA drum shade, drawn tapered as an empire shadeA drum shadeA cylinderA plain panel headboard with sharp corners
roundedA dome, or a globe when the shade is at least 0.85 as tall as it is wideA mushroom shadeA dome shadeA globeA channel-tufted headboard with rounded corners
noneA coneA cone shadeA bowl uplightAn upward-opening coneAs square
domeAs roundedA drum shadeA drum shadeA dome opening downward, the light falling on the wall below itAs square
track, flushAs roundedA drum shadeA drum shadeA cylinderAs square

dome is meant for wall lights. On any other type, pick one of the other values.

A rounded wall light that is wider and taller than it is deep is drawn as a plate sconce: in profile, the plate edge-on against the wall with the globe on it, reaching the light's depth; from the front, the globe inside the plate. For example, a light 23 cm wide, 13 cm deep and 23 cm high.

The silhouette library's lights: a three-shade linear pendant on a bar canopy with its drop, and five wall lights, each drawn from the front and in profile against its wall: a square cylinder, a rounded globe, a tapered shade with no arm, a dome, and a long square bar
Lights in the silhouette library, each wall light against its wall.

On a pendant the shade shape also follows its proportions. With custom.shades at 2 or more, the pendant is a bar of shades (see Shades). Otherwise, a shade at least 60 cm wide and less than 0.45 as deep as it is wide is drawn as a linear bar, and a shade less than 0.22 as tall as it is wide is a disc. An arc floor lamp (wider than 0.55 × its height) always has a dome shade.

Leg style (custom.leg_style) #

ValueUpholsteryTables, chairs and stoolsBeds, benches, ottomans, storage
tallTapered legsDining tables: four square legs with an apron. Chairs and stools: legsBeds and ottomans on legs. Benches: a padded seat on legs with a stretcher. Sideboards on legs.
shortBlock or bun feetDining tables: four round legs. Side tables: a lower shelfBenches: an upholstered block on block feet.
plinthA plinth baseA pedestal. Dining tables under 150 cm wide get one pedestal, wider ones a trestle. Chairs and stools get a tulip baseA recessed plinth.

Long sofas get a center leg on their own.

Back style (custom.back_style) #

  • low: a tight back.
  • high: loose back cushions. An armchair with arms and a high back is drawn as a wingback. A dining chair with a high back gets an upholstered back; a low back is two posts with a backrest.

Body style (custom.body_style) #

  • straight: the default.
  • curved: a curved sofa or a tub chair, with a curved plan and a front view projected from it. Use it for kidney and crescent sofas and for barrel chairs.
  • modular: separate rounded modules with a small gap, for modular sofas and corner sofas. The corner's return is drawn as a module seen end-on.

Cushions (custom.cushions) #

A number from 1 to 4. It sets the seat cushions on seating, the pillows on a bed (2 by default from 140 cm wide) and the doors on a sideboard (one per 45 cm by default). On a modular sofa it sets the modules along the main run.

Drop (custom.drop) #

For pendants: the distance from the ceiling to the top of the shade. Put it on each variant when the drop is an option (60, 80 and 100 cm, for example). Without a drop, the pendant is drawn with a short cord and a break mark, and the fit check can't work out the clearance.

Shades (custom.shades) #

For linear pendants: a whole number from 1 to 12. At 2 or more, the pendant is drawn as a bar canopy at the ceiling with that many shades hanging from it on their cords, evenly spaced. Leave it empty, or set 1, for a pendant with one shade.

For a linear pendant, measure it like this:

  • Width: the length of the bar.
  • Depth: one shade's diameter. Each shade is drawn as wide as the depth, and no wider than its share of the bar.
  • Height: one shade's height, as for every pendant.
  • Drop: from the ceiling to the tops of the shades.

The shades take their shape from the arm style: none draws cones, square (or empty) drums, rounded domes, or globes when a shade is at least 0.85 as tall as it is wide. Room plans draw the pendant from above as its bar and shades, not as one round shade. A three-light pendant 100 cm long, for example, has custom.shades = 3, a width of 100 cm and a depth of 25 cm.

The Ness linear pendant's photo, three cone shades on their cords, beside its room elevation: a bar canopy with three cone shades hung 60 cm from a 250 cm ceiling, 36 cm shades and 79 cm clear above a 75 cm table, Room elevation 1:30
A linear pendant drawn as a bar of three shades over the shopper's table (Graphite, Ness pendant).

How the scale works #

Each view has one scale, worked out from the largest piece in it and the space available. The scale is a standard ratio (1:20, 1:25, 1:40, 1:50 and so on) and it's true at 100% browser zoom: a 1:25 drawing of a 200 cm sofa is 8 cm long on screen.

  • Every drawing in a view uses the same scale, so a 180 cm sofa is never drawn larger than a 220 cm one on the same page.
  • Each product page layout has its own scale: about 1:25 for the drawing on the floor line, 1:40 for the room elevation and 1:50 for the room plan, and 1:60 on phones. Lighting pages draw at 1:30. A room that can't fit at the page's scale is drawn at the largest scale that fits.
  • Theme settings > Drawing sheet > Largest drawing scale caps how large anything is drawn (1:10 by default).
  • A generated scale bar (0, 50, 100 cm, for example) stands next to drawings, at the drawing's real length.
  • The footer's title block states the scale of the page's main drawing, at the scale it's drawn. On a product page that's the drawing with the photo, so a wall light's room drawn at 1:40 on a 1:30 lighting page says 1:40. On home and collection pages it's the room plan when one is shown, else the Lineup hero or the scale the cards state. Any other page with several scales says "As drawn". Pages without drawings say "Not to scale".

Units #

Every measurement is shown in centimeters or inches. Theme settings > Drawing sheet > Default units sets the starting unit. Shoppers switch with the cm / in toggle in the footer and in the Your space panel, and their choice is remembered. Inches are rounded to the nearest half inch.

Labels and the text alternative #

Generated drawings carry the label "Generated drawing". Turn it off in Theme settings > Drawing sheet > Label generated drawings. Your own uploaded drawings are labelled "Drawing".

Every drawing has a text alternative for screen readers, for example "Front elevation and side elevation of Harlow sofa. 180 cm wide, 98 cm deep and 78 cm high, drawn at 1:25." The caption under the drawing repeats the dimensions as visible text.

Your own drawing (custom.drawing) #

If you have a real technical drawing, upload it as an SVG or an image to the product's custom.drawing metafield (type File). It replaces the generated drawing in the product page's full drawing.

The theme still uses the generated drawing everywhere it compares pieces at one scale: the drawing under the photo, room views, lineups, To scale rows, cards, the size picker and the cart. So keep the drawing type and the shape settings filled in, even with an upload.

Where drawings appear #

PlaceWhat's drawnSet up in
Product page, first screenThe front elevation under the photo, a room elevation beside it, or a room plan beside itProduct section: Drawing
Product page, full drawingFront, side and optionally plan, with dimensions and a scale barProduct section: Full drawing views
Size pickerEach size drawn small, against the shopper's wallVariant picker block: Size options
CollectionsTo scale rows, the Lineup view, drawn cards, plan cards, a room plan above the gridProduct grid section. See sections
HomepageLineup hero, Photo and drawing, Room elevation, Room plan, drawn collection cards, drawn rowsSee sections
Complete the set, recommendations, recently viewedThe set in a room or on a floor line; drawings on cardsEach section's Layout or Card style
TestimonialsThe piece a note is about, on a floor line or as a planTestimonials: Pieces on notes
Header menuDrawn categories in mega menusHeader: Drawn categories in menus
CartA small drawing on each line, and the whole order drawn togetherTheme settings > Cart
Search, 404, empty cart, password pageDrawings at one scaleEach section's settings
The Sofas collection in the To scale view, every piece drawn at 1:20: the Harlow sofa's front elevation, 180 cm, under a dashed bracket for the shopper's wall of 245 cm, with its photo, price, arrival dates, Fits 65 cm to spare, View and Order sample
The To scale view, with the shopper's wall as a bracket (Treadle, Sofas).

The silhouette library #

The silhouette library is a page that draws every drawing type and shape variation at one scale: 24 seating variations with the adult figure, beds, tables and storage, lamps, pendants and wall lights, the plans, and the fallbacks. Use it to see what each setting draws before you fill in your products.

  1. In your admin, go to Online Store > Pages and click Add page.
  2. Title: Silhouette library. Leave the content empty.
  3. Under Theme template, choose drawing-library.
  4. Click Save, then View page.

Leave the page out of your menus. When you're done with it, set its Visibility to Hidden so shoppers can't find it.

In the theme editor, choose Pages > drawing-library to edit the Silhouette library section:

SettingWhat it does
Label above the heading, Heading, TextThe page's heading.
Scale on desktopAutomatic, or a fixed 1:15 to 1:30.
Scale on mobile1:30, 1:40 or 1:50.
Show plansAdds the plan views.
Products to draw from their metafieldsYour own products, drawn after the library from their dimensions and shape settings.
Product with an uploaded drawingA product whose custom.drawing has a file, to show the uploaded-drawing fallback.

The group of your own products shows only when you pick products. Until you pick them, the theme editor says what to choose; the live page shows neither the group nor the prompts.

The silhouette library's Seating group: the adult scale figure, 175 cm tall, beside a sofa drawn from the front and the side, 220 × 96 × 82 cm, with its shape settings: square arms, tall legs, low back, three cushions
The silhouette library's seating group, with the adult figure.

The library and the Shape check page draw a lot of SVG, so they're slower than a normal page. Keep them hidden from shoppers.

Type specimen #

The specimen page template shows the active style's fonts, type scale, colors with their contrast ratios, line weights, price styles, fit states, the space chip and a product's swatches and drawing. It's a design check for your colors and fonts. Create it the same way, with the template specimen. In the Type specimen section, set the Label above the heading, Heading and Sample heading (a line set in every heading size), pick a Product for the price, swatches and drawing, and optionally a Drawing type override to draw it as another type.

Drawing sheet settings #

The page frame and the drawing style are in Theme settings > Drawing sheet. See theme settings.

Troubleshooting #

  • A product page has no full drawing, or a To scale row says "Dimensions on request". The product has no width or height. In the theme editor, its page says so where the drawing would be. Check the keys (custom.width, not custom.product_width) and that the type is Dimension, not text.
  • A product is drawn as a dashed box. It has no custom.drawing_type, or the value isn't one of the types above.
  • The drawing has no side view or plan. The product has no depth.
  • The corner size draws as a straight sofa. Give the corner variants custom.drawing_type = sectional.
  • A pendant hangs from a short cord with a break mark. It has no custom.drop. Set the drop on the product or on each drop variant.
  • A pendant with several shades draws as one bar or one wide shade. Set custom.shades to its number of shades, the width to the bar's length and the depth to one shade's diameter.
  • A wall light with a downward shade draws as an upward cone or a cylinder. Set its arm style to dome. If the choice is missing, add dome to the Arm style definition's choices.
  • The drawing doesn't change with the size. The size variants have no width of their own, or the variant definitions are missing. See dimensions per size.
  • My uploaded drawing doesn't show in the collection. That's expected. Uploads replace the product page's full drawing only.