When you upload a file to iCloud Drive, the steps involved are complex. They’re outlined and diagrammed here, with pointers to how to diagnose and resolve problems.
Cirrus
A new app to help you work out why those files aren’t uploading to iCloud Drive, and more. Performs a test upload which could even fix a problem.
The Eclectic Light Company 