> For the complete documentation index, see [llms.txt](https://guide.go.gov.sg/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.go.gov.sg/guide-1/link-tagging.md).

# Link Tagging

## What are tags?

Tags are short labels you add to a link to describe or group it, so you can find related links later. A tag can use letters, numbers, hyphens (-) and underscores (\_), for example `survey-001` or `Oct2022_campaign`.

{% hint style="info" %}
Tags are only visible to you, on your dashboard. They don't show up in Directory search.
{% endhint %}

#### How can I use tags?

* Divide links into general categories, e.g. "survey", "news", "report".
* Describe the original URL a short link leads to, e.g. "straits-times", "FormSG".
* Track the period a short link is in use, e.g. "Oct2022-campaign".

#### Best practices for tagging

* Make tags consistent, e.g. always use "reports" instead of variations like "report", "Reports" or "REPORTS".
* Keep tags short, e.g. `survey-001`.
* Create a master list of tags to keep track of the ones you've used before.

#### Examples of links and possible tags

Example 1

* Original link:<https://eservices.ica.gov.sg/esvclandingpage/apples>
* Short link:<https://go.gov.sg/passport>
* Tags: ICA-eservices, passport-applications

Example 2

* Original link:<https://form.gov.sg/62175c626c24dc001287ba8e>
* Short link:<https://go.gov.sg/ns55rp-registersafra>
* Tags: NS55rp, SAFRA-registration, FormSG

## How do I create tags?

1. When creating a new short link, add up to 3 tags in the tags field.

   <figure><img src="https://content.gitbook.com/content/QUOVfPNmRg249PMXOlpi/blobs/GfXP2RBNYtnbdMHas6Ut/create%201.png" alt=""><figcaption></figcaption></figure>

2. A tag is created when you press space, comma or enter, or click away from the field. When you’re happy with your tags, click **Create link**.

<figure><img src="https://content.gitbook.com/content/QUOVfPNmRg249PMXOlpi/blobs/ihglxPbC1aQDCgM4Usn5/create%202.png" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Tag rules**

* Up to **3 tags** per link.
* Up to **25 characters** per tag.
* **Letters, numbers, hyphens (-) and underscores (\_) only.** No spaces or other special characters (such as # ! $ % ^ & \* + .).
* Tags are **case sensitive**. “Newsroom” and “newsroom” are two different tags.
  {% endhint %}

## Can I edit the tags in my short links?

Yes. Follow the steps below to add, change or remove tags.

1. Click on the short link on your dashboard

   <figure><img src="https://content.gitbook.com/content/QUOVfPNmRg249PMXOlpi/blobs/D61wgVfS9EORqPq3usRx/change%201.png" alt=""><figcaption></figcaption></figure>
2. Under **Tag (add up to 3 tags)**, click the **X** on any tag you want to remove

   <figure><img src="https://content.gitbook.com/content/QUOVfPNmRg249PMXOlpi/blobs/GNxRAMhJZwwJH6HJqaPd/change%202.png" alt=""><figcaption></figcaption></figure>

   * Type in the field to create new tags

   <figure><img src="https://content.gitbook.com/content/QUOVfPNmRg249PMXOlpi/blobs/JvZIrmoEbAqEWevYL3gG/change%203.png" alt=""><figcaption></figcaption></figure>

   * Click on “Save” to update your tags

   <figure><img src="https://content.gitbook.com/content/QUOVfPNmRg249PMXOlpi/blobs/ErvKNV3pde1TdR4KY9bi/change%204.png" alt=""><figcaption></figcaption></figure>

   * A notification confirms that your tags have been updated.

   <figure><img src="https://content.gitbook.com/content/QUOVfPNmRg249PMXOlpi/blobs/6PcMES4l9jwEaBn2rT7P/change%205.png" alt=""><figcaption></figcaption></figure>

Tag rules are the same as when you create a tag. See **Tag rules** above.

## How do I search using tags?

There are two ways:

1. **Use the search bar.** On your dashboard, click the dropdown in the search bar and choose **Search by Tag**, then type the tag you want.

<figure><img src="https://content.gitbook.com/content/QUOVfPNmRg249PMXOlpi/blobs/uyWg56PqaZpHGJ36A4kQ/search.png" alt=""><figcaption></figcaption></figure>

2. **Click a tag.** Click any tag on your dashboard to show all the short links with that tag.

<figure><img src="https://content.gitbook.com/content/QUOVfPNmRg249PMXOlpi/blobs/BoDoBLfqbHPtwo8cnzAS/search%202.png" alt=""><figcaption></figcaption></figure>
