Template:IPA-en/doc

Purpose
 formats IPA transcriptions and links them to WP:IPA for English. The transcription should match the conventions of that key; for narrower dialect transcriptions, use IPA-all, which links to a more complete IPA key.

Usage
Per WP:LEAD, do not use this template in the lead section for common English words (like pub, rose, pencil, bus, Monday, Earth, etc.).

The first parameter in the template is for the transcription, and a second optional parameter is a switch that controls the wording introducing the transcription. With no second value, the introduction English pronunciation: appears:

Any of these may be combined with a sound file in an optional third parameter:

To use the default introductory wording when a third parameter is used, a placeholder such as ‹-› (something that does not match any of the above switches) is required in the second parameter: or the third parameter must be explicitly numbered: