Cantilever Retaining Wall (IBC 2024)
Run the calcWorked example
Symbols
The worked example uses these symbols.Example 1: a 10 ft wall with a 12 in shear key
A 10 ft retaining wall on a 12 in thick footing is checked for sliding three ways: with no shear key, with a 12 in key, and with the key’s active pressure left out. The run starts from the Fully-Drained Retaining Wall preset of Cantilever Retaining Wall (IBC 2024), version 1, in a US customary project. The soil pressures are entered as equivalent fluid pressures, 40 psf/ft active and 150 psf/ft passive, as shown in the diagram.
- Wall Height and Height of Backfill: 10 ft, from 8 ft
- Lateral Pressure Method: Equivalent Fluid Pressure - Custom Values, from Equivalent Fluid Pressure - IBC 2024 Values
- Active Soil Pressure: 40 psf/ft, and Allowable Passive / Lateral Bearing Pressure: 150 psf/ft
- Live Load Surcharge: 0 psf, from 100 psf
- Shear Key Depth: 0 in for the first check, then 12 in
Set the wall height

Set the soil pressures


Remove the live load surcharge

Read the results with no key


Add the shear key


Read the results with the key


Leave out the active pressure on the key


Inputs
Calcs.com output
Hand check
The loads, resistance and factors of safety match the closed-form solution, using the sheet’s vertical loads and friction coefficient. This is a sanity check only. Cantilever Retaining Wall (IBC 2024) version 1.
Overview
In some cases, adding a shear key to a retaining wall design can unexpectedly reduce the sliding factor of safety (FoS) instead of improving it, or leave it almost unchanged. This behavior is not a bug in the Retaining Wall module. It reflects how soil pressures are calculated on both sides of the key.How the Shear Key Affects Sliding Forces
When a shear key is added:- Active Pressure Increases
The soil on the backfill side exerts active pressure on the key.
This pressure is calculated based on the total height from the backfill surface to the bottom of the key.
Example: If you have 7 ft of backfill plus a 2 ft deep key, the active pressure is calculated over a total height of 9 ft. - Passive Pressure Increases
On the opposite side, soil provides passive resistance to sliding.
This is typically calculated from the soil in front of the footing.
Note: By default, we ignore cover soil above the footing because it can be disturbed during construction, which further reduces the countering effect of passive pressure. This can be overridden with the “Consider Soil Above Toe for Stability Checks?” option in the calculator.
Why Shallow Keys Can Reduce FoS
When the key depth is small:- Active pressure grows quickly because it is based on a taller soil column behind the wall (backfill + key depth).
- Passive resistance grows more slowly because it is based only on the depth of undisturbed soil in front of the footing.
- As a result, the increase in sliding force from active pressure can outpace the gain in resistance from passive pressure.
A key lowers the sliding FoS when the resistance it adds, divided by the driving force it adds, is less than the FoS without the key. In the worked example that ratio is 0.81 against an FoS of 0.776, so the key barely helps.
How to use it
These steps cover the Cantilever Retaining Wall (IBC 2024) inputs that affect a sliding check with a shear key. The values shown are the Fully-Drained Retaining Wall preset as it opens.Open the calculator and pick a preset

Read the assumptions

Set the key dimensions


Set the soil


Set the surcharge and seismic load


Set the water table

Review the design criteria

Check the reinforcement



Read the results


Calcs.com Workaround: Ignore active pressure on shear key
By default, we take the conservative approach of including active soil pressure against the shear key. If you do not want this in your calculations, you can:- Go to Tabulated Soil Loads and find the Lateral Loads on Shear Key table. It appears once the Shear Key Depth is above 0.
- Set the Load Factor of the rows to 0.

Building Code Considerations
Some building codes explicitly require considering the active pressure acting on the key. In general, building codes based on the 2015 edition of the IBC and earlier contain the following phrase (see in 2015 IBC):Where a keyway is extended below the wall base with the intent to engage passive pressure and enhance sliding stability, lateral soil pressures on both sides of the keyway shall be considered in the sliding analysis.Starting in 2018, the IBC no longer includes that clause, but a few jurisdictions retain it in their local codes. In the IBC 2018 change notes, the following explanation is given:
The application of soil pressure on both sides of a keyway is a recent addition to the model codes, and has caused concern and opposition from the geotechnical engineering community. The keyway concept is in conflict with accepted engineering practice and the principles of soil mechanics. 2015 IBC language was vague and ambiguous with respect to lateral soil pressures on the keyway. The application of “lateral earth pressures on both sides of the keyway” is commonly interpreted to require a deepening of the active soil pressure to the bottom of the keyway. Active soil pressure requires movement of the key, which is contrary to the intent of the provision. As there has been ongoing confusion over the intent of consideration of lateral earth pressure on both sides of the keyway and confusion about the purpose of the keyway, in the 2018 IBC the requirement for a keyway is deleted. A keyway may still be used when designed using the principles of soil mechanics and accepted engineering practice.We’ve put together a non-exhaustive list of building codes requiring active pressure on shear key below:
Common questions
Why did adding a shear key lower my sliding factor of safety, or barely change it?
Why did adding a shear key lower my sliding factor of safety, or barely change it?
How do I leave the active pressure on the key out of the calculation?
How do I leave the active pressure on the key out of the calculation?
Does the calculator count passive soil pressure when there is no shear key?
Does the calculator count passive soil pressure when there is no shear key?
Does the calculator include soil above the toe in the passive resistance?
Does the calculator include soil above the toe in the passive resistance?