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]]) -->
{{Template shortcut|Ad}}
{{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 users 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 a 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, 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.''' 
* '''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 is appropriate.

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

=== How to use ===

==== Articles ====
* For articles needing major cleanup, place {{Tlc|Advert|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}} at the top of the article to alert readers.
* You can adjust the default "article" text with something more specific, such as: {{Tlc|Advert|article's "Controversy" section}}.

==== 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|Promotion inline}} – For tagging non-advertising promotional material
* {{Tl|Promotional source}} – For tagging promotional sources that have been cited in an article
* {{Tl|List spam}} – For marking lists that contain spammy entries
* {{Tl|External links}} – For marking sections with inappropriate use of external links
* {{Tl|News release}}
* {{Tl|Like resume}}
* {{Tl|Travel guide}}
* {{Tl|Fanpov}}
* {{Tl|Spam}} – For warning spammers on their talk pages
* {{Tl|Essay}} – For opinion pieces

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

== TemplateData ==
{{TemplateDataHeader}}
<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>