# Shorten URL

## **Specs**

| Label                     | Value                         |
| ------------------------- | ----------------------------- |
| **Version**               | 0.1.0 (updated on 2026-04-14) |
| **Developer**             | Labii Inc.                    |
| **Type**                  | Column                        |
| **Support Configuration** | No                            |
| **Support Readonly view** | Yes                           |
| **Support Edit view**     | Yes                           |
| **Support Form view**     | No                            |
| **Support Default value** | No                            |
| **Support Import**        | No                            |
| **Allow multiple**        | No                            |

## Overview

The Shorten URL widget allows users to take any long URL and generate a compact, shareable shortened link directly within a record. Once a shortened URL is created, it can be copied and distributed to customers or collaborators without exposing complex or sensitive query strings. The widget tracks whether a shortened URL has already been generated for the column and surfaces contextual actions accordingly — prompting users to create one when none exists, or offering an update option when one is already in place.

This widget is ideal for any workflow where links need to be shared externally in a clean, professional format.

## Use case

1. Share a report link with a customer without revealing internal URL parameters.
2. Send a shortened link to an invoice so customers can view or pay quickly.
3. Distribute a form link to external users for data collection or feedback.
4. Share a document or protocol link with collaborators in a concise format.

## Configuration

No configuration required.

## Views

See the interface of the widget in the following views.

### **Readonly view**

The Readonly view displays the current state of the shortened URL for the record.

<figure><img src="/files/Cd2pfhg0ucPaFsNmPu17" alt=""><figcaption></figcaption></figure>

* If a shortened URL **has not yet been created**, a **CREATE SHORTEN URL** button is shown. Clicking it generates a new shortened URL from the stored original URL.
* If a shortened URL **already exists**, the shortened link is displayed as a clickable URL. An **UPDATE SHORTEN URL** button allows regenerating the link, and an **EDIT** button opens the edit view to update the original URL.

### **Edit view**

The Edit view allows users to set or update the original URL that will be used to generate the shortened link.

<figure><img src="/files/XRvnVCARx2AZA5zinQEl" alt=""><figcaption></figcaption></figure>

* **Original URL** - The full URL to be shortened. This is the only required field.

After saving, the shortened URL can be generated or updated from the readonly view.

## Data

Each widget in Labii stores data in a unique manner; refer below to understand how data from this widget is stored.

### Data format

JSON

```json
{
    "original_url": "",
    "shorten_url": {
        "sid": "",
        "name": "",
        "url": ""
    }
}
```

### **Default value**

Default value is same as the data format.

### **Import value**

Import is not supported for this widget.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.labii.com/widgets/column-widgets/form/text-inputs/shorten-url.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.