Link Groups & Bulk Imports¶
Link groups allow you to organize, categorize, and track related links in structured collections. Link groups provide consolidated click metrics across all member links and enable high-volume bulk link generation via CSV file imports.
1. Creating & Managing Link Groups¶
You can create and manage link groups directly in the web application:
- Navigate to Link Groups in the main navigation.
- Click Create Link Group.
- Enter a descriptive Title (e.g.
Summer Catalog 2026orAffiliate Partners Q3) and an optional Description. - Click Create Group.
Inside each link group, Ruby provides aggregated analytics and centralized management:
- Aggregated Click Metrics: Total human clicks and unique visitors consolidated across all member links.
- Link Inventory: Searchable list of all links belonging to the group, including destination URLs, short codes, and individual performance.
- Export Capabilities: Generate downloadable CSV exports of all links in the group.
2. High-Volume Bulk CSV Import¶
For enterprise workflows requiring hundreds or thousands of unique links—such as personalized SMS blasts, physical mailers, or localized marketing initiatives—Ruby supports bulk link generation of up to 100,000 links from a single CSV spreadsheet.
CSV File Format¶
Your CSV spreadsheet must include a header row with column names corresponding to link attributes:
destination_url,title,utm_source,utm_medium,utm_campaign
https://example.com/shoes,Summer Shoes Promo,newsletter,email,summer_sale
https://example.com/bags,Summer Bags Promo,social,facebook,summer_sale
https://example.com/accessories,Summer Accessories Promo,cpc,google,summer_sale
destination_url(Required): The final target address. Must include a validhttps://orhttp://scheme.title(Optional): An internal label for the link.utm_source,utm_medium,utm_campaign(Optional): Standard UTM marketing attribution tags automatically appended to the destination upon redirection.
Asynchronous Background Processing¶
- In the Link Groups section, click Import File.
- Select your CSV file and click Start Import.
- Ruby processes the batch asynchronously in the background. You can navigate away from the page or close your browser while the import runs.
- Once processing completes, click Export Results to download a CSV containing all generated short URLs and short codes.
Frozen State on File-Based Groups
Link groups created via bulk file upload are marked as frozen once processing completes. To guarantee data consistency and auditing integrity for batch operations, individual links cannot be added to or removed from a file-based group after generation.
3. Exporting Link Groups¶
You can export the links of any link group to CSV at any time:
- Open the target link group.
- Click Export CSV in the action toolbar.
- Ruby generates a secure, time-limited download link containing all destination URLs, generated short URLs, short codes, and titles.