Need Help Uploading Document Pairs to Azure AI Translator – Error: "Document may be corrupt or have an invalid extension"

Question

Need Help Uploading Document Pairs to Azure AI Translator – Error: "Document may be corrupt or have an invalid extension"

jlp 0

Hi everyone,

I'm encountering an issue while uploading document pairs to Azure AI Translator services. Here's the situation:

I have around 50 DOCX file pairs that I've placed in a ZIP file for uploading; I've successfully done the same process with similar documents.
The files are properly named (e.g., example_en.docx and example_fr-CA.docx) and are between 29–880 KB in size.
The documents open correctly on my computer, so they don't appear to be corrupt.
I ensured there is no password protection on the files.
I've tried to convert a single pair from UTF-16 LE to UTF-8 with this tool but the documents still wont upload.

Despite all this, I'm receiving the following error: "The document has an unsupported extension. Please upload a document with a supported file extension."

I get a similar error when uploading a pair at a time: **"**The document may be corrupt or have an invalid extension."

I would greatly appreciate any insights, suggestions, or troubleshooting tips to resolve this issue. Are there specific requirements for ZIP files or DOCX encoding that I might be missing?

Thanks in advance for your help!

kothapally Snigdha 3,020 Reputation points Microsoft External Staff Moderator

2025-04-04T11:07:05.01+00:00
Hi jlp

I understand that you are experiencing issues with uploading your DOCX files to Azure AI Translator. Here are some steps to follow.

Ensure that your file names strictly follow the naming convention required by Azure AI Translator. For example, the naming should be in the format {document name}_{language code}. Your files should be named something like example_en.docx and example_fr-CA.docx, which seems correct.

Make sure that your ZIP file is properly formatted. Azure supports ZIP files but ensure that the files inside the ZIP are not nested in additional folders. The files should be directly within the ZIP file.

Confirm that the DOCX files are indeed supported. According to the context, DOCX files are supported, but ensure that there are no issues with the specific documents you are trying to upload.

The size of your files seems to be within the acceptable range. However, ensure that the encoding is correct. The context mentions that text files should be in UTF-16 or UTF-8. If you are converting the files, ensure that the conversion is successful and that the files are saved in the correct format.

Even though the documents open correctly on your computer, there may still be issues with how they are structured internally. Consider recreating the documents or saving them in a different way to ensure they are not corrupt.

Kindly refer the document Azure AI Custom Translator formats and naming convention guidance

I hope these helps you. Thank you!
jlp 0 Reputation points

2025-04-04T18:29:52.94+00:00

Thank you for your suggestions. However, as I mentioned in my message, I have already tried all of these steps without success. Let me know if you have any other recommendations.

kothapally Snigdha 3,020 Microsoft External Staff Moderator

Hi jlp

Please use the format example_1_fr.docx or example_2_fr.docx for your file naming. If you suspect any issues with the .docx files, you can convert them to PDF files using the Python script provided below. This will help ensure that your files are in a consistent and compatible format for further processing or review.

import os
from docx import Document
import fitz  # PyMuPDF
 
def convert_docx_to_pdf(docx_path, pdf_path):
    # Load the .docx file
    doc = Document(docx_path)
    
    # Create a PDF file
    pdf = fitz.open()
    
    # Create a blank page
    page = pdf.new_page()
    
    # Initialize cursor position
    cursor_y = 50
    cursor_x = 50
    
    # Iterate through paragraphs in the .docx file
    for para in doc.paragraphs:
        text = para.text
        page.insert_text((cursor_x, cursor_y), text)
        cursor_y += 20
        
        # Add a new page if the cursor reaches the bottom of the page
        if cursor_y > page.rect.height - 50:
            page = pdf.new_page()
            cursor_y = 50
    
    # Save the PDF file
    pdf.save(pdf_path)
 
# Directory containing .docx files
directory = "path/to/your/docx/files"
 
# Convert each .docx file in the directory to .pdf
for filename in os.listdir(directory):
    if filename.endswith(".docx"):
        docx_path = os.path.join(directory, filename)
        pdf_path = os.path.join(directory, filename.replace(".docx", ".pdf"))
        convert_docx_to_pdf(docx_path, pdf_path)
 
