> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tonhub.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Metadata headers

> Configure how your app is shown in the Tonhub

Tonhub App appearance can be configured using well-known tags. Configurable properties are: title, description, image and theme color. Also, you can provide default extension to install after successful on-site login.

<Warning>
  ### Metadata is cached FOREVER

  Always invalidate cache using instructions below after updating your application.
</Warning>

## App Title

Title is shown everywhere (instead of page's current title). The list of attributes for title by priority (from high to low):

<CodeGroup>
  ```bash bash theme={null}
  <meta name="ton-x-name" content="TonWhales">
  <meta property="og:title" content="TonWhales">
  <meta name="twitter:title" content="TonWhales">
  <meta property="twitter:title" content="TonWhales">
  <title>TonWhales</title>
  ```
</CodeGroup>

## Logo

<CodeGroup>
  ```bash bash theme={null}
  <meta name="ton-x-image" content="https://tonwhales.com/mstile-310x310.png">
  <meta property="og:logo" content="https://tonwhales.com/mstile-310x310.png">
  <meta itemprop="og:logo" content="https://tonwhales.com/mstile-310x310.png">
  <img itemprop="og:logo" src="https://tonwhales.com/mstile-310x310.png">
  <meta name="twitter:title" content="https://tonwhales.com/mstile-310x310.png">
  <meta property="twitter:title" content="https://tonwhales.com/mstile-310x310.png">

  ...and then tries to extract image from favicon
  ```
</CodeGroup>

## Theme color

Specifies theme color of the application. Used for customizing backsheet, etc.

<CodeGroup>
  ```bash bash theme={null}
  <meta name="ton-x-theme-color" content="#fff">
  <meta name="theme-color" content="#fff">
  ```
</CodeGroup>

## Description

Description is not used now, but reserved for further functionality.

<CodeGroup>
  ```bash bash theme={null}
  <meta name="ton-x-description" content="TonWhales description">
  <meta property="og:description" content="TonWhales description">
  <meta name="twitter:description" content="TonWhales description">
  <meta property="twitter:description" content="TonWhales description">
  <meta name="description" content="TonWhales description">
  <meta itemprop="description" content="TonWhales description">
  ```
</CodeGroup>

## Extension

To setup default extension for your app, you need to provide **ton-x-extension** with the extension config in the content. To generate extension config, look at [Tonhub Link Generator](/docs/tonhub-link-generator)

<CodeGroup>
  ```bash bash theme={null}
  <meta name="ton-x-extension" content="te6cckEBAwEAIgACAcgCAQAIVGVzdAAqaHR0cHM6Ly90b253aGFsZXMuY29t7YNv4A">
  ```
</CodeGroup>

## Custom tags

Also, there are special tags which can be used for overriding metadata especially for Tonhub:

<CodeGroup>
  ```bash bash theme={null}
  <meta name="ton-x-name" content="TonWhales">
  <meta name="ton-x-color" content="#fff">
  <meta name="ton-x-image" content="https://tonwhales.com/mstile-310x310.png">
  <meta name="ton-x-description" content="All information about wallets, staking and mining on TONCOIN network.">
  ```
</CodeGroup>

## Caching

Metadata is cached FOREVER for url, stripping query params. For example: [https://tonwhales.com/club?test](https://tonwhales.com/club?test) == [https://tonwhales.com/club](https://tonwhales.com/club) [https://tonwhales.com/](https://tonwhales.com/) != [https://tonwhales.com/club](https://tonwhales.com/club)

## Resetting metadata

To reset metadata for your service, request metadata with refetch=1 parameter:

<CodeGroup>
  ```bash bash theme={null}
  curl -X GET https://connect.tonhubapi.com/apps/metadata\?url\=https://tonwhales.com\&refetch\=1
  ```
</CodeGroup>