Troubleshoot "The Welding Gun Is not Connected" for xTool MetalFab CNC Cutter
Updated Sep 29,2025
Updated Sep 29,2025

Issue description

If you encounter a pop-up error message titled "The welding gun is not connected." in xTool software, please follow this troubleshooting guide to resolve this issue.

Possible causes

  • Detection board malfunction: The detection board for the welding head (welding gun) on the carriage malfunctions.
  • Welding head installation failure: The welding head is not secured by the toggle latch on the carriage.

Detailed procedure

Step 1: Check the detection board

  1. Take off the welding head from the carriage and close the pop-up message in xTool software.
  2. Press the black button on the carriage and check if the button can rebound and if the error message pops up again.

    Under normal situation,
    1. When the button is pressed down, xTool MetalFab CNC Cutter buzzes;
    2. When the button is released, it will rebound automatically and xTool software will pop an error message to inform you of the welding head unconnection issue.

Button status

Buzzing

Button

Error message

Pressed down



Released


Rebounding

For more details, see this video.

  1. If the detection board works properly, yet the error message keeps popping up, please proceed to the next step.

Step 2: Check the welding head installation

  1. Ensure that the welding head is firmly secured on the carriage.

  1. Shake the welding head to check if there is any noticeable looseness or detachment.
  2. If the welding head is not well secured, follow Quick Start Guide of xTool MetalFab CNC Cutter to install it again.
  3. If the welding head is secured yet the issue persists, please prepare the following materials and send them to xTool Customer Service for further assistance:
    1. A video recording your troubleshooting process and results
    2. Work log of xTool MetalFab CNC Cutter

Help us improve

If this article or video doesn't effectively assist you in resolving the issue, please let us know by clicking the “No” button in the “Was this page helpful?” section below, and leave your feedback in the pop-up suggestion box. Our knowledge base team will review it and consider it for future updates.

Still need help?

If you need any human assistance, please create a ticket by clicking the “Submit a Ticket” button in the “Help Ticket” section below. Our service team will get back to you in 1 business day via E-mail.

Preview
Was this page helpful?
0 out of 0 found this helpful
Help Ticket
Use this help ticket to submit your issue. We will respond within 1 business day
Submit a Ticket
Help Ticket
Use this help ticket to submit your issue. We will respond within 1 business day
Submit a Ticket
xTool Logo

Contact Us

🇺🇸+1 (833) 588-4887
Service Live Chat

Copyright © 2025 xTool All Rights Reserved.