print ("Conversion completed.")

I hope this helps. Do let me know if you have further queries.

Thank you!

kothapally Snigdha 3,020 Reputation points Microsoft External Staff Moderator

2025-04-10T06:12:50.5433333+00:00

Hi jlp

We haven’t heard from you on the last response and was just checking back to see if you have a resolution yet. In case if you have any resolution, please do share that same with the community as it can be helpful to others. Otherwise, will respond with more details and we will try to help.

Your answer

kothapally Snigdha 3,020 Reputation points Microsoft External Staff Moderator

2025-04-04T11:07:05.01+00:00

Hi jlp

I understand that you are experiencing issues with uploading your DOCX files to Azure AI Translator. Here are some steps to follow.

Ensure that your file names strictly follow the naming convention required by Azure AI Translator. For example, the naming should be in the format {document name}_{language code}. Your files should be named something like example_en.docx and example_fr-CA.docx, which seems correct.

Make sure that your ZIP file is properly formatted. Azure supports ZIP files but ensure that the files inside the ZIP are not nested in additional folders. The files should be directly within the ZIP file.

Confirm that the DOCX files are indeed supported. According to the context, DOCX files are supported, but ensure that there are no issues with the specific documents you are trying to upload.

The size of your files seems to be within the acceptable range. However, ensure that the encoding is correct. The context mentions that text files should be in UTF-16 or UTF-8. If you are converting the files, ensure that the conversion is successful and that the files are saved in the correct format.

Even though the documents open correctly on your computer, there may still be issues with how they are structured internally. Consider recreating the documents or saving them in a different way to ensure they are not corrupt.

Kindly refer the document Azure AI Custom Translator formats and naming convention guidance

I hope these helps you. Thank you!
jlp 0 Reputation points

2025-04-04T18:29:52.94+00:00

Thank you for your suggestions. However, as I mentioned in my message, I have already tried all of these steps without success. Let me know if you have any other recommendations.
kothapally Snigdha 3,020 Reputation points Microsoft External Staff Moderator

2025-04-09T10:23:32.8766667+00:00

Hi jlp

Please use the format example_1_fr.docx or example_2_fr.docx for your file naming. If you suspect any issues with the .docx files, you can convert them to PDF files using the Python script provided below. This will help ensure that your files are in a consistent and compatible format for further processing or review.

import os from docx import Document import fitz # PyMuPDF def convert_docx_to_pdf(docx_path, pdf_path): # Load the .docx file doc = Document(docx_path) # Create a PDF file pdf = fitz.open() # Create a blank page page = pdf.new_page() # Initialize cursor position cursor_y = 50 cursor_x = 50 # Iterate through paragraphs in the .docx file for para in doc.paragraphs: text = para.text page.insert_text((cursor_x, cursor_y), text) cursor_y += 20 # Add a new page if the cursor reaches the bottom of the page if cursor_y > page.rect.height - 50: page = pdf.new_page() cursor_y = 50 # Save the PDF file pdf.save(pdf_path) # Directory containing .docx files directory = "path/to/your/docx/files" # Convert each .docx file in the directory to .pdf for filename in os.listdir(directory): if filename.endswith(".docx"): docx_path = os.path.join(directory, filename) pdf_path = os.path.join(directory, filename.replace(".docx", ".pdf")) convert_docx_to_pdf(docx_path, pdf_path) print ("Conversion completed.")

I hope this helps. Do let me know if you have further queries.

Thank you!
kothapally Snigdha 3,020 Reputation points Microsoft External Staff Moderator

2025-04-10T06:12:50.5433333+00:00

Hi jlp

We haven’t heard from you on the last response and was just checking back to see if you have a resolution yet. In case if you have any resolution, please do share that same with the community as it can be helpful to others. Otherwise, will respond with more details and we will try to help.

Share via

Need Help Uploading Document Pairs to Azure AI Translator – Error: "Document may be corrupt or have an invalid extension"

Your answer