How to add an icon to the Mac Dock, and change it

The phrase covers two jobs that have nothing to do with each other. One is putting something in the Dock so it can be clicked without opening Finder first. The other is replacing the picture on something already there, usually because three items now look alike at Dock size. The steps differ, the failure modes differ, and mixing them up is why an afternoon gets spent dragging things that were never going to stay.

Sort out which one applies before touching anything. If the goal is a click target, the question is which side of the Dock the item is allowed to land on. If the goal is a picture, nothing gets dragged into the Dock at all: the work happens in the Info window of the file itself.

The separators decide where an item can land

The Dock looks like one strip and behaves like three zones. Lines divide it, and each zone accepts a different kind of thing. Apple's instructions for adding items are written entirely in terms of those lines:

Drag files and folders to the right side of (or below) the other line that separates recently used apps. Source: support.apple.com

Applications go on the other side of those lines. Files and folders go past them, next to the Downloads stack and the Trash. There is no setting that moves a document into the application zone, and no setting that moves an application into the file zone. The rule is structural.

That single fact explains the most common complaint about this task. Someone drags a bookmark, a saved link, or a document into the Dock, aims for the row of familiar app icons, and watches it snap to the far end near the Trash instead. Nothing went wrong. The Dock sorted it correctly, because what was dragged was a document.

The zone between the lines is not permanent storage either. It fills itself:

The Dock can show up to three recently used apps that aren't already in it and a folder for items you download from the internet. Source: support.apple.com

Anything appearing there arrived on its own and will leave on its own. Treating that slot as a place to keep something is the second most common way this goes wrong.

Adding an application icon, and making it stay

Two routes exist and they behave differently after the click.

The first is dragging. Open the Applications folder in Finder, drag the app onto the Dock, and drop it where the other app icons sit. The neighbours slide apart to show where it will go. Releasing there makes it permanent right away.

The second is promoting something already running. A launched app appears in the Dock whether or not it was kept there, and it leaves again when the app quits. To keep it, Control-click the icon while the app is open, then choose Options, then Keep in Dock. Apple's page frames this as the fix for accidental removal, and it is the faster route in practice because the icon is already under the pointer.

The distinction that matters is between a Dock icon and the item it points at. Dragging something out of the Dock does not delete it:

Only the alias is removed; the actual item remains on your Mac. Source: support.apple.com

The reverse direction is not symmetrical. Deleting the actual application leaves a Dock icon that points nowhere, which is what a question mark on a Dock tile means. The repair is not in the Dock. Reinstall or restore the app, then add it again.

Folders and files, and the fan that opens from them

Past the separator, a folder becomes a stack. Drop one there and a click opens a fan, a grid, or a list of what is inside, depending on what is chosen in the Control-click menu on that stack. Sorting is set in the same menu, and sorting by date added turns a project folder into a running list of the newest files without opening a Finder window.

This zone is where the Dock stops being a launcher and starts being a shelf, and it is underused. A single stack holds an unlimited number of destinations while occupying one tile. Ten reference sites saved as URL files inside one folder cost the same Dock space as one application.

Saved links belong here for a reason worth stating plainly. Dragging a URL out of a browser address bar produces a document that points at a page. Clicking it opens a tab in whatever browser is set as the default. It does not produce a window of its own, it does not appear when apps are cycled, and it cannot be placed with the applications. For a page opened a few times a month that is the correct amount of machinery. For a page open all day it is not, and the section below covers that case.

Individual files can be dropped here as well, and this is where the shelf idea pays off. A contract being revised over several days, a spreadsheet that gets a number added to it every morning, a scratch text file for pasted snippets: each of those is one click away without a Finder window or a search. When the work finishes, drag the tile out and the file itself is untouched.

The Applications folder as a single tile

One technique deserves its own mention because it removes the pressure to add anything else. Drag the Applications folder from the Finder sidebar into the file zone of the Dock. Control-click the resulting stack and set the view to Grid and the sort to Name.

