Skip to main content

Creating and Configuring Custom Connectors

This guide explains how to build, pin out, calibrate, and configure connectors in Wiringly. Connectors can be mounted to control units (such as engine ECUs, PDMs, and telemetry loggers) or used as standalone components (bulkhead disconnects, sensor pigtails, inline junctions, splices, and ring terminals).

Watch our video tutorial below for an overview of connector workflows:


Two Ways to Add Connectors​

Wiringly offers two pathways to add connectors to your project library:

flowchart TD
Start["Add Connector"] --> Choice{"Catalog or Custom?"}
Choice -->|"TE Connectivity Catalog"| TE["1-Click TE Import<br/>(Auto-fills 3D dimensions, wedgelocks, terminals & seals)"]
Choice -->|"Custom Connector"| Wizard["6-Step Connector Wizard<br/>(Full manual engineering control)"]
TE --> Calib["Calibrate Crop & Wire Exit Line"]
Wizard --> Step1["Step 1: Basic Info & 3D Dimensions"]
Step1 --> Step2["Step 2: Picture & Scale Calibration"]
Step2 --> Step3["Step 3: Pin Info & Pattern Ordering"]
Step3 --> Step4["Step 4: Contact Families & Terminals"]
Step4 --> Step5["Step 5: Wire Cavity Seals"]
Step5 --> Step6["Step 6: Cavity Sealing Plugs"]
Calib --> Save["Save to Library & Place on Canvas"]
Step6 --> Save
  1. Method 1: Instant Import from TE Connectivity Catalog (Fastest): Search by part number (e.g., DT06-2S, 284703-1) to instantly pre-fill all 3D dimensions, high-resolution photography, mating wedgelocks, contact families, wire seals, and cavity plugs. For complete instructions, see our TE Connectivity Import Guide.
  2. Method 2: The 6-Step Connector Wizard: Build and customize any connector, splice, or terminal from scratch using our modern tabbed editor.

The 6-Step Connector Wizard​

To start the wizard:

  1. Navigate to the Component Library from the main navigation sidebar.
  2. Click + New Component and choose Connector (or click Add New Connector).
  3. The 6-step tabbed editor opens:
TabStep NamePrimary Function
1Basic InfoPart numbers, mating MPN, wedgelock (TPA), gender, pin count, and 3D dimensions
2PictureImage upload, drag-and-drop, clipboard paste, scale calibration & wire exit line
3Pin InfoSmart pattern generator, character exclusions (I, O), and individual cavity names
4TerminalsContact families, plating (Au, Ni, Sn), solid vs S&F, wire gauge matching
5SealsWire cavity seals with insulation outer diameter ranges (OD mm)
6Cavity PlugsBlind plugs for sealing unused positions to maintain IP67/IP68 ratings

Step 1: Basic Info & 3D Dimensions​

Enter the primary identification details and mechanical dimensions:

  • Name: A descriptive title for your component (e.g., Deutsch DT 6-Pin Plug Key A).
  • Manufacturer / Brand: Brand name (e.g., TE Connectivity, Amphenol, Molex, Aptiv / Delphi).
  • Manufacturer Part Number (MPN): The exact orderable housing part number (e.g., DT06-6S). This flows directly into your project's Bill of Materials (BOM) and purchasing requisition sheets.
  • Mating Connector MPN: (Optional) The complementary mating part number (e.g., DT04-6P) so that plug/receptacle pairs are linked on harness schematics.
  • Secondary Lock / Wedgelock MPN: Part number for the wedgelock or Terminal Position Assurance (TPA) lock (e.g., W6S).
  • Connector Kind:
    • Connector: Multi-pin automotive/motorsport housing.
    • Splice: Ultrasonic or crimp splice node.
    • Ring Terminal: Ground eyelet or battery stud terminal.
  • Gender:
    • Female (Receptacle / Sockets): Receives female contact sockets.
    • Male (Plug / Pins): Houses male contact pins.
  • Pin Count: Total number of wire cavities (e.g., 2, 6, 12, 34).
  • Default Max Current (A): Nominal continuous rating per contact in Amperes (default: 13A for standard automotive contacts).
Mandatory 3D Physical Dimensions

You must enter the Width (mm), Length (mm), and Height (mm) of the connector. Wiringly's canvas operates at a strict 1:1 scale, meaning these dimensions ensure the component footprint on your printable formboard assembly drawing matches the real-world connector on your workbench.

  • Generate Docusaurus SEO Page (Admin only): When enabled, this connector is exported by the automated documentation generator to publish public pinout specifications in the Connector Directory.

Step 2: Picture, Calibration & Wire Exit Direction​

The Picture tab defines the visual representation of your connector on both schematic diagrams and 1:1 formboard layouts.

Adding Connector Images​

  • Upload Image: Select any PNG, JPG, SVG, or WEBP file from your computer.
  • Drag and Drop: Simply drag an image file from your desktop directly into the drop zone.
  • Clipboard Paste (Ctrl + V): Copy any screenshot or datasheet diagram to your clipboard and press Ctrl + V anywhere inside the dialog to paste it instantly.
  • Remove White Background: Automatically trims solid white backgrounds and creates transparency for clean rendering over harness bundles.
  • Multi-Angle Selector: When importing parts with multiple manufacturer photos, click any thumbnail angle to switch between front face, isometric, and top views.

Calibrating Scale (ImageCropper)​

