The short answer
An **internal keyway** in a CNC bore is not an [external shaft keyway](https://3dwk.com/resources/keyway-callouts-on-cnc-turned-shafts), not a [Woodruff seat](https://3dwk.com/resources/woodruff-key-seat-notes-cnc-shafts), and not an [involute spline](https://3dwk.com/resources/involute-spline-notes-cnc-shafts). A usable callout says **which bore**, the **axial location and length**, the **width and depth the drawing actually controls**, any **clocking** to a datum or mating shaft key, and **keep-outs** from shoulders, ring grooves, and threads. Silence, or a note that only says “add a keyway in the bore,” is what widens many [quote-new.php](https://3dwk.com/quote-new.php) **rates.v1.1** estimate bands—not the broach or mill minutes alone.
This guide is for buyers packaging housings, hubs, or pulleys that take a shaft key in an internal bore. Illustrations use an **Example part** only—not a customer hub, and not a fabricated assembly photo. Sibling notes cover external shaft keyways, Woodruff seats, and splines; here we focus on **packaging an internal keyway in the bore**.
What internal keyways mean for quoting
An **internal-keyway pack** names the bore, the axial station and length, the width and depth (or remaining wall) that must be inspected, clocking if required, and the standard or size the buyer actually uses. Writing “keyway in bore” or “standard keyway” is not enough. Process pages for common aluminum housings ([CNC 3-axis Al 6061 automation](https://3dwk.com/en/cnc-3axis/al-6061/automation.html), [CNC 3-axis Al 6061 robotics](https://3dwk.com/en/cnc-3axis/al-6061/robotics.html), [CNC 3-axis Al 6061](https://3dwk.com/en/cnc-3axis/al-6061.html)) assume that pack is visible when lots mix plain bores, [press-fit or slip-fit bores](https://3dwk.com/resources/press-fit-vs-slip-fit-cnc-bores), and keyed hubs.
Do not bury “internal keyway as needed” inside a notes cloud. Put **INTERNAL KEYWAY IN BORE B, AXIAL STATION AND LENGTH CITED, WIDTH AND DEPTH CITED, STANDARD OR SIZE CITED, CLOCK TO DATUM IF REQUIRED, KEEP CLEAR OF THE SHOULDER AND ANY RING GROOVE** on the PDF and mirror it in RFQ text. If the bore must stay a plain cylinder—no keyway—say **NO INTERNAL KEYWAY** so the shop does not invent a slot. Background: [what files to send for a CNC quote](https://3dwk.com/resources/what-files-to-send-for-cnc-quote), [internal retaining-ring groove notes](https://3dwk.com/resources/internal-retaining-ring-groove-notes-cnc-bores).
Location, form, and size
Name the bore the key will sit in, the distance from a datum or shoulder, and whether the keyway is through, blind, or stopped at a cited length. Width and depth (from the bore diameter, or as remaining wall) must be on the PDF. If you use a published key-and-keyway standard, **write the document and size designation you actually use**. This guide does not invent a default key width, a depth, a fillet at the slot root, or a 3DWK-standard internal keyway. A Woodruff seat or a spline is a different feature; do not let an internal-keyway note replace them.
Clock the slot to a mating shaft key, a dowel, or a housing datum if the assembly requires it. An un-clocked “keyway somewhere in the bore” leaves both the tool path and the inspection method open.
Keep-outs and process notes
Give a minimum land to adjacent [internal retaining-ring grooves](https://3dwk.com/resources/internal-retaining-ring-groove-notes-cnc-bores), threads, and shoulders so a broach, slotting cutter, or mill does not break a face or nick a seal diameter. If the mating shaft already exists, still put the bore keyway dimensions on the housing PDF rather than “match the shaft.” A through keyway that exits a thin wall or a face is a different RFQ from a stopped slot that stays inside the bore.
How the slot is produced (broach, slot, wire EDM, or mill) is a process choice the shop may propose; the RFQ still has to carry the inspected size, length, and clocking. Do not write “broach as needed” as a substitute for those values.
Tolerance and inspection traps
Calling “internal keyway as needed,” asking for a “standard keyway” with no document or size, or leaving clocking silent when the shaft is already keyed, all force **needs_manual**. Default a housing that only needs a plain or press-fit bore to an explicit no-keyway note; do not let a generic “for key” appear as an implied slot. Related: [what needs_manual means](https://3dwk.com/resources/what-needs-manual-means-preliminary-quote).
Illustration 1 shows an **Example part** Al 6061 hub with a labeled internal keyway in bore B, axial station and length cited, width and depth cited, standard or size cited by the buyer, and keep-outs from a shoulder and a ring groove.
Example part walkthrough
**Example part:** Al 6061 hub, internal keyway required in bore B at a cited station and length, width and depth on the PDF, buyer key standard or size cited, clock to a datum if required, keep clear of the shoulder and any ring groove, no invented default key size or 3DWK slot recipe. With STEP + **INTERNAL KEYWAY IN BORE B, STATION / LENGTH / WIDTH / DEPTH CITED; STANDARD CITED; KEEP CLEAR OF THE SHOULDER AND GROOVE**, expect a usable automatic planning band on [quote-new.php](https://3dwk.com/quote-new.php). Same geometry with silent “add a keyway in the bore as needed” often lands DFM notes or **needs_manual**—without inventing any customer hub, key lot, or a 3DWK-guaranteed fit class.
Illustration 2 contrasts a vague RFQ (“keyway in bore”) versus a labeled location-form-size pack and the clearer estimate path.
What widens bands fastest
Unlabeled “as needed” internal keyways, a “standard keyway” note with no document or size, clocking left silent against a keyed shaft, and keep-outs omitted next to ring grooves or threads. Quantity breaks do not erase feature-pack ambiguity—see [how quantity breaks change CNC unit cost](https://3dwk.com/resources/how-quantity-breaks-change-cnc-unit-cost).
What to do next
Mark each internal slot with **bore, location and length, width and depth, the standard or size you use, clocking if required, and keep-outs**, then upload the CAD on [quote-new.php](https://3dwk.com/quote-new.php). Packaging checklist: this is not an external shaft keyway, not a Woodruff seat, and not a spline. Service pages: [CNC machining](https://3dwk.com/cnc-machining-service.php), [materials](https://3dwk.com/materials.php). Treat **rates.v1.1** min/mid/max as estimates, not invoices. If the UI shows **needs_manual**, answer the internal-keyway questions rather than forcing a fake price.
Common questions
Is an internal keyway the same as a shaft keyway or a Woodruff seat?
No. A shaft keyway is cut on the outside of a journal; a Woodruff seat is a partial-circle seat on a shaft; an involute spline is a different drive geometry. An internal keyway lives in the bore of a hub or housing. Package each feature on its own line.
Can 3DWK just use a standard key size?
Cite the standard and size designation you need on the PDF. This guide does not invent a default width, depth, or fillet as a 3DWK guarantee.
Can the keyway break into a ring groove or a thread?
Only if you say so. A default keep-out is safer: give a minimum land to the groove, the thread, and any shoulder. If a short hub has no room, write the allowed exception on the PDF.
How should I inspect the slot?
Call out the controlled width and depth, the axial station and length, and any angular location. Do not leave “for key” as the only acceptance note.
