How to Get and Use American Airlines 500-Mile Upgrades

Here is a very handy reference on AAdvantage 500-mile upgrades.

The Ins and Outs of American Airlines 500-Mile Upgrades

They can only be used on paid travel (not award travel), and you have to be an elite member to use them (unless your travel partner upgrades you).