Click Edit Crop to launch the calibration tool:

  1. Polygon Tracing: Click around the connector perimeter to establish crop boundaries. Points automatically snap to high-contrast edges and image boundaries.
  2. Auto Edge Detection: The built-in contour detector simplifies contours using the Ramer-Douglas-Peucker algorithm to snap directly to the connector body.
  3. Physical Scale Calibration: Real-world millimeter dimension lines display across the cropped region, matching your Width, Length, and Height from Step 1.

Setting Wire Exit & Bundle Vector (ConnectionSurfaceEditor)​

Once cropping is confirmed, the surface editor configures how wires connect to the housing:

  1. Connection Line: Draw the contact boundary line across the rear face of the connector where wire leads physically enter the cavities.
  2. Bundle Vector: Set the exit directional arrow:
    • Straight back: Normal inline wire takeoff (0°).
    • 90° Elbow: Right-angle takeoff for tight engine bay packaging.

Step 3: Pin Info & Pattern Ordering​

Step 3 configures pin designations and cavity identification rules:

  • Automated Pattern Generator: Generates pin names in bulk to eliminate tedious typing on high-density connectors:
    • Numeric (Default): Generates numbers 1, 2, 3, 4, ... up to the pin count.
    • Alphabetical: Enter A-H to generate sequential letters A, B, C, D, E, F, G, H.
    • Matrix / Grid: Enter A1-B3 to generate multi-row headers: A1, A2, A3, B1, B2, B3.
    • Explicit Lists: Enter comma-separated lists (e.g., SIG, GND, +5V, SHIELD).
  • Character Exclusions: Excludes ambiguous characters to prevent misreading during harness manufacture.
    Motorsport Standard Exclusions

    Excluding I, O is standard in professional motorsport wiring to prevent operators from confusing letter I with number 1 or letter O with number 0 on physical heat-shrink wire print labels.

  • Pin Customization: You can override any individual pin designation, description, or maximum current rating directly in the interactive pin table.

Step 4: Terminals & Contact Families​

Wiringly links wire gauges directly to terminal part numbers so that your Bill of Materials (BOM) is automatically compiled as you draw wires on the canvas.

Understanding Contact Families​

Many automotive connectors use standardized contact systems (e.g. DEUTSCH Size 16, AMP MCP 2.8, TE MQS, Bosch BDK). In Step 4, terminals are organized into Contact Families:

  • Pin Mapping: Assign the contact family to all pins or specific pin ranges (e.g. pins 1-2 for large AMP MCP 4.8K power terminals, and pins 3-12 for AMP MCP 1.5K sensor terminals).
  • Terminal Specifications Table:
    • Contact Part Number: The exact orderable terminal part number (e.g. 1062-16-0122 or 0462-201-16141).
    • Plating / Metallurgy: Select Gold (Au), Nickel (Ni), Tin (Sn), or Silver (Ag).
    • Construction Style:
      • Solid Machined: High-reliability, 4-indent / 8-indent crimp terminals for severe vibration and motorsport applications.
      • Stamped & Formed (S&F): B-crimp terminals designed for high-speed reel production and standard automotive assembly.
    • Wire Size Range (mm²): Define the minimum and maximum cross-sectional wire area (e.g. 0.5 mm² - 1.5 mm²).
    • Cavity Seal Indicator (💧 Sealed vs No Seal): Dedicated column indicating whether the terminal is designed for Single Wire Seals (SWS) or unsealed clean body housings. Clicking the badge toggles the sealing mode.
    • Preferred Contact (⭐): Mark your preferred terminal for each wire gauge range. When you draw a 0.75 mm² wire to this connector on the canvas, Wiringly automatically selects this preferred terminal in the project BOM.

Step 5: Wire Cavity Seals​

Waterproofing in harsh environments requires matching the wire's outside insulation diameter to the correct silicone cavity seal:

  • Automatic Pin Cascading: Pin assignments automatically cascade from your terminal groups in Step 4.
  • Seal Part Number: Enter the Single Wire Seal (SWS) part number (e.g. 828904-1).
  • Wire Insulation Diameter Range (OD): Enter the minimum and maximum allowable outer insulation diameter (e.g. 1.4 mm - 2.1 mm).
  • Engineering Guidance: When using thin-wall motorsport wire such as Raychem Spec 55 (MIL-W-22759/32) or TXL, ensure the wire OD meets the seal's minimum threshold to prevent moisture ingress.

Step 6: Cavity Sealing Plugs (Blind Plugs)​

Any cavity that remains unpopulated in a sealed connector must be plugged to maintain the IP67, IP68, or IP69K environmental rating:

  • Cavity Plug Part Number: Enter the blind plug part number (e.g., 0413-204-2005 for DEUTSCH Size 16 or 963531-1 for Superseal 1.5).
  • BOM Output: When a connector on your canvas has unpopulated cavities, Wiringly automatically calculates the exact quantity of cavity plugs needed in your procurement BOM.

Saving & Placing on the Canvas​

  1. Click Create Connector (or Update) in the bottom-right corner.
  2. The connector is validated:
    • Verification that Name, Width, Length, and Height are present.
    • If imported from TE, verification that image crop calibration has been completed.
  3. The component is saved to your personal library and synced to cloud storage.
  4. Open any project canvas, drag the connector from the Library Panel, and place it directly into your schematic or formboard drawing.