Add a part to the parts library

Author The Listener Topic Bassilisk First published Last updated 3 min read

Suggest a correction

The parts library holds reusable parts for builds. Adding your part gives other builders a shared record with its identity, specifications and source links to find and reference after approval.

Before you start

  1. Search the parts library by manufacturer and model. Check the exact version before deciding it is missing.
  2. If the part exists but needs a correction, open its page and choose Suggest an update. Explain the correction and its source in What should change?, edit the fields, then choose Send suggestion. The live entry stays unchanged until a moderator applies your suggestion.
  3. If the part is missing, sign in and open Submit a part. The library is for reusable commercial products, standardized parts and documented open-source modules. One-off pieces belong in your build as custom parts.

Identity

  1. Enter the brand in Manufacturer. Select an existing manufacturer when the matching name appears.
  2. Enter the exact datasheet model code in Model. Keep suffixes such as -4 or -8 in the code. For example, keep SB17CAC35-4 intact.
  3. Check Listed as. The editor joins manufacturer, model and any variant with spaces. Without a variant or override, the example becomes SB Acoustics SB17CAC35-4.
  4. Inspect any matches under Already in the library?. Open a matching entry before continuing.

Variant, display name override and aliases

These fields are under Advanced identity. Use them when manufacturer and model alone are not enough.

  1. Use Variant when the exact same model is sold in versions that need separate catalog entries. Examples shown in the editor include 4 Ω, Mk II and Black. Each entry still describes one version. If the version has a different model code, add it under that exact code as a separate part. Do not move a model suffix into this field.
  2. Leave Display name override empty unless the generated name reads wrong. Override display name opens the field. An override replaces the listed name; it does not replace the identity fields.
  3. Put other names for the same part in Aliases, one per line. Use alternate spellings, common misspellings or a nickname that other builders might search for. A different part is not an alias.

Type, subtype and specifications

  1. Choose what the part primarily is in Part type. Then choose a matching Subtype, if one applies.
  2. Fill the relevant Specifications from the part's published data. The fields change with type and subtype. A driver can have impedance and power-handling fields; an amplifier has its own specification fields. Follow the displayed units.
  3. Complete Inputs, Outputs and Power when those sections appear. Record the part's connections and supply details. Installation wiring belongs in your build diagram. DSP amplifiers and DSP/audio processors need at least one audio output before submission.

Capabilities follow from type and subtype automatically. There is no separate capability picker in this editor.

  1. Upload a product image under Photo so other builders can recognize the part. Check the card preview. Use Horizontal, Vertical and Zoom to adjust its framing.
  2. Under Product information, use Description to explain what the part is. Keep it factual.
  3. Put the manufacturer's product page in Official URL and the datasheet link in Datasheet URL. Use complete HTTP or HTTPS links for external pages. Check that both describe your exact model and version.

Submit for review

  1. Check the identity, selected type, specifications and source links. Choose Submit for review. Correct any validation errors shown by the form.
  2. Check your submission in your parts dashboard. It starts pending review. You can use your own pending part in a build while it awaits approval.
  3. If the submission is returned, read the reason shown with it, when provided. It stays out of the public library. Any existing build references become custom parts, keeping their display identity.

Review covers identity, reusability and possible duplicates. The reviewer sees your submitted fields, photo and specifications. Approval makes the part publicly searchable and available for other builders to reference. A duplicate can be merged into an existing entry.

Common mistakes

  • Adding an existing part again instead of suggesting a correction.
  • Dropping a model suffix or mixing specifications from different versions.
  • Using an alias for a different part.
  • Putting one-off build details in the shared library record.

First published

Last updated

The author maintains this document. Contributors can suggest corrections.

Discussion

No linked discussion yet. Ask a question or add context from your own work.