Installing Your Mod in The Sims 4

Where The Sims 4 Mods folder lives, how to copy in your .package file, how to enable custom content in the game, and how to check the catalog.

Place your downloaded .package file in The Sims 4 Mods folder, then confirm custom content is enabled.

Shortcut: install straight from the editor

In Chrome or Edge on a desktop, the small arrow beside the Download button offers Install to Mods folder. Pick your Mods folder once (see Step 1 for where it lives) and the button becomes Install: each export is written into a Llama Builder subfolder inside Mods, ready for the game, so Step 2 below is done for you. Installing the same project again replaces the earlier file, and Remove from Mods folder in the same menu deletes the files this project installed. The browser asks for permission to write to the folder the first time each session.

Other browsers do not support writing to a folder, so they keep the plain download and the manual steps below.

Step 1: Find the Mods folder

The Mods folder is in your Documents directory, not the game installation folder:

Windows: Documents\Electronic Arts\The Sims 4\Mods
Mac: Documents/Electronic Arts/The Sims 4/Mods

If the Mods folder does not exist, create it inside the The Sims 4 folder.

Step 2: Copy the .package file

Move or copy the file into the Mods folder, either directly or inside a subfolder. The game reads .package files up to five folders deep, so keep the structure simple.

A TV Channel set to add a new channel also ships a .ts4script loader. Script files are only read at the top level or one folder deep, so do not bury those any further.

Step 3: Enable custom content in-game

Launch The Sims 4.
Open Game Options from the menu button in the top-right corner.
Go to the Other tab.
Check Enable Custom Content and Mods. That is all a plain .package needs, which covers almost everything Llama Builder exports. A TV Channel set to add a new channel also ships a script, so it needs Script Mods Allowed as well.
Click Apply Changes to reload your mods.

Step 4: Restart the game

Fully quit and restart The Sims 4. Mods load at startup, so file and setting changes only take effect after a restart.

Step 5: Verify in the catalog

Search by the name you set in Llama Builder, or browse to:

Wall Art / Rugs: Build/Buy, under Decorations or Rugs.
Vases: Build/Buy, under Decorations → Sculptures.
Tables: Build/Buy, by name.
Nails: Create-a-Sim, under Accessories → Nails.
Earrings: Create-a-Sim, under Accessories → Earrings.
Glasses: Create-a-Sim, under Accessories → Glasses.
Tattoos: Create-a-Sim, under Tattoos, in the category for your body region.
Eyes: Create-a-Sim. Contacts under Makeup → Face Paint; Eye Color in the Eye Color picker.
TV Channels: not a catalog item. Start a TV in a lot and open its channel list.

If your item does not appear, see the Troubleshooting guide.

Tips

Updating a mod: replace the .package file and restart. Items already placed in lots update automatically.
Removing a mod: delete the .package file. Items placed from it disappear from your lots.
After a game patch: The Sims 4 turns custom content back off after every update. Re-check Enable Custom Content and Mods (and Script Mods Allowed if you use one), click Apply Changes, and restart.