Frequently Asked Questions
General Questions
What is the Text Diff tool?
The Text Diff tool is an online utility that compares two text files or text content and highlights the differences between them. It's designed for developers, writers, and anyone who needs to track changes in text documents.
Is the Text Diff tool free to use?
Yes, the Text Diff tool is completely free to use. There are no registration requirements or usage limits.
Do I need to install anything?
No installation is required. The tool runs entirely in your web browser and doesn't require any software installation.
Is my data secure?
Yes, your data is completely secure. All processing is done locally in your browser, and no text content is sent to external servers. Your data remains private and secure.
File Upload Questions
What file formats are supported?
The tool supports various text-based file formats including:
- Text files (.txt)
- Markdown files (.md)
- JavaScript files (.js, .ts)
- Vue components (.vue)
- Web files (.html, .css)
- Data formats (.json, .xml, .yaml, .yml)
What's the maximum file size?
The tool works best with files under 10,000 lines. For very large files, consider splitting them into smaller sections for better performance.
Can I upload binary files?
No, the tool only supports text-based files. Binary files like images, videos, or executables cannot be processed.
What happens if I upload an unsupported file?
The tool will display an error message and ask you to select a supported text file format.
Comparison Options
What does "Ignore Whitespace" do?
When enabled, this option treats lines as identical if they differ only in whitespace characters (spaces, tabs, line endings). This is useful for comparing code files with different formatting styles.
What does "Ignore Case" do?
This option performs case-insensitive comparison, treating uppercase and lowercase letters as equivalent. This is useful for comparing configuration files or content where case doesn't matter.
Can I use both options together?
Yes, you can enable both "Ignore Whitespace" and "Ignore Case" options simultaneously for maximum flexibility in your comparisons.
Do the options affect the statistics?
Yes, the statistics are calculated based on the processed content after applying the selected options. This gives you accurate counts of actual differences.
Results and Output
How do I read the diff output?
The diff output uses a standard format:
+
indicates added lines-
indicates removed lines- Numbers show line numbers in each file
Can I copy the results?
Yes, click the "Copy" button to copy the diff results to your clipboard. The results maintain their formatting when pasted into other applications.
What do the statistics mean?
The statistics show:
- Added: Number of new lines in File B
- Removed: Number of lines deleted from File A
- Modified: Number of lines that were changed
- Unchanged: Number of lines that remained the same
Why don't I see any differences?
This could happen if:
- Both files are identical
- The selected options are hiding differences (e.g., ignore whitespace)
- One or both files are empty
- The content is actually the same
History Management
How does the history feature work?
Every comparison is automatically saved to your history, including file names, timestamp, and diff options used. You can access previous comparisons and reload them quickly.
Where is the history stored?
History is stored locally in your browser's storage. It's not sent to any external servers and remains private to you.
How long is history kept?
History is kept until you manually clear it or clear your browser's local storage. There's no automatic expiration.
Can I delete individual history items?
Yes, you can delete individual history items by clicking the X button next to each item, or clear all history at once.
Performance and Browser Issues
Why is the tool slow with large files?
Large files require more processing time. For files over 10,000 lines, consider splitting them into smaller sections for better performance.
Which browsers are supported?
The tool works in all modern browsers including:
- Chrome 80+
- Firefox 75+
- Safari 13+
- Edge 80+
What if the tool doesn't work in my browser?
Try these troubleshooting steps:
- Clear your browser cache
- Update your browser to the latest version
- Disable browser extensions temporarily
- Try a different browser
Can I use the tool offline?
Yes, once the page is loaded, the tool works offline since all processing is done locally in your browser.
Troubleshooting
The file upload isn't working
- Check that you're selecting a supported file format
- Ensure the file is not corrupted
- Try a smaller file if upload fails
- Check your browser's file upload settings
The diff results look wrong
- Verify that both files have content
- Check if your options are hiding differences
- Ensure the files are actually different
- Try with the example content to test the tool
The tool is not responding
- Refresh the page and try again
- Clear your browser cache
- Check if you have sufficient memory available
- Try with smaller files
I can't copy the results
- Ensure you have content in the diff results
- Check if your browser allows clipboard access
- Try using Ctrl+C (Cmd+C on Mac) as an alternative
- Check if any browser extensions are interfering
Advanced Usage
Can I compare more than two files?
No, the tool is designed to compare exactly two files at a time. For multiple file comparisons, you'll need to do separate comparisons.
Can I save the diff results to a file?
While the tool doesn't directly save files, you can copy the results and paste them into a text editor to save them.
Is there an API for the tool?
No, the tool is designed for manual use through the web interface. There's no API available for programmatic access.
Can I customize the diff output format?
The tool uses a standard diff format that's widely recognized. The format cannot be customized, but it's compatible with most diff viewers and version control systems.
Best Practices
How should I name my files?
Use descriptive names that indicate the purpose of the comparison:
config-prod.json
vsconfig-dev.json
README-v1.md
vsREADME-v2.md
script-original.js
vsscript-updated.js
When should I use the diff options?
- Use Ignore Whitespace when comparing code with different formatting
- Use Ignore Case when case sensitivity doesn't matter
- Use both options for maximum flexibility in comparisons
How can I get the most accurate results?
- Ensure your files are properly formatted
- Use consistent line endings
- Choose appropriate diff options for your use case
- Review the statistics to understand the scope of changes
What should I do with the results?
- Copy results for documentation or sharing
- Use statistics to understand change scope
- Save important comparisons to history
- Review results carefully for accuracy
Still Have Questions?
If you have questions not covered in this FAQ, you can:
- Try the tool with the example content to understand its capabilities
- Check the Basic Usage Guide for step-by-step instructions
- Review the Advanced Features for more detailed information
- Look at the Examples for real-world use cases