). 
Instant Views and Where to Find Them
- -This document describes Telegram's Instant View format in stupefying detail. If this is your first time hearing about Instant View, please check out our Introduction and Sample Templates before you dive in.
-If you're comfortable with the idea of Instant View templates, let's look at what makes them tick. To begin with, this is our in-house artist's idea of how Instant View pages are generated:
-It turns out, he is not entirely wrong. This is how Instant View pages are really generated:
--
-
- Whenever Telegram needs to display a link preview for a URL, it also checks whether an Instant View template exists for that domain. -
- If a template exists, our Instant View Bot obtains the page using the URL (it only processes pages that have the MIME-type
text/html).
- - The bot then applies rules from the template that determine the positioning of the key elements on the source page (using XPath 1.0 expressions) and modifies the page content to fit the Instant View format. -
- The edited page is used to create a new Instant View page that will be displayed to the user. -
This document will explore the Instant View Format, the Types of Rules your template can utilize, as well as some useful XPath constructs, conditions, and functions that may help you build better templates.
-This manual was intended to be used as a reference, so you don't have to read the entire thing to get started. Our sample templates make for a much better entry point. You can check back here whenever something is not clear.
-Recent changes
-September 10, 2020
--
-
- Added the new ~allowed_origin option -
- Added the new @load function -
- The @inline function now supports the
silentparameter which ignores errors while fetching a page
-
March 20, 2019
-Version 2.1
--
-
- Supported the
srcsetattribute in Image and Icon types. The IV engine will automatically take the highest image resolution available (but not higher than 2560px).
- - The @match function now returns only nodes which content was matched by regular expression -
- The @replace function now returns only nodes which content was replaced by regular expression -
- The @inline function no longer follows canonical redirect links while fetching a page -
Also in this update:
--
-
- Added the new @split_parent function -
December 10, 2018
-Instant View 2.0 expands the platform with support for right-to-left languages, new page blocks, useful functions and much more. We recommend using the latest version in your templates. To do this, add the following rule at the beginning of the template:
-~version: "2.0"Below is a list of changes in version 2.0:
-New properties:
--
-
- kicker -
- site_name -
New types:
--
-
- Map -
- Table -
- Details -
- RelatedArticles -
- Marked -
- Subscript -
- Superscript -
- Icon -
- PhoneLink -
- Reference -
New types of rules:
- -New functions:
- -Other features and improvements:
--
-
- Xpath query results can be appended into variables using
+(see more)
- - New XPath function ends-with -
- Lists can contain block elements such as paragraph, nested lists, tables and so on -
- Support for attribution in media captions (
<cite>tag)
- - Support for image links (
hrefattribute for the Image type)
- - Unsupported elements (such as an image inside the blockquote) now generate an error instead of moving up -
- Improved
@simplifyfunction for better processing RichText (e.g. saves line breaks formed by block elements)
-
Instant View Format
-An Instant View page is an object with the following properties:
-| Parameter | -Type | -Description | -
|---|---|---|
| title Required | -RichText | -Page title | -
| subtitle | -RichText | -Page subtitle | -
| kicker | -RichText | -Kicker | -
| author | -String | -Author name | -
| author_url | -Url | -Author link | -
| published_date | -Unixtime | -Date published | -
| description | -String | -A short description (used in link preview) | -
| image_url | -Url | -Link preview photo (used in link preview) | -
| document_url | -Url | -Link preview document (used in link preview) | -
| site_name | -String | -Name of website (used in link preview) | -
| channel | -String | -The username of the article author's (or the originating website's) channel on Telegram in the format @username |
-
| cover | -Media (Image/Video/Embed/Map) | -Page cover | -
| body Required | -Article | -Page content | -
RTL support
-The platform supports right-to-left languages. If <html> tag or tag referenced by body property has the attribute dir="rtl", the page will be marked as RTL. In case this attribute is not set, you can set it manually to display the page in Instant View as RTL using the following rule:
@set_attr(dir, "rtl"): $body # if body is already defined
- @set_attr(dir, "rtl"): /html # alternative waySupported types
-The IV page object can hold the following types:
-| Type | -Allowed children | -Description | -HTML counterpart | -
|---|---|---|---|
| Article | -Header Subheader Paragraph Preformatted Divider Anchor List Blockquote Pullquote Media Image Video Audio Embed Slideshow Table Details Footer RelatedArticles |
-Page content | -<article> |
-
| Header | -RichText | -Major heading | -We use the top-level of the <h1> – <h4> headings found on the source page |
-
| Subheader | -RichText | -Minor heading | -We use the remaining headings <h1> – <h4> as well as <h5> – <h6> headings |
-
| Paragraph | -RichText | -A paragraph | -<p> |
-
| Preformatted | -RichText | -Preformatted text | -<pre> with the optional attribute data-language* |
-
| Anchor | -– | -Anchor | -<anchor> with the attribute name that contains the anchor name |
-
| Divider | -– | -A separator | -<hr> |
-
| List | -ListItem | -A list | -<ul> for a bullet list, <ol> for a numbered list |
-
| ListItem | -version 1.0: RichText version 2.0: Header Subheader Paragraph Preformatted Divider Anchor List Blockquote Pullquote Media Image Video Audio Embed Slideshow Table Details |
-A list item | -<li> |
-
| Blockquote | -RichText QuoteCaption |
-A block quote | -<blockquote> |
-
| Pullquote | -RichText QuoteCaption |
-A pull quote | -<aside> |
-
| QuoteCaption | -RichText | -Caption of a quote | -<cite> |
-
| Media | -Image Video Audio Embed Map MediaCaption |
-Media content | -<figure> |
-
| Image | -– | -An image | -<img> with the attribute src and the optional attribute href to make the image clickable. Allowed formats: GIF, JPG, PNG (GIF would be converted into Video type by IV)As of version 2.1, supports the attribute srcset (srcset has higher priority than src, the same as in a browser; IV gets the highest available resolution under 2560px). |
-
| Video | -– | -A video | -<video> with the attribute src, or containing the tag <source type="video/mp4"> with the attribute src |
-
| Audio | -– | -An audio | -<audio> with the attribute src, or containing the tag <source> with the attribute src and the attribute type (possible types: audio/ogg, audio/mpeg, audio/mp4) |
-
| Embed | -– | -An embedded element | -<iframe> with the attribute src. List of supported embeds |
-
| Map | -– | -A map | -<img> or <iframe> with the attribute src referring to Google or Yandex maps |
-
| Slideshow | -Media (Image/Video) Image Video MediaCaption |
-A slideshow | -<slideshow> |
-
| MediaCaption | -RichText | -Media caption | -<figcaption>As of IV 2.0, can contain an additional tag <cite> with attribution (author, creator or source of the media) |
-
| Table | -TableCaption TableRow |
-A table | -<table> |
-
| TableCaption | -RichText | -A table caption | -<caption> |
-
| TableRow | -TableCell | -A table row | -<tr> with the optional attributes align, valign, can be wrapped with <thead> or <tbody> or <tfoot> with the optional attributes align, valign |
-
| TableCell | -RichText | -A table cell | -<td> for a standard cell, <th> for a header cell, with the optional attributes align, valign, colspan, rowspan |
-
| Details (version 2.0+) |
-DetailsHeader Header Subheader Paragraph Preformatted Divider Anchor List Blockquote Pullquote Media Image Video Audio Embed Slideshow Table Details |
-A collapsible block | -<details> with the optional attribute open to be opened by default |
-
| DetailsHeader (version 2.0+) |
-RichText | -A visible heading for the collapsible block | -<summary> |
-
| RelatedArticles | -Header Link |
-Related articles | -<related> containing one of <h1> – <h6> tag as header of the block and <a> tags with the attribute href containing a URL of related article. Note: Only articles that have an IV will appear in this block on the IV page. |
-
| Footer | -RichText | -The footer | -<footer> |
-
| RichText | -Bold Italic Underline Strike Fixed Marked Subscript Superscript Icon Link EmailLink PhoneLink LineBreak Anchor Reference String |
-Formatted text | -Text elements and supported tags | -
| Bold | -RichText | -Bold text | -<b> or <strong> |
-
| Italic | -RichText | -Italic text | -<i> or <em> |
-
| Underline | -RichText | -Underlined text | -<u> or <ins> |
-
| Strike | -RichText | -Strikethrough text | -<s> or <del> or <strike> |
-
| Fixed | -RichText | -Monospace text | -<code> or <kbd> or <samp> or <tt> |
-
| Marked | -RichText | -Marked text | -<mark> |
-
| Subscript | -RichText | -Subscript text | -<sub> |
-
| Superscript | -RichText | -Superscript text | -<sup> |
-
| Icon | -– | -A small image inside the text | -<pic> with the attribute src, width, height. Can contain the attribute optional if the image is not important and may be ignored. Allowed formats: JPG, PNG.As of version 2.1, supports the attribute srcset (srcset has higher priority than src, the same as in a browser). |
-
| Link | -RichText | -A link | -<a> with the attribute href containing a URL |
-
| EmailLink | -RichText | -A link to an email address | -<a> with the attribute href containing a mailto: link |
-
| PhoneLink | -RichText | -A link to a phone number | -<a> with the attribute href containing a tel: link |
-
| Reference | -RichText | -A reference | -<reference> with the attribute name that contains the reference name |
-
| LineBreak | -– | -Line break | -<br> |
-
Note on code languages
-Telegram apps currently do not support code highlighting, but they will in the future. For this reason, it is advisable to include the code language attribute (data-language) for large <pre> blocks if it is supplied in the source.
-
Types of Rules
-Instant View rules are instructions that tell our IV bot where to find the meta-elements on the source page and how it should modify the content of the page when an Instant View page is created.
-Each new line in a template describes a new rule. When the bot renders a page into the Instant View format, it applies rules from the relevant template one after another and ignores any empty lines. You can leave comments by starting a line with #, all following text on that line will be ignored unless enclosed in quote marks. You can use the \ symbol to carry a rule over to the next string, like this:
# Comment
-# You can break up \
- a long rule into \
- multiple stringsMost rules are based on XPath 1.0 expressions used to locate the required nodes on the source page.
-A block of rules may have a name. In this case, it can be reused in other rules.
-We support the following types of rules:
-Conditions
-Conditions offer unlimited flexibility for your templates. Rules of this type begin with the symbols ? or ! and use the following format:
?condition: xpath_query # condition example
-!condition: regexp # parameter on the right depends on the type of the condition
-?condition # some conditions don't have parametersGroups of conditions that immediately follow one another are interpreted as a block. ?-rules follow the OR logic when joined, while !-rules follow the AND logic. This means that for the bot to apply each block, all !-conditions in the block and at least one of the ?-conditions within it must be met. This also means that each block must have at least one ?-condition.
Blocks of conditions split your rule set into groups. Groups of rules that do not have any conditions are always applied. All other groups are only applied if their conditions are met.
-Examples
-# If a rule is placed here, it will be applied
-# Same with the one here
-
-?false # This condition is always false
-# The rule placed here will never be applied, because the condition is not met
-# Very useful indeed
-
-?exists: //article # This condition is true if the page has an article tag
-# On these lines, a new group of rules is located, and it will be applied if
-# there's an article tag on the page, despite the ?false condition above
-
-?exists: //article
-?exists: //div[@id="article"]
-!exists: //meta[@property="og:title"]
-# The rules below this block will be applied if an <article> tag or a
-# <div id="article"> can be found, this tag must also be present: <meta property="og:title">--Check out the Supported Conditions to see what works out of the box »
-
Properties
-Properties are the building blocks for your IV page. Check the Instant View Format for a list of properties that can be used when creating IV pages (you can also define custom properties, but they will not be used anywhere on the resulting IV page). Use this format to fill properties:
-property: xpath_query
-property: "Some string"
-property: nullProperties store the first node that matches the XPath expression xpath_query. By default, if a property already has a value, it will not be overwritten. You can change this behavior by adding ! to the property name – in this case a new non-empty value can be assigned. If you add !! to the property name, even an empty new value can be assigned to the property.
You can also assign a string to the property instead of the xpath_query. In this case, the property will contain a text element with the specified text. It is also possible to assign null to discard the property's value (will only work with !!).
Examples
-title: //article//h1 # Looking for the 'title' in the article heading
-title: //h1 # If not found, checking for any headings at all
-title: //head/title # If no luck either, trying the <title> tag
-?path: /blog/.* # On pages in the /blog/ section
-title!: //div[@id="title"] # we prefer to use <div id="title">, if present
-?path: /news/.* # On pages in the /news/ section
-title!!: //h3 # title is always in an h3 tag
-
-author: //article/@author # Get author name from the author attribute
-?exists: //article[has-class("anonymous")]
-author!!: null # Don't display author for anonymous posts--Reminder: The title and body properties are required for an IV page to be created.
-
Variables
-Variables are useful for storing and manipulating nodes before assigning them to properties for the final IV page. Variable names begin with the $ symbol. Use this format to initialize them:
$variable: xpath_query
-$variable: "Some text"
-$variable: nullVariables store a list of nodes that match the Xpath expression xpath_query. If a variable is assigned for the second time, its previous value is overwritten. You can change this behavior by adding ? to the variable name. You can also append a list of nodes to the previous one by adding + to the variable name.
You can also assign a string to the variable instead of the xpath_query. In this case, the variable will contain a list with one text element that has the specified text. It is also possible to assign null to discard the variable's value.
Examples
-$images: //img
-$images: //img[@src] # the previous value will be overwritten
-$images?: //article//img # a new value will only be assigned if the variable is empty
-$medias: //img
-$medias+: //video # now $medias contains all img and video tagsOptions
-Options affect how the page is processed by the bot. Options begin with the ~ symbol. Use this format to set them:
~option: "value"
-~option: trueOptions can be set with values in JSON format.
-Examples
-~version: "2.1"--Check out Supported Options to see what else works out of the box.
-
Functions
-Functions are extremely flexible, but you'll probably mostly use them to strip unnecessary nodes from the page and to replace certain elements with others. Function names begin with the @ symbol, you can use the following format:
@function: xpath_query # a function without parameters
-@function(param): xpath_query # additional parameters are placed in paretheses
-@function(p1 p2): xpath_query # a function with two parameters
-@function(p1, "param #2"): xpath_query # parameters can be separated by commas
- # and enclosed in quote marks when needed
-@function: "Some text" # use string instead of xpath_query if neededThe main argument of a function is a list of nodes that match the Xpath expression xpath_query. You can also use a string as the main argument instead of an xpath_query. In this case, the main argument passed to the function will be a list with one text element that has the specified text.
Examples
-@remove: //header # removes all <header> tags found on the page
-@replace_tag(<h1>): //div[@class="header"] # replaces all <div class="header"> tags with <h1>
-<h1>: //div[@class="header"] # an alias for @replace_tag(<h1>)Note: You may find the @debug function particularly useful when creating XPath expressions.
---Check out Supported Functions to see what else works out of the box.
-
Block Functions
-Block functions manipulate blocks of rules. Block function names also begin with the @ symbol, you can use the following format:
@function(xpath_query) { # opening bracket should be at the end of the line
- $variable: xpath_query # some other rules here
- @function: $@ # inside the block function
-} # closing bracket should be on a separate lineA block function can contain another block function so they can be nested. Block function can not contain conditions.
---Please note that block functions that execute a block of rules several times (map, repeat, while, while_not) have a limit on the total number of iterations for the entire template.
-
Examples
-@if( //article ) { # if <article> exists
- @append(<p>): $$ # append paragraph into it
-}--Check out Supported Block Functions to see what else works out of the box.
-
Include
---Note: This is a service rule, it will not work in your templates. It was included in this reference to give you a better understanding of how the system works. You can see an example of this rule at work in the Processing Pages section.
-
Rules of this type begin with the + symbol and use the following format:
+ rulesThis rule inserts a block of rules with the specified name. In most cases, the name corresponds to the domain to which the rules apply.
-Examples
-+ core.telegram.org # inserting the block of rules that is used for core.telegram.org
-?not_exists: $body
-+ telegram.org # inserting the block of rules that is used for telegram.orgSpecial variables $$ and $@
-The special variables work within a group of rules.
--
-
- The
$$variable always contains the result of the most recent XPath query.
- - The
$@variable holds the return of the most recently run function.
-
These variables come in handy when you're creating chains of rules. If a rule is missing xpath_query, the statement is considered to be equal to $$.
Examples
-# Put a picture into a <figure> tag, then set it as the cover
-@wrap(<figure>): //img[@id="cover"]
-cover: $@
-
-# Insert a divider before each div.divider that's no longer required
-@before(<hr>): //div[has-class("divider")]
-@remove # this is the same as @remove: $$Extended XPath
-For your convenience, you can use the following constructs in your XPath expressions.
-Context
-Regular XPath queries search for nodes in the context of the entire document. To specify the context for a particular expression, you can use variables in the format $context. If a matching variable exists, the query will be made relative to each variable node. If it doesn't and a matching property exists, the query will be made relative to the property node. If no matching variables or properties exist, the query return an empty list.
Examples
-$headers: //h1 # all <h1> tags on the page
-article: //article # the first <article> tag on the page
-$art_headers: $article//h1 # all <h1> tags inside article
-$header_links: $art_headers//a # all <a> tags inside each $art_headers nodeZeroing in on nodes
-The result of an XPath query is always a list of matching nodes. If you'd like to narrow the list down to a single node, you can use the following syntax: (xpath_query)[n], where n is the number of the desired node. Numbering starts at 1, you can get the last node by using the last() function. This syntax can only be applied to the entire expression.
Examples
-$headers: //h1 # all <h1> tags on the page
-$header2: (//h1)[2] # the second <h1> tag on the page
-$header2: ($headers)[2] # same
-$last_link: ($header2//a)[last()] # the last link inside $header2has-class
-You will often need to locate nodes that have a certain class. To do this, you can use the has-class("class") function that serves as an alias for the expression contains(concat(" ", normalize-space(@class), " "), " class ").
Examples
-# Transform all div.header elements into h1
-<h1>: //div[contains(concat(" ", normalize-space(@class), " "), " header ")]
-# same idea, but much shorter
-<h1>: //div[has-class("header")]ends-with
-XPath has a starts-with function that checks whether the first string starts with the second string but does not have ends-with. In IV you can use the ends-with("haystack","needle") function that serves as an alias for the expression (substring("haystack", string-length("haystack") - string-length("needle") + 1) = "needle").
Examples
-# Select all JPG images
-@debug: //img[(substring(@src, string-length(@src) - string-length(".jpg") + 1) = ".jpg")]
-# the same, but much shorter
-@debug: //img[ends-with(@src, ".jpg")]prev-sibling
-An axis that selects the previous sibling of the current node. Serves as an alias for the expression preceding-sibling::*[1]/self.
Examples
-# Transform all div nodes, that immediately follow img nodes into figcaption
-<figcaption>: //div[./preceding-sibling::*[1]/self::img]
-# the same
-<figcaption>: //div[./prev-sibling::img]next-sibling
-An axis that selects the next sibling of the current node. Serves as an alias for the expression following-sibling::*[1]/self
Examples
-# Join paragraphs following each other into one, separating them with a line break
-@combine(<br>): //p/following-sibling::*[1]/self::p
-# the same, but shorter
-@combine(<br>): //p/next-sibling::pSupported conditions
-Below are conditions supported in Instant View rules.
-domain
-domain: regexpChecks whether the domain of the current page matches a regular expression. The check is case-insensitive, so the actual expression used will look like this: /^regexp$/i.
Examples
-# Rule for *.subdomain.example.com URLs
-?domain: .+\.subdomain\.example\.comdomain_not
-domain_not: regexpChecks whether the domain of the current page does not match a regular expression. The check is case-insensitive, so the actual expression used will look like this: /^regexp$/i.
Examples
-# Rule for *.subdomain.example.com URLs with an exception for dev.subdomain.example.com
-?domain: .+\.subdomain\.example\.com
-!domain_not: dev\.subdomain\.example\.compath
-path: regexpChecks whether the path to the current page matches a regular expression. The check is case-insensitive, so the actual expression used will look like this: /^regexp$/i.
Examples
-# Rule for example.com/news/* links
-?path: /news/.+ # no need to escape the slashpath_not
-path_not: regexpChecks whether the path to the current page does not match a regular expression. The check is case-insensitive, so the actual expression used will look like this: /^regexp$/i.
Examples
-# Rule for example.com/news/* links with an exception for example.com/news/recent
-?path: /news/.+
-!path_not: /news/recentexists
-exists: xpath_queryChecks whether target nodes exist on the current page.
-Examples
-# Apply rule only to pages with an <article> tag
-?exists: //articlenot_exists
-not_exists: xpath_queryChecks whether target nodes do not exist on the current page.
-Examples
-# Apply rule only to pages with an <article> tag, that do not include any quotes.
-?exists: //article
-!not_exists: //article//blockquotetrue
-trueA condition that is always true.
-Examples
-?path: /blog/.+
-# Rules for the blog section go here
-?true
-# Rules that go here will be applied to all pagesfalse
-falseA condition that is always false.
-Examples
-?path: /news/.+
-# Rules for the news section go here
-?false
-# Rules that go here will never be appliedSupported options
-Below are options supported in Instant View rules.
-version
-~version: "2.1"Sets the version of IV used in the template. The behavior of some IV functions may change according to the version provided (see the manual of corresponding function).
The value must be one of "1.0", "2.0" or "2.1". We recommend using the latest version, 2.1.
Examples
-~version: "2.1"
-# Now you can use new features from IV 2.1--Please note that
-versionshould be set at the beginning of the template before any other rules.
allowed_origin NEW
-~allowed_origin: "https://example.com"
-~allowed_origin: ["https://example.com", "https://subdomain.example.com"]Sets the origin (or the list of origins) from which content can be loaded using the @load and @inline functions.
The value should be String or Array of String.
Examples
-~allowed_origin: "https://api.example.com"
-# Now you can load content from https://api.example.com regardless of the origin of current page
-@load: "https://api.example.com/get/article"Supported functions
-The general format for a function is the following:
-@function: xpath_queryEach function accepts the list of nodes returned by the XPath statement as the main parameter. You may omit xpath_query, in which case $$, the result of the previous XPath query, will be passed into the function. The function then processes each element in the list and returns a list of transformed nodes which are stored in the $@ variable.
Below is a list of functions that are supported in Instant View rules.
-debug
-@debug: xpath_queryLogs the elements passed into the function, these elements will be displayed in the status line at the bottom of the screen in the Instant View Editor. Returns the elements passed. Consider combining with $$ and $@.
Example
-@debug: //article//a # displays all links from the page in the log
-@debug # displays all links againLook for debug output at the bottom of your Editor:
-remove
-@remove: xpath_queryRemoves target nodes from the page, returns an empty list.
-Examples
-@remove: //div[has-class("related")] # remove article div.related
-@debug # empty listappend
-@append("Some text"): xpath_query
-@append(@attr): xpath_query
-@append(<tag>): xpath_query
-@append(<tag>, attr, value[, attr, value[, ...]]): xpath_queryInserts content, specified by the parameter, to the end of each target node.
--
-
- If the first parameter is in angle brackets, a new
<tag>node will be created. The following two parameters then specify the name and value of an attribute for that node. Ifvaluehas the format@attr, the value of the attributeattrin the target node will be used as the value.valuecan be an XPath expression that begins with., in this case the query will be executed relative to the relevant node, and the text value of the returned elements will be used as the attribute's value. Otherwise,valuewill be used as the attribute's value.
- - If the first parameter has the format
@attr, a new text element with value of the attributeattrof the targeted node will be created.
- - Otherwise, a text element with the text specified in the first parameter will be created. -
Returns a list of the newly created nodes.
-Examples
-# <div class="a"><em>1</em></div>
-@append(<p>): //div
-# <div class="a"><em>1</em><p></p></div>prepend
-@prepend("Some text"): xpath_query
-@prepend(@attr): xpath_query
-@prepend(<tag>): xpath_query
-@prepend(<tag>, attr, value[, attr, value[, ...]]): xpath_queryInserts content, specified by the parameter, to the beginning of each target node.
--
-
- If the first parameter is in angle brackets, a new
<tag>node will be created. The following two parameters then specify the name and value of an attribute for that node. Ifvaluehas the format@attr, the value of the attributeattrin the target node will be used as the value.valuecan be an XPath expression that begins with., in this case the query will be executed relative to the relevant node, and the text value of the returned elements will be used as the attribute's value. Otherwise,valuewill be used as the attribute's value.
- - If the first parameter has the format
@attr, a new text element with value of the attributeattrof the targeted node will be created.
- - Otherwise, a text element with the text specified in the first parameter will be created. -
Returns a list of the newly created nodes.
-Examples
-# <div class="a"><em>1</em></div>
-@prepend(<p>, data-class, @class): //div
-# <div class="a"><p data-class="a"></p><em>1</em></div>after
-@after("Some text"): xpath_query
-@after(@attr): xpath_query
-@after(<tag>): xpath_query
-@after(<tag>, attr, value[, attr, value[, ...]]): xpath_queryInserts content, specified by the parameter, after each target node.
--
-
- If the first parameter is in angle brackets, a new
<tag>node will be created. The following two parameters then specify the name and value of an attribute for that node. Ifvaluehas the format@attr, the value of the attributeattrin the target node will be used as the value.valuecan be an XPath expression that begins with., in this case the query will be executed relative to the relevant node, and the text value of the returned elements will be used as the attribute's value. Otherwise,valuewill be used as the attribute's value.
- - If the first parameter has the format
@attr, a new text element with value of the attributeattrof the targeted node will be created.
- - Otherwise, a text element with the text specified in the first parameter will be created. -
Returns a list of the newly created nodes.
-Examples
-# <div class="a"><em>1</em><em>2</em></div>
-@after("!"): //div/em
-# <div class="a"><em>1</em>!<em>2</em>!</div>before
-@before("Some text"): xpath_query
-@before(@attr): xpath_query
-@before(<tag>): xpath_query
-@before(<tag>, attr, value[, attr, value[, ...]]): xpath_queryInserts content, specified by the parameter, before each target node.
--
-
- If the first parameter is in angle brackets, a new
<tag>node will be created. The following two parameters then specify the name and value of an attribute for that node. Ifvaluehas the format@attr, the value of the attributeattrin the target node will be used as the value.valuecan be an XPath expression that begins with., in this case the query will be executed relative to the relevant node, and the text value of the returned elements will be used as the attribute's value. Otherwise,valuewill be used as the attribute's value.
- - If the first parameter has the format
@attr, a new text element with value of the attributeattrof the targeted node will be created.
- - Otherwise, a text element with the text specified in the first parameter will be created. -
Returns a list of the newly created nodes.
-Examples
-# <div class="a"><em>1</em></div>
-@before("@"): //div/em
-# <div class="a">@<em>1</em></div>append_to
-@append_to(xpath_query): xpath_query
-@append_to($var): xpath_queryInserts each target node to the end of the base node.
-The first parameter specifies the base node. You can pass an XPath expression that begins with ., in this case the query will be executed relative to the relevant node. The first relevant node will be used as the base node. You can also pass a variable name. If such a variable exists, the first relevant node will be used as the base node. If the variable doesn't exist or is empty, the property with a matching name will be used as the base node.
Returns a list of target nodes.
-Examples
-$div: //div
-# <div class="a"><em></em></div><p>Text</p>
-@append_to($div): //p
-# <div class="a"><em></em><p>Text</p></div>prepend_to
-@prepend_to(xpath_query): xpath_query
-@prepend_to($var): xpath_queryInserts each target node to the beginning of the base node.
-The first parameter specifies the base node. You can pass an XPath expression that begins with ., in this case the query will be executed relative to the relevant node. The first relevant node will be used as the base node. You can also pass a variable name. If such a variable exists, the first relevant node will be used as the base node. If the variable doesn't exist or is empty, the property with a matching name will be used as the base node.
Returns a list of target nodes.
-Examples
-$div: //div
-# <div class="a"><em></em></div><p>Text</p>
-@prepend_to($div): //p
-# <div class="a"><p>Text</p><em></em></div>after_el
-@after_el(xpath_query): xpath_query
-@after_el($var): xpath_queryInserts each target node after the base node.
-The first parameter specifies the base node. You can pass an XPath expression that begins with ., in this case the query will be executed relative to the relevant node. The first relevant node will be used as the base node. You can also pass a variable name. If such a variable exists, the first relevant node will be used as the base node. If the variable doesn't exist or is empty, the property with a matching name will be used as the base node.
Returns a list of target nodes.
-Examples
-$div: //div
-# <div class="a"><p>Text</p><em></em></div>
-@after_el("./../self::div"): //p
-# <div class="a"><em></em></div><p>Text</p>before_el
-@before_el(xpath_query): xpath_query
-@before_el($var): xpath_queryInserts each target node before the base node.
-The first parameter specifies the base node. You can pass an XPath expression that begins with ., in this case the query will be executed relative to the relevant node. The first relevant node will be used as the base node. You can also pass a variable name. If such a variable exists, the first relevant node will be used as the base node. If the variable doesn't exist or is empty, the property with a matching name will be used as the base node.
Returns a list of target nodes.
-Examples
-$div: //div
-# <div class="a"><p>Text</p><em></em></div>
-@before_el("./../self::div"): //p
-# <p>Text</p><div class="a"><em></em></div>replace_tag
-@replace_tag(<tag>): xpath_query
-<tag>: xpath_queryChanges the name of the tag. The new name for the tag should be passed as the first parameter. Returns target nodes.
-Examples
-# <div class="list unordered"><div class="item"></div><div class="item"></div></div>
-@replace_tag(<li>): //div[has-class("item")]
-<ul>: //div[has-class("list")]
-# <ul class="list unordered"><li class="item"></li><li class="item"></li></ul>wrap
-@wrap(<tag>): xpath_queryWrap each target node in the <tag> tag. Returns a list of the new <tag> elements.
Examples
-# <em>1</em><em>2</em>
-@wrap(<b>): //em
-# <b><em>1</em></b><b><em>2</em></b>
-@wrap(<u>)
-# <b><u><em>1</em></u></b><b><u><em>2</em></u></b>
-@wrap(<p>): $@
-# <b><p><u><em>1</em></u></p></b><b><p><u><em>2</em></u></p></b>wrap_inner
-@wrap_inner(<tag>): xpath_queryWrap an HTML structure around the content of each target node in the <tag> tag. Returns a list of new <tag> elements.
Examples
-# <p>H<sub>2</sub>0</p>
-@wrap_inner(<b>): //p
-# <p><b>H<sub>2</sub>0</b></p>clone
-@clone: xpath_queryCreates a copy of each target node. Returns a list of the newly created nodes.
-Examples
-# <p class="text">Paragraph</p>
-@clone: //p
-# <p class="text">Paragraph</p><p class="text">Paragraph</p>detach
-@detach: xpath_querySeparates the target node from the rest in the parent tag. Creates a copy of the parent tag and wraps the target node into this new instance. Returns a list of parent tags that contain target nodes.
-Examples
-# <a href="#1">
-# <b>1</b>
-# <p>Link #1</p>
-# </a>
-# <a href="#2">
-# <b>2</b>
-# <p>Link #2</p>
-# </a>
-
-@detach: //a/b
-
-# <a href="#1">
-# <b>1</b>
-# </a>
-# <a href="#1">
-# <p>Link #1</p>
-# </a>
-# <a href="#2">
-# <b>2</b>
-# </a>
-# <a href="#2">
-# <p>Link #2</p>
-# </a>
-
-@after(<br>): $@
-
-# <a href="#1">
-# <b>1</b>
-# </a><br>
-# <a href="#1">
-# <p>Link #1</p>
-# </a>
-# <a href="#2">
-# <b>2</b>
-# </a><br>
-# <a href="#2">
-# <p>Link #2</p>
-# </a>split_parent
-@split_parent: xpath_querySplits the parent tag by the target node. Places preceding siblings wrapped into parent element before the target node. Places following siblings wrapped into parent element placed after target node.
-Returns a list of target nodes.
-Examples
-# <p class="text">
-# <b>First</b> line
-# <figure><img src="photo.jpg"></figure>
-# <i>Second</i> line
-# </p>
-@split_parent: //p/figure
-# <p class="text">
-# <b>First</b> line
-# </p>
-# <figure><img src="photo.jpg"></figure>
-# <p class="text">
-# <i>Second</i> line
-# </p>pre
-@pre: xpath_querySpecifies that the text inside the target node is already formatted. Returns a list of matching nodes.
-Examples
-# <p> Some text , </p>
-# <p> Some another text </p>
-@pre: (//p)[1]
-# Result in the Instant View page:
-# Some text ,
-# Some another textset_attr
-@set_attr(attr, value): xpath_query
-@set_attr(attr, @attr): xpath_query
-@set_attr(attr, "Some text"): xpath_query
-@set_attr(attr, "Some text", @from-attr, ...): xpath_querySets an attribute in each matching node. The name of the attribute is passed in the first parameter. The value of the attribute is the rest of the parameters concatenated.
-If value has the format @attr, the value of the attribute attr of the target node will be used as the value. value can be an XPath expression that begins with ., in this case the query will be executed relative to the relevant node, and the text value of the returned elements will be used as the attribute's value. Otherwise, value will be used as the attribute's value.
Returns a list of attribute nodes.
-Examples
-# <p class="a"></p>
-@set_attr(data-class, @class)
-# <p class="a" data-class="a"></p>
-@set_attr(id, @class, "_", ./@data-class)
-# <p class="a" data-class="a" id="a_a"></p>set_attrs
-@set_attrs(attr, value): xpath_query
-@set_attrs(attr, value[, attr, value[, ...]]): xpath_querySets multiple attributes for each of the target nodes. Each two parameters specify the name and value for the new attributes.
-If value has the format @attr, the value of the attribute attr of the target node will be used as the value. value can be an XPath expression that begins with ., in this case the query will be executed relative to the relevant node, and the text value of the returned elements will be used as the attribute's value. Otherwise, value will be used as the attribute's value.
Returns a list of the matching nodes.
-Examples
-# <p class="a"></p>
-@set_attrs(data-class, @class, id, "a_a"): //p
-# <p class="a" data-class="a" id="a_a"></p>match
-@match(regexp): xpath_query
-@match(regexp, match_index): xpath_query
-@match(regexp, match_index, modifiers): xpath_queryPerforms a search based on a regular expression. Replaces the content of the target node with the search result. The second parameter specifies the number of the captured parenthesized subpattern. If this is not specified, the text that matched the full pattern will be used. You can specify modifiers for the regular expression using the optional parameter (ims modifiers are supported).
-Returns a list of target nodes. As of IV 2.1, returns a list of target nodes the content of which matched the regular expression.
-Examples
-# <p class="plainText">Hello, world!</p>
-@match("[a-z]+!"): //p
-# <p class="plainText">world!</p>
-@match("([a-z]+)!", 1): //p/text()
-# <p class="plainText">world</p>
-@match("..t", 0, "i"): //p/@class
-# <p class="inT">Bye, world!</p>
-
-# <ul><li>a1</li><li>a</li><li>21b</li><li>.</li></ul>
-@match("[0-9]+"): //ul/li
-# <ul><li>1</li><li></li><li>21</li><li></li></ul>
-@debug: $@
-# Debug 2 nodes:
-# [0]: <li>1</li>
-# [1]: <li>21</li>replace
-@replace(regexp, replacement): xpath_query
-@replace(regexp, replacement, modifiers): xpath_queryPerforms a search and replace operation using the regular expression. You can specify modifiers for the regular expression using the optional parameter (ims modifiers are supported).
-Returns a list of target nodes. As of IV 2.1, returns a list of target nodes the content of which was replaced by the regular expression.
-Examples
-# <p class="text">Hello, world!</p>
-@replace("Hello", "Goodbye"): //p/text()
-# <p class="text">Goodbye, world!</p>
-@replace(".t$", "mp"): //p/@class
-# <p class="temp">Goodbye, world!</p>
-@replace("goodb", "B", "i"): //p/text()
-# <p class="temp">Bye, world!</p>
-
-# <ul><li>a1</li><li>a</li><li>21b</li><li>.</li></ul>
-@replace("[0-9]+", "($0)"): //ul/li
-# <ul><li>a(1)</li><li>a</li><li>(21)b</li><li>.</li></ul>
-@debug: $@
-# Debug 2 nodes:
-# [0]: <li>a(1)</li>
-# [1]: <li>(21)b</li>urlencode
-@urlencode: xpath_queryEncodes the content of the target node as per RFC 3986. Returns target nodes.
-Examples
-# <a href="https://telegram.org">link</a>
-$a: //a
-@urlencode: $a/@href
-# <a href="https%3A%2F%2Ftelegram.org">link</a>
-@set_attr(href, "/?url=", @href): $a
-# <a href="/?url=https%3A%2F%2Ftelegram.org">link</a>urldecode
-@urldecode: xpath_queryDecodes the content of the target node as per RFC 3986. Returns target nodes.
-Examples
-# <a href="/?url=https%3A%2F%2Ftelegram.org">link</a>
-$a: //a
-@match("^/\?url=(.+)$", 1): $a/@href
-# <a href="https%3A%2F%2Ftelegram.org">link</a>
-@urldecode
-# <a href="https://telegram.org">link</a>htmlencode
-@htmlencode: xpath_queryConvert special characters in the target node to HTML entities. Returns the target nodes.
-Examples
-# <p><b>Some text<\b></p>
-@htmlencode: //p
-# <p>&lt;b&gt;Some text&lt;\b&gt;</p>htmldecode
-@htmldecode: xpath_queryConvert special HTML entities in the target node back to characters. Returns the target nodes.
-Examples
-# <p>&lt;b&gt;Some text&lt;\b&gt;</p>
-@htmldecode: //p
-# <p><b>Some text<\b></p>style_to_attrs
-@style_to_attrs(css_prop, attr): xpath_query
-@style_to_attrs(css_prop, attr[, css_prop, attr[, ...]]): xpath_queryGets a value of a CSS property from the style attribute and sets it into an attribute for each of the target nodes. Each two parameters specify the name for the new attribute and the name of CSS property. Returns a list of matching nodes.
-Examples
-# <img style="width: 20px; height: 20px">
-@style_to_attrs(width, data-width, height, data-height): //img
-# <img style="width: 20px; height: 20px" data-width="20" data-height="20">background_to_image
-@background_to_image: xpath_queryTransforms the target node with a background picture into an <img> tag with an src attribute. The target node must contain a style attribute with the background. Returns a list of transformed nodes.
Examples
-# <div class="bg_image" style="background-image:url(image.jpg)"></div>
-@background_to_image: //div[has-class("bg_image")]
-# <img src="image.jpg">json_to_xml
-@json_to_xml: xpath_queryTransforms the content of the target node to the XML format. The contents must be in valid JSON format. The resulting XML tree will be inserted into the document. Returns the root element of the XML tree.
-Examples
-# <div data-var='{"a":1,"b":[1,2],"c":{"p":"Hello!"}}'></div>
-@json_to_xml: //div/@data-var
-@debug: $@
-# <xml><a>1</a><b><item>1</item><item>2</item></b><c><p>Hello!</p></c></xml>html_to_dom
-@html_to_dom: xpath_queryParse the content of the target node in HTML format and insert it into the document. Returns the root element of the inserted HTML tree.
-Examples
-# <div data-content="<b>Some text<\b>"></div>
-@html_to_dom: //div/@data-content
-@debug: $@
-# <dom><b>Some text</b></dom>combine
-@combine: xpath_query
-@combine(" - "): xpath_query
-@combine(<tag>): xpath_query
-@combine(<tag>[, " - "[, ...]]): xpath_queryCombines each target node with its preceding node if such a node exists. You can use parameters to specify nodes to be inserted above the target node. If the parameter is in angular brackets, a new <tag> node will be created. Otherwise a text element with the text specified by the parameter will be used.
Returns a list of nodes, preceding the target nodes.
-Examples
-# <pre>1 2 3</pre>
-# <pre> 4 5 </pre>
-# <pre>6 7 8</pre>
-@combine: //pre/following-sibling::*[1]/self::pre
-# <pre>1 2 3 4 5 6 7 8</pre>
-
-# <p>first</p>
-# <p>second</p>
-@combine(<br>, <br>): //p/following-sibling::*[1]/self::p
-# <p>first<br><br>second</p>
-
-# <h1>Title</h1>
-# <strong>Subtitle</strong>
-@combine(<br>, "\n"): //h1/following-sibling::*[1]/self::strong
-# <h1>Title<br>
-# Subtitle</h1>datetime
-@datetime(-2): xpath_query
-@datetime(-2, "en-US", "yyyy-MM-dd"): xpath_queryTransforms the date and time from the text of the target node into a unixtime timestamp. The parameter specifies the timezone of the original date and time.
-You can also pass a locale and a pattern to parse the date and time in more complicated cases. If a non-gregorian calendar is used, this needs to be specified in the locale. For example, "fa-IR@calendar=persian". Available patterns are documented here.
On success, returns a text element with the unixtime timestamp. Otherwise, returns the target element.
-Examples
-# <div id="date">1 January 2017, 15:04</div>
-@datetime(-2): //div[@id="date"]
-published_date: $@ # the property published_date will hold a unixtime timestamp
-
-# <time>دوشنبه, ۲۳ اسفند ۱۳۹۵</time>
-@datetime(0, "fa-IR@calendar=persian", "EEEE, dd MMMM yyyy"): //time
-published_date: $@ # the property published_date will hold a unixtime timestampsimplify
---Note: This is a service function. There is no reason for you to use it in your templates. It was included in this reference to give you a better understanding of how the system works (see the
-..afterblock).
@simplify: xpath_queryProcesses the target nodes according to the Instant View format. Returns the target nodes.
-Examples
-# <p><span><b>S</b>ome</span> <em>important</em> text!</p>
-@simplify: //p
-# <p><b>S</b>ome <em>important</em> text!</p>inline
-@inline: xpath_query
-@inline(silent): xpath_queryIf the target element is an <iframe> with the attribute src, the content of the iframe will be loaded. The target element will be replaced with the content of the iframe.
If the target node is an HTML-comment, a <comment> element with the content of the comment will be created. The comment will be replaced by the newly created node.
You can use silent parameter to ignore errors while processing this function. You will still see an error in the debug console, but the rules that come after will continue to execute.
Returns a list of replaced nodes.
---Note: The @inline function adheres to the same-origin policy. This means that the target and the inlined pages should have the same origin. You can specify additional allowed origins using the option ~allowed_origin
-
Examples
-# <p><iframe src="/subpage.html"></iframe></p>
-# /subpage.html:
-# <html><body><p>Hello!</p></body></html>
-@inline: //p/iframe
-# <p><html><body><p>Hello!</p></body></html></p>
-@debug
-# <html><body><p>Hello!</p></body></html>
-
-# <p><!--<b>Hello!</b>, world!--></p>
-@inline: //p/comment()
-# <p><comment><b>Hello!</b>, world!</comment></p>
-@debug
-# <comment><b>Hello!</b>, world!</comment>load NEW
-@load: "https://example.com"
-@load(silent): xpath_queryLoads the content of the URL. The URL can be specified as a string or be the content of the target node.
-You can use silent parameter to ignore errors while processing this function. You will still see an error in the debug console, but the rules that come after will continue to execute.
Returns the newly created node with loaded content.
---Note: The @load function adheres to the same-origin policy. This means that the target and the loaded pages should have the same origin. You can specify additional allowed origins using the option ~allowed_origin
-
Examples
-@append(<iframe> src "/subpage.html"): /html/body
-$iframe: $@
-@remove
-@inline: $iframe
-# the same, but much shorter
-@load: "/subpage.html"
-
-@load(silent): //meta[@property="api:url"]/@content
-# trying to load content from api:url
-@if ( $@ ) {
- # Do something with content
-}unsupported
-@unsupported: xpath_querySpecifies that the target node contains essential content that can't be represented in the Instant View format. Returns the target nodes.
-Examples
-# <p>See the graph below:</p>
-# <canvas class="article_graph" width="600" height="400"></canvas>
-@unsupported: //canvas[has-class("article_graph")]--Tip: It is important to identify that a page contains essential unsupported content — no IV page will be generated to ensure that the user never gets incomplete info from an article. The system will take care of the most popular cases in the
-..afterblock, but your template must cover everything that the system doesn't catch.
Supported block functions
-The general format for a block function is the following:
-@function(xpath_query) {
- # block of rules
-}Block functions usually accept the list of nodes returned by the XPath statement as a parameter. Depending on the function and its parameters, rules inside the block can be run several times or never. Block functions can contain any type of rules except conditions.
-Below is a list of block functions that are supported in Instant View rules.
-if
-@if(xpath_query) {
- # block of rules
-}Executes the block of rules if target nodes exist on the current page. If target nodes do not exist, the block of rules will be skipped. The $$ and $@ variables contain target nodes found by the XPath query.
Example
-@if( //div[has-class("blockquote")] ) { # if div.blockquote exists
- <blockquote>: $@ # change tag name to blockquote
- <cite>: $@//div[has-class("author")] # and mark div.author as a caption
-}if_not
-@if_not(xpath_query) {
- # block of rules
-}Executes a block of rules if target nodes do not exist on the current page. If such nodes exist, the block of rules will be skipped. The $$ and $@ variables contain target nodes found by the XPath query.
Example
-@if_not( $body//footer ) { # if footer does not exist
- @append(<footer>): $body # append it into body
-}map
-@map(xpath_query) {
- # block of rules
-}Executes a block of rules once per each target node found by the XPath query. At the beginning of each iteration, the following variables will be set:
--
-
$$will contain the target nodes found by XPath query;
-$@will contain the current target node;
-$indexwill contain the index of the current target node (starts with 1);
-$firstwill contain<true>if the current target node is the first in the list and an empty list otherwise;
-$middlewill contain<true>if the current target node is between the first and the last in the list, empty list otherwise;
-$lastwould contain<true>if the current target node is the last one in the list, empty list otherwise.
-
Example
-@map( //div[@id="list"]/p ) { # for each paragraph in list
- $p: $@ # store the current paragraph in $p variable
- @prepend_to($p): ". " # and
- @prepend_to($p): $index # number them starting with 1
-}--Please note that the
-@mapfunction should be used only if it is impossible to use regular functions with xpath queries (for example you need to use $index). Otherwise, regular functions are faster because they process several nodes at once.
Example
-# Bad way:
-@map( //div[has-class("image")] ) {
- $image: $@
- <cite>: $image//p/span
- <figcaption>: $image//p
- <figure>: $image
-}
-# The same result, but faster:
-$image: //div[has-class("image")]
-<cite>: $image//p/span
-<figcaption>: $image//p
-<figure>: $imagerepeat
-@repeat(n) {
- # block of rules
-}Executes a block of rules n times. At the beginning of each iteration, the following variables will be set:
--
-
$$and$@will contain the previous value of$$;
-$indexwill contain the index of the current iteration (starts with 1);
-$firstwill contain<true>if this is the first iteration, an empty list otherwise;
-$middlewill contain<true>if the current iteration is between the first and last, empty list otherwise;
-$lastwill contain<true>if this is the last iteration, empty list otherwise.
-
Example
-# appends "1, 2, 3, 4, 5" to $body
-@repeat( 5 ) {
- @append_to($body): $index
- @if_not( $last ) {
- @append_to($body): ", "
- }
-}while
-@while(xpath_query) {
- # block of rules
-}Executes a block of rules while target nodes exist on the current page. At the beginning of each iteration the following variables will be set:
--
-
$$and$@will contain target nodes found by XPath query;
-$indexwill contain the index of the current iteration (starts with 1);
-$firstwill contain<true>if it is the first iteration, an empty list otherwise.
-
Example
-@while( //iframe ) {
- @inline: $@ # inline all nested iframes
-}while_not
-@while_not(xpath_query) {
- # block of rules
-}Executes a block of rules while target nodes do not exist on the current page. At the beginning of each iteration the following variables will be set:
--
-
$$and$@will contain target nodes found by XPath query;
-$indexwill contain the index of the current iteration (starts with 1);
-$firstwill contain<true>if this is the first iteration, an empty list otherwise.
-
Example
-@while_not( //video ) { # if no video exists on the current page
- @inline: //iframe # try to inline iframes, maybe video is inside the frame
-}Embedded elements
-Instant View supports widgets from popular services. We display them as embedded elements or specially formatted quotes. The Instant View bot analyzes all iframes in the document body and generates a widget if the service is supported.
---Some popular widgets do not use iframes. Note that the
-..afterblock of rules contains rules to transform such widgets to an Instant View compatible format.
We currently support the following services:
--
-
- Youtube -
- Vimeo -
- Tweets & Twitter Videos -
- Facebook Posts & Videos -
- Giphy -
- SoundCloud -
- GithubGist -
- Aparat -
- VK.com Videos -
Processing pages
-All pages are processed according to the following rules:
-# Url: http://example.com/some_page.html
-+ example.com
-?true
-+ ..afterIf a page is on a third-level domain and above, the following rules are applied:
-# Url: http://some.subdomain.example.com/some_page.html
-+ some.subdomain.example.com
-?not_exists: $body
-+ subdomain.example.com
-?not_exists: $body
-+ example.com
-?true
-+ ..afterIn other words, at first the bot attempts to use a block of rules that features the full domain name. If such a block does not exist, the bot checks for the next level up to the second-level domain.
-..after is a special block of rules that is applied to all pages irrespective of the domain name.
Working with subdomains
-If the page is on a third-level domain or higher, you need to manually select the domain level to which your template will apply. Use this menu in the top left corner of the page:
--
Choose a level that hosts pages with the same structure, so that your rules are relevant to all the matching pages on this domain.
---For example, use
-wikipedia.orgto create an IV page forhttps://en.wikipedia.org/wiki/Domain_namebecause the page structure doesn't depend on language in Wikipedia.
-
-
-
-
-
-
-
-
in a chat, simply send a message with a single emoji.
-
, 
, 
, 
, 
, 
, 
, 
, 
, 
or 
to any chat to check them out.
to any chat to get a certified random number from the animated dice.
-
-
-
. To make managing groups more enjoyable, we've streamlined all group interfaces, including the Settings screens, Admin panels and Member lists.
to any chat to see if you hit the jackpot.
, 
and 
.
or 
for a surprise.
We're planning to roll out access to group stats for admins of all groups with 100 members or more in the near future.
-
or 
and 
.
-
, 
or 
to any chat.
-
-
) appear there, you can use the new toggles under Settings > Data and Storage > Other > Share Sheet.
icon in the message bar and then tap the camera feed in the attachment menu.
-