Do custom folder icons sync through iCloud Drive?
iCloud Drive synchronizes the folder and its files, but Apple does not promise that a custom Finder icon will appear on every Mac or in the Files app. Confirm the content first, inspect the icon separately, and reapply the artwork on each Mac when the appearance does not follow.
A synced folder and a synced Finder appearance are two different results
The useful distinction is between content and appearance. Apple says that when Desktop and Documents are stored in iCloud Drive, the files in those folders move to iCloud, new files are stored there automatically, and you can reach them from your other devices. That is the promise to test: the same folder name, documents, and current edits should become available after synchronization finishes.
A picture pasted onto the small icon in a Finder Info window is a customization made by Finder. Apple's icon guide explains how to add and remove that picture, but it does not say that the appearance is distributed by iCloud Drive. The safe conclusion is therefore limited: do not use the custom icon as proof that synchronization succeeded, and do not assume a missing icon means the folder or its files failed to arrive.
This matters most when two Macs show the same project folder differently. If its files open and contain the expected changes on both machines, iCloud Drive has done the important job. One Mac can still show your artwork while the other shows a standard folder. Treat that as a local presentation issue and fix it without moving, duplicating, or deleting the synchronized folder.
Verify iCloud Drive before troubleshooting the custom icon
Start with evidence inside the folder. On the first Mac, create a small text document with a distinctive name, such as sync-check-10-september, save one line in it, and leave it in the iCloud Drive folder. On the second Mac, open iCloud Drive in Finder and wait for that document to appear. Open it and verify the line rather than relying only on the folder name.
If you use Apple's Desktop and Documents setting, the location depends on the macOS version described in Apple's current support article. On macOS Tahoe 26 or later, Apple places Desktop and Documents in iCloud Drive under Favorites in the Finder sidebar and shows a cloud symbol beside each name. Earlier versions show them under the iCloud section. A status indicator concerns availability of the item; it does not certify that every visual customization has been reproduced.
Also check that both Macs are signed in to the intended Apple Account, that iCloud Drive is enabled, and that Sync this Mac is on. Apple tells people with more than one Mac to repeat the Desktop and Documents setup on every Mac they want to use with iCloud Drive. Do not toggle the feature off merely to refresh an icon: Apple explains that disabling it changes where Desktop and Documents are kept, which is far more disruptive than an appearance mismatch.
Apply the custom folder icon with Apple's native Finder method
Once the folder's contents are present on the Mac you are using, set the icon there with the documented Finder procedure. Open the image in Preview and copy the image itself. Select the target folder in Finder, choose File > Get Info, then click the small icon at the top of the Info window, below the title bar. Choose Edit > Paste.
The small target is important. Apple notes that Paste may be unavailable when the large icon beneath Preview was selected instead. If nothing happens, return to the top of the window and click the small icon until it is visibly selected. To restore the standard icon, select that same small icon and choose Edit > Cut; removing the artwork does not remove the folder or any files inside it.
Current macOS also offers Customize Folder for colors, symbols, and emoji. That is a different native appearance tool. Apple's guide documents selecting a folder, opening the Action menu, and choosing Customize Folder. It still does not turn an appearance into a file-sync test. Whichever native method you use, inspect the result on every Mac where the visual cue matters instead of promising that one change will appear everywhere.
Use a two-Mac test that cannot confuse icon state with file state
Run the test in this order so each observation answers one question. First, put the folder in iCloud Drive and confirm the test document on Mac B. Second, apply the custom icon on Mac A. Third, inspect the same folder on Mac B without renaming or recreating it. Record two separate answers: content present? and custom icon present?
| Files on Mac B | Icon on Mac B | Next action |
|---|---|---|
| Present and current | Custom | No action; verify again after a later edit if the visual cue is important. |
| Present and current | Standard | File sync works; apply the icon locally on Mac B. |
| Missing or old | Either appearance | Troubleshoot iCloud Drive, account, connection, and item status first. |
| Present in Files app | Generic appearance | The content is accessible; do not infer a Mac Finder icon failure from the mobile view. |
This small matrix prevents the most expensive mistake: deleting a healthy cloud folder because its decoration looks wrong. It also produces a repeatable answer after adding a new Mac. The icon is optional organization; the documents are the data that must be protected. If the files are not current, make a safe copy before changing cloud settings and follow Apple's iCloud Drive guidance rather than experimenting with the icon.
A reliable multi-Mac workflow treats the artwork as a reusable source
Keep the original icon artwork as an ordinary image file in a clearly named iCloud Drive folder, for example Folder artwork. The image file itself is content, so it can be found on another Mac after iCloud synchronization. The appearance you create by pasting that image onto a folder is a separate step. This arrangement gives you one controlled source without claiming that Finder's presentation will travel with it.
Use stable names for both the artwork and target folders. If a second Mac shows a default icon, open the synchronized artwork in Preview and repeat Apple's Get Info steps on that Mac. If several people share an iCloud Drive folder, tell them the icon is optional and may differ in their Finder. Never make a color or picture the only way to identify an important directory; keep the folder name descriptive and put workflow details in a document the group can actually synchronize.
When you replace an icon design, update the source image first, then apply it where needed. Check the folder contents before and after so the appearance task stays separate from file management. This is less magical than expecting a Finder decoration to propagate automatically, but it is predictable, reversible, and safe. It also works when a Mac is offline: the local icon can wait while the underlying files follow their normal iCloud availability rules.
Use Mac+ as a local shortcut, not as an iCloud sync service
The native Get Info method is enough for one or two folders, and it should be your first test. When you want a coordinated set of folder styles, Mac+ can create and apply custom icons locally without making the same paste repeatedly. It is useful for preparing a consistent visual system, not for changing what iCloud Drive promises to synchronize.
The same limitation must remain explicit: Mac+ does not make a custom folder icon sync to every device. Confirm the folder and its files through iCloud Drive, then apply the desired style on each Mac where it is missing. Keep the original design file in iCloud Drive if you want every Mac to use the same source artwork.
This division of labor is deliberate. iCloud Drive handles access to the data documented by Apple; Finder or Mac+ handles the way a folder looks on the Mac in front of you. If an icon disappears after a system update, follow the focused recovery guide linked below. If it refuses to change on one Mac, troubleshoot that local Finder operation. Neither symptom, by itself, proves that the synchronized files are unsafe.
Test a custom iCloud Drive folder icon safely
- On Mac A, place the folder in iCloud Drive and create a uniquely named test document inside it.
- On Mac B, open iCloud Drive in Finder, wait for the test document, open it, and verify its contents.
- Back on Mac A, open the artwork in Preview and choose Edit > Copy.
- Select the synchronized folder, choose File > Get Info, click the small icon at the top, and choose Edit > Paste.
- Inspect the same folder on Mac B. If the files are current but the icon is standard, apply the artwork locally there.
- Keep the source artwork as a regular image in iCloud Drive so it remains easy to reuse on another Mac.
Apply folder styles locally on macOS 13 or later; iCloud Drive synchronization remains separate.
Frequently asked questions
Do custom folder icons sync with iCloud Drive?
Apple documents iCloud Drive synchronization for folders and files, and separately documents how Finder applies a custom icon. Apple does not promise that the pasted icon appears on every Mac or in the Files app. Verify the files first, then check and reapply the icon on each Mac where needed.
Why is my iCloud folder on the second Mac but its icon is blue?
The folder's arrival and its Finder appearance are separate observations. Open a recent file to confirm synchronization. If the content is current, leave the cloud folder in place and use Preview plus File > Get Info to paste the artwork locally on the second Mac.
Does a missing custom icon mean iCloud Drive failed?
No. A missing icon alone says nothing reliable about the documents. Check a uniquely named test file and its contents on the other Mac. Only troubleshoot iCloud Drive when the folder, file, or latest edit is missing; treat an icon-only difference as an appearance issue.
Will a custom Mac folder icon appear in the Files app on iPhone or iPad?
Do not count on it. Apple's iCloud instructions explain how to access Desktop and Documents through the Files app, but do not promise that Finder's custom folder appearance is reproduced there. Use the folder name and contents as the dependable identifiers on mobile devices.
How do I remove a custom icon without deleting the iCloud folder?
Select the folder in Finder, choose File > Get Info, click the small icon at the top of the window, then choose Edit > Cut. Apple documents this as the way to restore the original icon. It changes the appearance, not the files inside the folder.