Template:Promotional

Template documentation[view] [edit] [history] [purge]

This template is used on approximately 18,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.

Shortcuts

Any breaking changes to this template, including moving it or nominating it for deletion, must be communicated in advance to Twinkle's users and maintainers at Wikipedia talk:Twinkle. The standard installation of Twinkle relies on this template. Thank you.

When to use

Add this to articles that need help from other editors because in whole or part they are written in a promotional manner. 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 buzzwords.

The template is for Wikipedia articles that in whole or part have been made into public relations documents or brochures, with content that portrays an issue, a product, an organization, or a person in an unfairly positive or negative light.

The issue the template 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 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 objective and unbiased style, free of puffery.

If an article appears to be any of the above, the template may be appropriate. This is not a {{COI}} tag. Decide whether to add the template based on the article's contents, and not based on your belief about who wrote the article. If you add the template, 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 {{Promotional|date=January 2026}} at the top of the article.
You can adjust the default "article" text with something more specific, such as: {{Promotional|article's "Controversy" section|date=January 2026}}.

Sections

To mark specific sections instead of the whole article, place {{Advert section|date=January 2026}} at the top of the section.

Remarks

To replace the text "promotional content", you may use {{Promotional|article/section|yourtext}} or {{Promotional|2=yourtext}} or {{Promotional|type=yourtext}}

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Promotional in articles based on its TemplateData.

TemplateData for Promotional

<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 \"promotional content\" with another phrase",
           "type": "content",
           "default": "promotional content"
       },
       "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 articles with promotional content"

} </templatedata>

The above documentation is transcluded from Template:Promotional/doc.
Editors can experiment in this template's sandbox and testcases pages.
Add categories to the /doc subpage. Subpages of this template.