**Power tags** are an advanced feature which can add extra functions and layout options to your wiki pages (and sometimes research notes). They are entered like regular tags but follow the format `key:value`. After adding a power tag, you must refresh the page. 

To add tags, look for this box at the bottom of a wiki page or research note:


[![tags.png](https://i.publiclab.org/system/images/photos/000/006/790/medium/tags.png)](https://i.publiclab.org/system/images/photos/000/006/790/original/tags.png)

### General power tags 

* `events:foo` displays a listing of research notes tagged with "event" and "foo", and a link to post new notes with those tags in the left sidebar. 
* `sidebar:featured` displays "featured" links and images in the sidebar instead of the usual "related content"
* `style:presentation` hides the wiki toolbar (with Edit, Talk, Revisions) for more formal pages, and makes the lead image of wiki pages full-width
* `style:minimal` just hides the wiki toolbar (but it's accessible via a small caret button)
* `style:wide` removes the 800px width limit from wiki pages, and allows them to flow full page
* `style:fancy` is used to style articles from the GrassrootsMappingForum
* `style:nobanner`
* `parent:foo` adds a bar that links back to a parent wiki page
* `with:username` adds a co-author to your research note with a live link to the user's profile page, however, the note itself will not show up under that user's profile. 
* `lang:es` or `iso:es` is the way to indicate language in a research note or event. In this example, `es` indicates Spanish.

### List of power tags useful for chapter pages:

* `lat:41.023` and `lon:-71.023` latitude and longitude. Together with the simple tag "chapter", the combination of these three tags will create a point for your chapter [on the Places map](/places)
* `events:foo` displays a listing of research notes tagged with "event" and "foo", and a link to post new notes with those tags in the left sidebar. Especially useful where foo = the name of your chapter page. 
* `list:foo` displays recent posts from a Google Group with the name "foo" and a subscription input box
* `tabbed:notes` and `tabbed:wikis` display a tabbed header which offers tabs with links of related research note and wiki content
* `notes:foo` displays 4 recent "popular" research notes tagged "foo" (in grid view, popular means >20 views) at the top of the page, under the tabs if they exist. For example see [Gulf Coast](/wiki/gulf-coast]
* `parent:foo` adds a bar that links back to a parent wiki page, especially useful for places within regions

### Inline power tags

You can now use "inline" power tags in the middle of a research note or wiki page. The first one is for generating a list of notes for a given tag, and is used in this format:

> `[notes:<tagname>]`

For example, to list all notes tagged with `peru`, you can use:

> `[notes:peru]`

For a more complex example, you can list all questions on the topic of "infragram" using:

> `[notes:question:infragram]`

More advanced uses like **activity grids** can be found in this post: https://publiclab.org/notes/liz/08-30-2016/check-out-these-activity-grids


### Automated power tags, not for manual adding

You might see some of these being generated automatically, like when checking the box for a Research Note to be an "Event" or a "question" or when awarding Barnstars to someone's Research Note. Don't manually add these: 

* `event:rsvp` `date:YYYY-MM-DD` `rsvp:username` 
* `barnstar:barnstarname`
* `question:foo` `response:foo`


### Tag aliasing

_This feature is for admins only -- please contact web@publiclab.org with questions._

We're planning a system for aliasing tags, which serves a number of purposes:

A) **disambiguation** -- we have both `spectrometer` and `spectrometry` -- we'd prefer `spectrometry`. 

1. When looking at https://publiclab.org/tag/spectrometer, should you see content tagged with `spectrometry`? (I think yes, if they're "parented" to each other mutually.)

B) **subcategories** -- `multispectral-imaging` contains and is broader than `infragram`.

1. When looking at https://publiclab.org/tag/multispectral-imaging, should you see content tagged with `infragram`? (I think so -- that's a broader category that includes it.)
2. When looking at https://publiclab.org/tag/infragram, should you see content tagged with `multispectral-imaging`? (I think not -- that's a broader category than you're looking for.)

C) **extending functions** -- note that this requires **wildcard parenting** -- we want all posts tagged `activity:*` (where * could be anything) to **also** get features applied to the `seeks:replications` tag. But since wildcards are... wild, this functionality is more narrow, and only triggers more specific functions (using the `has_tag` feature; see this [issue if you're interested in how it works](https://github.com/publiclab/plots2/pull/871)). 

1. A post tagged `activity:spectrometry` also gets the "replication request zone" which is triggered by `seeks:replications` even though it doesn't explicitly have that tag, because `seeks:replications` tag has the "parent tag" of `activity:*` (a wildcard). 
2. However, when you see activities at https://publiclab.org/tag/activity:spectrometry, or **all activities** using https://publiclab.org/tag/activity:*, you don't also get content tagged with `seeks:replications`.
3. When you go to https://publiclab.org/tag/seeks:replications, you don't also get content tagged with `activity:*`.


**Later goals:**

Some aliasing features are more complex and not complete yet. 

**Email subscriptions** - when people subscribe to a tag, they should receive emails when content is posted using a tag that has a "parent" of the subscribed-to tag. (Or should it be when content is posted using a tag that **is a parent** of the subscribed-to tag?) Imagine if the tag `infragram` had the parent `multispectral-imaging` in each of the above scenarios.

And -- perhaps children should greedily fetch parent tags, but not vice versa -- say, if we say conductivity is a child of open-water but not everything open-water is conductivity... this could be important for "watching" tags or subscribing to them.

And clarification for usage -- though "balloon-mapping" is a type of "aerial-photography", we don't want one to return content tagged with the other...!