Please download one major version previous from the latest, but at minimum version 56.0.6. The file should be named something like dataloader_mac_vwhatever version you want to download.zip
EXAMPLE: If the latest release version is 30.9.2, you’ll want to download version 29.x.y, where x and y are the highest subversions of major version 29
WHY? Salesforce regularly updates its API but delays the new version from production environments
If you download the latest release version and try to use it in production, but production is not updated to that API version yet, your upload probably won't work
Newest API versions are released as a preview in sandbox environments, so the latest version of the dataloader should always work in sandboxes, but you may have to wait till it works in prod
Remember if your Mac is using an Apple processor. If you’re not sure, follow these substeps
From any window, top left corner of the screen should be an Apple symbol, click that
Click About this Mac
Look for Processor or Chip
If you see “Intel” anywhere on that line, you do not have an Apple processor
If you see “Apple M”something on that line, you do have an Apple processor
If you do not have Java installed, or you’re not sure if Java is installed, follow these substeps. If you’re really sure you already have Java installed, go to the next numbered Step.
If you do not have a Mac processor
Install Java from GitLab’s Self Service app
From any window, top right of the screen should be a magnifying glass
Click that and search for Self Service
If you see Self Service.app show up, open that
If you don’t see Self Service.app anywhere, ask IT about it
Open Self Service app and search Java
Install “Java”version number”- Open Source”
Really unlikely, but if the version number is < 11, please let someone on the Sales Systems team know, Dataloader requires at least Java version 11 to run
If you do have an Apple processor
We’ll be downloading Java directly, you need a slightly different version than what the Self Service app provides
Go to Azul JDKs and scroll down till you see a button to download a .dmg file
The link in the above substep should already have a few options filled in for you, Java 18, macOS, ARM 64-bit, and JDK. If these aren’t set, or this version of Java is no longer available, or you also want/need to use Salesforce CLI, please let someone on Sales Systems know
Click the .dmg button and download it
When it’s done downloading, open the .dmg file and install Java. If it asks you about where to install it, the defaults should be OK
Don’t follow Salesforce's instructions, this handbook page will explain the rest of the steps you need
Find the zip file for Dataloader you downloaded from Step 2 and extract it
From the extracted folder, hold down the “control” key and click the “install.command” file, from the dropdown, click “Open”
If a window pops up, click “Open” again
A terminal window should pop up. This is the Dataloader install wizard
First thing it should be asking is where to install. The default path is fine, just hit “enter”
It should then ask if you want a desktop shortcut. I suggest you type Yes and hit “enter” to create a shortcut
The last thing it should ask is if you want to add an Applications shortcut. Type Yes if you do or No if you don’t then hit “enter”. We usually do Yes
The installation should be finished! You can close the terminal window if it looks like there were no problems
Ask someone on Sales Systems if it looks like there’s a problem in the terminal window
You can delete the zip file and the extracted folder
Try opening Dataloader from one of the shortcuts if you made one. Tell someone on Sales Systems if it doesn’t open or if there are any errors while opening.
Uninstalling Dataloader
If you added a shortcut to Applications for the version of Dataloader you want removed
Go to Applications in Finder and delete the shortcut
If you added a shortcut to Desktop for the version of Dataloader you want removed
Go to Desktop in Finder and delete the shortcut
If you know where you installed the version of Dataloader you want removed
Go there and delete the folder
Skip the rest of the numbered steps, you’re done!
Try using Search to find where it was installed
From any window, top right of the screen should be a magnifying glass, click that
Type dataloader
There should be a folder in the results, click that folder to bring up a Finder window
In that folder, if there’s only one sub folder with a version number, you can delete the whole “dataloader” folder
If there’s multiple versions, delete the versions you don’t want and keep the ones you want to keep. To delete all of them, delete the whole “dataloader” folder
If you can’t find where it was installed, don’t worry too much, you should be able to have different versions installed at the same time with no conflicts, or ask someone on the Sales Systems team for help
