Dock leveller gradient, working range and shelter fit as configurator rules
How a loading bay configurator calculates dock leveller gradient, checks working range, lip and shelter fit, and suggests a leveller length.
Short answer: a loading bay configurator needs one calculation and several checks. The calculation gives the leveller's gradient from the height difference between dock and truck bed over the leveller's length. The checks ask: is the deck front within the working range? Does the lip rest far enough on the bed? Does the shelter seal against the vehicle? Does the leveller fit the vehicle's rear opening? If the gradient is too steep, the configurator suggests a fix. Our example shows this with example values for a fictional product.
Which parameters does a loading bay have?
The example configurator leads through seven steps: bay, vehicle, leveller, shelter, extras, review and enquiry. The inputs that drive the calculation:
| Parameter | Values in the example | Affects |
|---|---|---|
| Doors and installation | 1 to 4 doors, internal pit or loadhouse | Building, view, section |
| Dock height | 900 to 1,500 mm above the apron | Height difference to the bed |
| Vehicle | Semi-trailer, rigid truck, van | Bed height range, width, rear opening, roof height |
| Bed height | Per vehicle, e.g. semi-trailer 950 to 1,350 mm | Gradient, working range |
| Leveller length and width | 2.0 to 4.0 m; 2.00 or 2.25 m | Gradient, working range, opening check |
| Lip | Hinged, or telescopic 500 / 1,000 mm | Overlap, reachable heights |
| Shelter | Curtain, inflatable, cushion | Seal against vehicle width and roof height |
All values are example values, not ratings [1].
How is the gradient calculated?
The leveller is hinged at the dock and lays its lip on the truck bed. Its gradient follows from the height difference it has to bridge over its length. Simplified: gradient ≈ height difference ÷ leveller length. The configurator calculates more precisely: it includes lip thickness and angle for a hinged lip and the extended length for a telescopic lip.
The example rates the result in three bands: up to 10 % green, above that amber (steep), above the example maximum of 12.5 % red [1]. The value shows live in the panel and in a readout over the 3D view; while the leveller moves, the figure follows it and returns to the planned value at the end.
A worked case with the demo's example values: a semi-trailer with a 1,350 mm bed at a 1,200 mm dock gives an amber gradient on a 2.0 m leveller. The configurator suggests 2.50 m, which gives 8.1 %, and one click on "Apply" turns the check green.
What is the working range?
A leveller can move its front edge only so far above and below dock level. In the example this working range grows with length: from 250 mm up and 200 mm down at 2.0 m to 450 and 400 mm at 4.0 m. If the bed lies outside it, the check is red however flat the gradient would be. In the model the leveller then stops at its limit and the lip does not reach the bed.
In the example this affects vans at a dock built for semi-trailers. In the example a van with a 650 mm bed at a 1,200 mm dock is outside the range of every leveller length. The suggestion is then a 4.00 m leveller with a 1,000 mm telescopic lip, giving −9.8 %.
In what order does the suggestion search?
If the gradient is amber or red, the example configurator searches in this order:
- a longer leveller with the same lip;
- a telescopic lip, at the same or a greater length;
- for a new building, a different dock height that suits the vehicle;
- if nothing fits: a message to settle dock height and vehicles with the maker.
This order is an example rule. In your configurator you decide what is suggested first, for example the solution your sales team offers most often.
How is the dock shelter checked?
The shelter should seal against the vehicle. In the example each shelter type has example sizes for the inner edge of the side seals, the lower edge of the top seal and the head height. The check asks whether the vehicle is wide enough for the sides to touch and tall enough for the top to touch; if the roof is too high for the head height, the check is red. With the example sizes, the semi-trailer seals with all three types; the rigid truck leaves a top gap with the cushion seal, and the van leaves gaps with all three. In the model, curtains lie against the vehicle, air bags fill and pads compress [1].
Which other checks are there?
- Lip overlap: in the example the lip must rest at least 100 mm on the bed; otherwise there is a warning.
- Opening: the leveller width must not exceed the vehicle's rear opening width.
- Inputs: out-of-range values are adjusted with a message, for example a bed height that is too high.
All checks use example values. Capacity, safety and standards of a real loading bay are the manufacturer's responsibility. A red check does not block the enquiry; the result appears in review and enquiry, so your sales team sees what needs discussing.
What comes out at the end
The review shows every input and check. The enquiry text has the same rows; the two-page PDF shows the docked outside view and a section through pit, leveller and lip with dimension lines [1]. In the demo, text and PDF are created in the browser; routing to a maker is not built in.
What data you supply
For your configurator we need: leveller lengths and widths with working ranges, lip types and lengths, your gradient limits, the vehicle types and height ranges you cover, your shelter dimensions, your accessories and your rules for loadhouses. If several vehicles load at one door, we can check the whole mix and report the least favourable gradient; that is not in the demo.
Try it
Example configurator · fictional product
Dock leveller & shelter configurator
Plan a loading bay at the warehouse: dock the vehicle and see at once at what gradient the dock leveller rests on the truck bed.
Test the calculation in the dock leveller and shelter configurator, an example configurator with a fictional product and example values. Who benefits is covered in dock leveller configurator for manufacturers; mobile ramps in yard ramp slope and bed height rules. The project is described on 3D configurator development.
Frequently asked questions
Is 12.5 % a limit value?
No. It is an example maximum in this demo. In your configurator your rules apply.
Does a red check block the enquiry?
No. The result is in the review and the enquiry, so your sales team sees what needs discussing.
Which units does it use?
Millimetres and metres, as in the demo. Other units can be added in a project.
Sources
- Modelwright library: dock leveller and shelter configurator, "Live in this demo" list, read 14 November 2026: modelwright.de/en/library/dock-leveller-configurator/