What that produces is a launcher for every installed application from one tile. Clicking it shows the whole folder as a grid of icons, and the first letters of an app name can be typed to jump within it once the grid has focus. Anything installed later shows up automatically, with nothing to add and nothing to maintain.

The reason to bother is arithmetic. Applications that are opened once a month do not deserve permanent tiles, but they are also annoying to find. This single stack covers all of them, which means the application zone can be reserved for the handful of things opened every working day. A Dock of eight large, distinct icons plus one grid tile is faster to hit than a Dock of thirty shrunken ones, and it stops growing.

Changing the picture on an icon

This is the other half of the request, and it happens in Finder rather than in the Dock. Apple's steps are short. Open the image in Preview and choose Edit then Copy. Select the file, folder, or application whose icon should change, and choose File then Get Info. In the Info window, click the small icon at the top of the window, below the title bar, then choose Edit then Paste.

One detail causes most failures:

If Edit > Paste isn't available, you may have clicked the large icon below Preview. Source: support.apple.com

The target is the small icon in the top left corner of the Info window, not the large preview further down. When the correct one is selected it gains a highlight ring.

Going back is the same sequence with Cut instead of Paste, which restores whatever the item shipped with. Two consequences follow from where the image is stored. It is attached to the item, not to the Dock tile, so it also shows up in Finder, in the app switcher, and in Spotlight results. And because it is attached to the item, replacing the item replaces the image, which is why a custom picture on an application can vanish after that application updates itself.

When the icon you want belongs to a website

Nothing above helps if the destination is a web page and the requirement is a real tile in the application zone. There is no application to drag, so the sequence has to start by producing one.

What is added	Which zone it lands in	What a click does	Appears in the app switcher
An installed application	Application zone	Opens the app	Yes
A folder	File zone	Opens a stack	No
A URL file dragged from a browser	File zone	Opens a tab in the default browser	No
A site built into a standalone app	Application zone	Opens a window with no tab bar	Yes

Only the last row satisfies a request for an icon that behaves like the rest of the Dock. Safari can produce that row on macOS Sonoma 14 and later through Add to Dock in the File menu. Chromium browsers produce it through the menu item that installs the page as an app. A dedicated web app wrapper for macOS produces it too, and adds the parts those routes leave out, such as choosing the icon rather than accepting whatever favicon the site publishes, and keeping several accounts of the same service in separate containers. The trade-offs between those routes are laid out under Features, and the list of services that come preconfigured is at Supported services.

Whichever route is used, the result is an ordinary application bundle. It can be dragged into the application zone, kept there through Options then Keep in Dock, and given a different picture through the Info window exactly like anything else.

Keeping the Dock readable once the count climbs

Adding is easy, which is the problem. Past roughly a dozen tiles the Dock scales itself down to fit the screen width, and the icons that were added to save time start costing time.

Three settings in System Settings, under Desktop and Dock, do most of the work. Size controls the resting scale. Magnification enlarges whatever the pointer is over, which is what makes a small resting size usable. Position on screen moves the Dock to the left or right edge, where a tall display offers far more room than the bottom edge does on a wide one.

One more setting belongs in the same pass. Turning off the display of recent applications removes the self populating zone described earlier, which stops the layout from shifting during the day. A Dock whose icons never move can be used without looking at it, and that is worth more than any single icon in it.

Then there is the audit that nothing in System Settings will do. Go through the tiles and ask which ones were clicked this week. The ones that were not are costing space and search time for a destination reached faster through Spotlight. Keeping the Dock to the things opened every working day, with everything else collected into one or two stacks past the separator, holds the whole thing at a size where the icons stay legible.

What to change first

Start by deciding which of the two jobs is actually needed, because a picture change and a placement change never solve each other. If several tiles look alike, paste distinct images through the Info window. If a page that is open all day still lives in a browser tab, build it into a standalone app first, then place it with the other applications: Kagemusha walks through that route with presets for the common services.