Template:US/doc

This template generates a hatnote for use at the top of pages or page sections where content is irrelevant, misleading, or harmful to non-US investors. In this context, "non-US investors" is taken to mean US nonresident aliens; that is, investors who are not US residents, not US citizens and not US green card holders.

Usage
Invoke with:

🇺🇸

All parameters are optional:
 * item: The text element to which this hatnote refers. Default is "article" in Main namespace, and "page" elsewhere.
 * reason: A specific reason for the hatnote. Enumerated. Default is "misleading". Value is one of
 * harmful: Appends "For non-US investors, acting on fund or ETF suggestions in it may have harmful US tax consequences.",
 * irrelevant: Appends "It does not apply to non-US investors."
 * misleading: Appends "It may not apply to non-US investors."
 * partially_irrelevant: Appends "Parts of it do not apply to non-US investors."
 * partially_misleading: Appends "Parts of it may not apply to non-US investors."
 * none: Appends nothing.
 * non-US_link: Appends "Non-US investors can find related information at (link)." This parameter accepts NonUSlink as an alternative name.

Parameters may also be supplied by position, in the order shown above. Mixing positional and named parameters in a single invocation becomes unclear. Use only one method or the other. This template adds pages in Main namespace to.

General
Using results in: 🇺🇸

Using results in: 🇺🇸

More precise
Using results in: 🇺🇸

Using results in: 🇺🇸

Using results in: 🇺🇸 Using results in: 🇺🇸

Using results in: 🇺🇸

Using results in: 🇺🇸

Using results in: 🇺🇸

Using results in: 🇺🇸

Using results in: 🇺🇸

Using results in: 🇺🇸

Using results in: 🇺🇸

Using results in: 🇺🇸

Using results in: 🇺🇸

Guidelines for use
Deciding whether to add this template to an article, and if yes, which options to use for that article, can be difficult. It is ultimately a judgement call. Some guidelines for how to go about this are shown below.

If this is too complex to unravel, as a general rule-of-thumb, if adding this template to an article, use  for any articles that recommend specific US domiciled funds or ETFs, and   otherwise. Everything else is less important detail.

Guidelines and example pages:
 * Use:
 * For: Articles that appear US-specific, but where none of the following use cases apply, or where it is unclear which might apply.
 * Use:
 * For: Articles that recommend specific US domiciled funds or ETFs. These can have damaging US tax consequences for non-US investors, so a warning is required. Examples include Three-fund portfolio, Lazy portfolios, and List of US ETFs. Commonly found in the wiki.
 * Use:
 * For: Articles covering topics that clearly have no relevance to non-US investors. US tax-shelter or tax-deferred plans, US social security payments, US tax brackets, and so on. Examples include IRA, 401k, and 529 plan. Relatively common in the wiki.
 * Use:
 * For: Articles that may mislead non-US investors into actions that make no sense outside of the context of US investors. Typically, an article that describes a topic without reference to US-only details, but where the article nevertheless relies on something US-specific. Index fund might be an example. It describes mutual funds in relatively country-agnostic terms, but assumes capital gains distributions, something that does not occur with non-US domiciled funds. ETFs vs mutual funds is another example. This class of article may be a candidate for applying  at the section level, or alternatively   at the article head.
 * Use:
 * For: Articles with some content that is irrelevant to non-US investors, but where the bulk may be okay.
 * Use:
 * For: Articles with some content that is misleading to non-US investors, but where the bulk may be okay. Exchange-traded fund might be a candidate. The general concepts of ETFs are country-agnostic, but this article merges them with US-specific information in a way that is difficult to separate out.
 * Use:
 * For: Articles where there is a related (but not specific) non-US article on the topic. Select  as appropriate.
 * Use:
 * For: Articles where there is a specific non-US article on the topic. Getting started might be an example.
 * Use:
 * For: Articles that are country-agnostic with the exception of one or more US-specific subsections. Apply to the section rather than to the article head.