Problem:
Do NOT allowing swapping symbol pin locations in the schematic. If you update from library later, it will use the symbol from the library that does not have swapped pin locations.
Solution: Create an Alternate part in the *.Schlib
Problem:
When using DBLIBs do NOT leave Footprint Refs embedded in Schlib files or you can end up with the wrong Footprint placed in the design.
Library Hierarchy is Left to Right and Top Down
I recommend you do NOT use the Search paths, or use them very wisely.
Altium will search your entire C: Drive you set the Search Path to C:\
Problem:
Duplicate Library or Footprint Ref.
Solution:
Use single part libraries with file names that match the Ref, then place all Symbols in a folder named Symbols. Do the same for the Footprints, use single part PCBLIBs with matched Ref and File names placed in the Footprints folder.
If the Refs match the file names it will now be impossible to create a duplicate part using the same name when all of the like type libraries are in the same folder.
Note there should be no Footprints listed in the SCHLIB files.
I prefer using DBLIBs.
Problem:
Inconsistent file paths found in Footprint properties
Example two different users placing parts from the same DBLib
Solution:
Example
Use Version Controlled GIT Repo and instruct all users to Clone to the same Folder on their local machine, example C:\Parts Git Repo
Folders in C:\Parts Git Repo\
Using Store Path Relative to Database Library' in the DBLIB will make your database portable. You can move the DBLib and libraries to another drive or folder with no need to specify the absolute path to the database.
As shown above the Symbols and Footprints folders should be in the same folder as the DBLib.