In this question, I learned that the "dotted-line cloud" icon in OS X's iCloud file view means "Waiting to upload". While writing a document in Byword today, I saved it and found it had been marked with this icon - there were several other documents, months old, that still had the "Waiting" icon as well.

Is there any way to, if not force, gently encourage these files to upload to iCloud?

  • 2
    The gently encourage part is so Apple :) I was wondering if there would be a better solution now in 2017. But apparently not. Aug 22, 2017 at 13:47
  • It appears that attempting to download them from iCloud on another computer will cause the computer that actually has them to upload them (assuming the host is also connected at that time)
    – iconoclast
    Oct 4, 2017 at 3:09
  • In my case, I was trying to upload a file to icloud via an iPhone, and it got stuck in the message "waiting to upload". But later, as soon as I turned on the Wifi in my home, it started uploading immediately!... it was nice, it didn't want to burden my cell phone bill :-)
    – Alexandre
    Dec 31, 2017 at 20:38
  • One can explicitly upload items to iCloud via the web interface at icloud.com Maybe this is an alternative?
    – jefe2000
    Dec 6, 2019 at 17:56
  • 3
    Still crap in 2020 Jun 11, 2020 at 15:54

14 Answers 14


In the terminal touch the file and it is fixed.

  • This is probably the least-"destructive" way to nudge iCloud into re-syncing a file (I would imagine—haven't tested it), since touch just changes file metadata (the modification and access times). I like that better than making a change to the file's name or actual contents and then reverting that change!
    – Dan J
    Feb 2, 2020 at 2:22
  • This is so great. Thank you!
    – adamyonk
    Jun 21, 2020 at 14:58
  • Doesn't work any better than trying to rename, make a slight change etcetera. Sometimes it work, sometimes not. Just depends if it's your lucky day or not. Oct 16, 2020 at 18:47
  • Worked for me..
    – d-b
    Oct 17, 2020 at 20:53
  • 1
    A simple touch updated my macOS finder from the "dotted line" icon to the solid line icon. Smooth trick.
    – Urda
    Jun 15, 2021 at 17:48

I was concerned I'd have to save these documents to my local filesystem, delete them from iCloud, and then perhaps save them to iCloud over again, but it turned out that simply re-opening the "Waiting" documents, making a trivial change to them (such as deleting a character and then adding it in again), and then saving the file caused them to be synced successfully.


I just had success by renaming the file (added a space to the end)


I ran into a similar problem but every time I tried to open the file, the hosting application (Keynote in this case) hung. I was able to killall -9 ubd to unwedge iCloud.

  • 1
    No matching processes were found
    – iconoclast
    Dec 28, 2017 at 4:45
  • 2
    Yes, this was a nearly 4 year old response. ubd no longer exists on current macOS versions. Dec 30, 2017 at 14:50
  • What is the current alternative? Do you know of any? (And I'm on 10.11.6 anyway—originally to maintain the use of Karabiner, and later because the hassle of recreating my Karabiner config in Karabiner Elements outweighs any obvious benefits of upgrading.)
    – iconoclast
    Jan 3, 2018 at 22:19

I had to shut down and restart my iPad Pro in order to get the PSD file I was trying to upload to finally stop “waiting to upload” and just do it already.


What solved the problem for me was signing off iCloud account and removing the data from all the devices assigned to my account and then signing back in. After doing so on all of my devices (two iMacs and iPhone) and signing back in, syncing worked as it should in iCloud Drive and in Notability.


The way I fixed it was to drag one document over another, which automatically creates a folder (like in iOS). Then, I dragged them back out from the folder, and the status waiting status was gone.

  • This does absolutely nothing for me.
    – iconoclast
    Dec 28, 2017 at 4:46

The way I fixed “waiting” was to drag one document over another while holding down “option” key.

  • Besides copying one of the files, this changed the status message under the file to "Uploading" for several seconds, but it reverted back to "Waiting to upload"... and then to "Uploading", and back to "Waiting to upload".... 😱
    – iconoclast
    Dec 28, 2017 at 4:43

When I first experienced this problem I tried clicking on the icloud download icon and I received the "waiting" message after about five minutes. However, I checked inside the folder and noticed that other documents also had the "waiting" message. I navigated to the upper level folder and clicked icloud icon of the folder with my "waiting" documents inside. It took about 35 minute and I never navigated away, but all the documents marked as "waiting" eventually downloaded.


If you trying to upload files over mobile data make sure you change icloud settings to allow for sync over mobile data and then try restarting your phone.

I added a document to my files, then changed my icloud setting (which I should've done before trying to upload them) then I found I had to restart my phone before the files actually uploaded to icloud.


Log off or restart the system. This worked for me on Macbook.


On the Mac I simply used the Compress command to create a .zip file of the missing file. In one case this was enough to trigger the refresh.

In other cases I had to unzip the compressed file and then check the contents. Once confirmed they were correct I just deleted the original file and the .zip file. I then renamed the uncompressed one that just had a 2 added to the name and everything was fine.

ps -ef | grep -i 'Support/bird' | grep -v grep | awk '{ print "kill -9 " $2}'|zsh

did it for me

  • Please explain what this is doing and why it works
    – mmmmmm
    Dec 27, 2021 at 21:31
  • Nice find about killing a stuck daemon. Shorter versions are pkill -f 'Support/bird' (or, if you are on an old version of macOS, kill $(ps -ef | awk '/Support\/bird/ { print $2}')).
    – nohillside
    Dec 28, 2021 at 8:03
  • Worked on OSX Monterey
    – Rescribet
    Apr 13 at 9:48
  1. 2-finger-click the song.

  2. Select "Add song to iCloud music library".

  • 1
    How does this help to upload stuck files into iCloud?
    – nohillside
    Jan 22, 2016 at 19:51
  • We're looking for long answers that provide some explanation and context. Don't just give a one-line answer; explain why your answer is right, ideally with citations. Answers that don't include explanations may be removed.
    – Tetsujin
    Jan 23, 2016 at 8:55

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .