> For the complete documentation index, see [llms.txt](https://quicly.gitbook.io/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://quicly.gitbook.io/help/bulk-conversion/bulk-conversion-overview.md).

# Bulk Conversion Overview

quic.ly offers three user-friendly methods for bulk URL shortening, complemented by its robust API. Navigate to the 'Bulk Convert' section through the sidebar to access the bulk conversion page.

<div align="left"><figure><img src="/files/Qw6K5locvT5XTUWVXCKX" alt="" width="127"><figcaption><p>Img 1 - Sidebar</p></figcaption></figure></div>

<figure><img src="/files/JdyK26hsF6gO3E9lGOKO" alt=""><figcaption><p>Img 2 - Bulk convert submenu with 3 options for conversion</p></figcaption></figure>

### <mark style="color:purple;">1. Data Grid Copy/Paste:</mark>&#x20;

Ideal for small batches of up to 25 links, this method is the simplest. Copy your links in a spreadsheet-style data grid and convert. Customize aliases and titles if needed; otherwise, the app defaults. The URL shortening uses the preferred domain set in 'Settings' within 'My Account.'

<figure><img src="/files/rsSxRnrXGmwzae0Zyz7I" alt=""><figcaption><p>Img 3 - Bulk convert - Tabular data or datagrid</p></figcaption></figure>

### <mark style="color:purple;">2/3  Bulk Excel & CSV formats:</mark>

* Perfect for handling up to 100 links, exceeding which we recommend using the API. Unlike the data grid, Excel and CSV formats offer more customization options. While the URL field is mandatory, others like alias, title, domain, and UTM parameters are optional.

<figure><img src="/files/YBK3TGtb4ypObtJ2Kdti" alt=""><figcaption><p>Img 4 - Bulk convert excel format (similar to csv)</p></figcaption></figure>

* To convert using file formats, download the provided template, fill in the required fields, upload the file, and convert. It's that simple.

<figure><img src="/files/2Rhvwl7bgIfo6i3eCUnY" alt=""><figcaption><p>Img 5 - Fields in sample excel format</p></figcaption></figure>

{% hint style="info" %}
Note: Excel and CSV formats are suitable for numbers beyond 100, but robust error handling is crucial. In case of errors, you may need to fix and repeat the process. API offers detailed error handling for various scenarios, such as wrong domains or existing aliases, making it a more efficient choice
{% endhint %}

* Convenient help is available in all formats. Expand the 'Need a Hand?' button to find descriptive information on using this feature.

<div align="left"><figure><img src="/files/SZ9oSn00I0eKImqS5XoK" alt="" width="190"><figcaption><p>Img 6 - Expandable help</p></figcaption></figure></div>

<figure><img src="/files/l1wt6BFYPlRCPLPB7Pqo" alt=""><figcaption><p>Img 7 - Expanded help with detailed explanation on how to use the feature</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://quicly.gitbook.io/help/bulk-conversion/bulk-conversion-overview.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.