View source for Template:Advert/doc

{{Documentation subpage}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
{{High-use}}
{{Template shortcut|Ad|Advertising|Advertisement|Promotion|Promo}}
{{Spam-nav}}
{{Twinkle standard installation}}

=== When to use ===
Add this to articles that need help from other editors because in whole or part they are [[Wikipedia:Spam#Advertisements_masquerading_as_articles|advertisements masquerading as articles]]. For example, they may '''tell readers to buy the company's product, provide price lists, give links to online sellers, or use unencyclopedic or meaningless [[buzzword]]s.'''

The advert tag is for Wikipedia articles that in whole or part have been made into [[public relations]] documents or [[WP:BROCHURE|brochures]], with content that portrays an issue, a product, an organization, or a person in an ''unfairly'' ''positive or negative'' light. 

The issue this tag addresses is the policy [[WP:PROMO]], which forbids content that reflects:

* '''Advocacy, [[propaganda]], or recruitment''' of any kind: commercial, political, scientific, religious, national, sports-related, legal, or otherwise. An article can report objectively ''about'' such things, as long as an attempt is made to describe the topic from a [[Wikipedia:neutral point of view|neutral point of view]].
* '''Self-promotion.'''   This needs to go well beyond Wikipedia editors believing that the subject created or write the article, and then deciding that the mere existence of the article helps the subject promote themselves.
* '''Advertising, marketing or public relations.''' Information about people, organizations, issues, and products must be written in an [[Wikipedia:Neutral point of view|objective and unbiased style]], free of [[Wikipedia:Avoid peacock terms#Puffery|puffery]]. 

If an article appears to be any of the above, this tag may be appropriate.  '''This is not a {{tl|COI}} tag.'''  Decide whether to add this tag based on ''the article's contents'', and not based on your belief about who wrote the article.  If you add this tag, you should be able to identify specific, correctable content that tends to "sell" the subject.

This template adds articles to [[:Category:Articles with a promotional tone]].

=== How to use ===

==== Articles ====
* Place {{Tlc|Advert|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}} at the top of the article.
* You can adjust the default "article" text with something more specific, such as: {{Tlc|Advert|article's "Controversy" section|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}.

==== Sections ====
* To mark specific sections instead of the whole article, place {{Tlx|Advert section|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}} at the top of the section.

==== Remarks ====
* To replace the text "an advertisement", you may use {{Tlc|Advert|article/section|yourtext}} or {{Tlc|Advert|2&#61;yourtext}} or {{Tlc|Advert|type&#61;yourtext}}

=== See also ===
* {{Tl|Advert inline}} – For marking specific promotional language
* {{Tl|Advert section}} – For tagging specific promotional sections
* {{Tl|Essay}} – For opinion pieces
* {{Tl|External links}} – For marking sections with inappropriate use of external links
* {{Tl|Fanpov}}
* {{Tl|Like resume}}  – For marking biographical articles that promote the subject by listing achievements in the manner of a [[Curriculum vitae|CV]]
* {{Tl|List spam}} – For marking lists that contain spammy entries
* {{Tl|News release}}
* {{Tl|Peacock}}
* {{Tl|Promotion inline}} – For tagging non-advertising promotional material
* {{Tl|Promotional source}} – For tagging promotional sources that have been cited in an article
* {{Tl|Spam}} – For warning spammers on their talk pages
* {{Tl|Travel guide}}

* [[Wikipedia:WikiProject Spam]]
* [[Wikipedia:WikiProject External links]]
* [[Wikipedia:Cleanup process]]
* [[Wikipedia:Template messages/Cleanup]]

== TemplateData ==
{{TemplateData header}}
<templatedata>
{
    "params": {
        "1": {
            "label": "Scope (e.g. section)",
            "description": "This parameter allows an editor to replace the default word \"article\" with another word, usually \"section\"",
            "type": "content",
            "default": "article"
        },
        "type": {
            "autovalue": "",
            "aliases": [
                "2"
            ],
            "label": "Type",
            "description": "To replace the text \"an advertisement\" with another phrase",
            "type": "content",
            "default": "an advertisement"
        },
        "date": {
            "label": "Month and year",
            "description": "Month and year of tagging; e.g., 'January 2013', but not 'jan13'",
            "type": "string",
            "autovalue": "{{subst:CURRENTMONTHNAME}} {{subst:CURRENTYEAR}}",
            "suggested": true
        }
    },
    "format": "inline",
    "description": "Template for tagging advertisements masquerading as articles"
}
</templatedata>

<includeonly>{{sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Neutrality templates]]
[[Category:Cleanup templates]]

}}</includeonly>