Issue description
During xTool Apparel Printer operation, you may receive an error message stating "Film hole detection error." This message may appear as a pop-up window in xTool Creative Space (XCS) software or directly on xTool Apparel Printer's LCD panel.
- Please follow these steps to identify and resolve the issue.
Potential causes
- The PET film is not correctly aligned (specifically relative to the right white marking line).
- The PET film is bulging, buckled, or wrinkled in the sensor area.
- The Film Hole Detection Sensor is dirty.
- The Film Hole Detection Sensor is malfunctioning.
Troubleshooting
STEP1: Address jammed film / "Bump exceptions"
If the print head jams the film, you may also receive a "Bump exceptions" error message simultaneously.
Check for Print Head Jamming
- Examine the film and print head for signs of jam.
- Use scissors or another cutting tool to trim all wrinkled sections of the film.
- Ensure the remaining film is flat and free of any wrinkles or creases.
 |  |
Perform standard print head auto-cleaning
- On the printer's LCD panel, tap step by step to navigate to the cleaning function: Maintenance > Clean > Start
- Complete the print head cleaning process according to the on-screen instructions. Allow the cleaning cycle to finish completely.
- Learn how to perform standard print head auto-cleaning by following the video tutorial below.
After Cleaning
- Once cleaning is complete, or if there was no jammed film, proceed to Step 2.
STEP2: Properly adjust PET film alignment
- Apply Tension: Gently pull the film taut (tight) as you guide it. Ensure it is not loose or slack during alignment.
- Position on Guide Line: Align the film edge precisely with the white marking line.
- The film must not overlap the white marking line.
- The film edge must remain within ≤1 mm of the line (not shifting left or right).
Video Reference: For visual guidance on proper PET film adjustment, refer to the video tutorial: Replace the Brackets & Adjust the Ball Bearings on xTool Apparel Printer
- Specific section: 1:20-1:40 minutes
If the issue persists after film alignment, proceed to Step 3.
STEP3: Perform “Device self-check”
- Restart both devices:
- Power off the printer and oven; await 30 seconds before rebooting.
- Run “Device self-check”:
- On the control panel of the printer, tap Maintenance > Device self-check > Start and follow on-screen prompts.
- If the detection test fails:
- Refer to: Troubleshoot "Device Self-Check" Failure for xTool Apparel Printer & xTool OS1 for troubleshooting.
- If the error remains unresolved after following the previous steps, it might be necessary to replace one or more components. Proceed to the "Still experiencing issue" section to contact xTool Customer Service for further assistance.
Still experiencing issues?
Should the issue persist after completing the preceding steps, submit a ticket via the "Submit a Ticket" button in the "Help Ticket" section below. The standard response time for xTool Customer Service is one business day.
For a prompt resolution, please include the following details:
- Issue Description: A detailed explanation of the observed problem.
- Video Evidence: Attach a video demonstrating the issue, where applicable.
- Troubleshooting Performed: Any troubleshooting steps you have already attempted, along with their results.
This information is crucial for xTool technical support engineers to provide timely assistance.
Documentation feedback
Help improve this content by providing feedback. If this content did not meet your requirements, select "No" in the "Was this page helpful?" section below. Include specific details about what was unclear or missing in the pop-up suggestion box. Feedback submissions are reviewed by xTool technical writers to enhance future documentation.
Services & Help
Learn & Community
Contact Us
Copyright © 2025 xTool All Rights Reserved.