Skip to content

Creating & Managing Links

Links in Ruby are engineered for maximum reliability, global low latency, and zero link rot. Every link can be created in seconds through the web application or automated via the REST API.


Short Codes on rby.one

When creating links on the default platform domain (rby.one):

  • Fixed 8-Character Format: Every link receives a clean, 8-character alphanumeric code (e.g. https://rby.one/A7K92X1P).
  • Guaranteed Unique & Permanent: Short codes are uniquely allocated and guaranteed never to collide or expire unexpectedly.
  • SMS & Channel Friendly: The character set is optimized for SMS deliverability, chat apps, and print materials.
  • Default Domain Policy: Custom aliases are not permitted on the shared rby.one domain to prevent namespace collisions and protect global link integrity. Custom aliases are exclusive to verified custom domains.

  1. Sign in to your workspace in the Ruby web application.
  2. Click Create Link in the top navigation bar.
  3. Enter your Destination URL (the target address where visitors should be redirected).
  4. (Optional) Add an internal Title to easily locate the link later in search and analytics.
  5. (Optional) Assign the link to an existing Link Group to organize related links into a campaign collection.
  6. Click Create Link. Your link is immediately live worldwide.

Destination URL Requirements

On rby.one, destination URLs must begin with a standard web scheme (https:// or http://). Dangerous URI schemes (javascript:, data:, file:) are strictly blocked. Custom app URI schemes (such as myapp://) are supported when using verified custom domains.


UTM Parameters Builder

When creating or editing a link, expand the UTM Parameters section to automatically append marketing attribution tags to your destination:

  • Campaign Source (utm_source): Identifies the traffic source (e.g. newsletter, x, google).
  • Campaign Medium (utm_medium): Identifies the marketing channel (e.g. email, cpc, social).
  • Campaign Name (utm_campaign): Identifies the specific marketing promotion or launch (e.g. spring_launch_2026).
  • Campaign Term (utm_term): Identifies paid search keywords or targeting terms.
  • Campaign Content (utm_content): Differentiates creative variants, ad formats, or CTA links pointing to the same URL.

Query Parameter Forwarding

By default, Ruby automatically forwards all incoming query parameters attached to the short URL directly to the destination address. For example, if an ad platform appends click tracking parameters:

Visitor Clicks:
https://rby.one/A7K92X1P?click_id=abc123xyz&gclid=test_token

Redirects To:
https://example.com/pricing?utm_source=newsletter&utm_medium=email&utm_campaign=spring_launch_2026&click_id=abc123xyz&gclid=test_token

Ruby preserves existing query parameters on your destination URL, appends the configured UTM parameters, and merges any visitor query strings smoothly without parameter loss.


You can modify the destination URL, title, or routing settings of any link at any time:

  1. Open the link details in the web application.
  2. Update the Destination URL, device routing targets, or UTM tags.
  3. Click Save Changes.

Your updates take effect immediately worldwide. Any printed QR codes, physical marketing collateral, social posts, or email blasts already using the link will instantly redirect to the updated destination URL without breaking.


Links remain active permanently unless explicitly paused or deactivated:

  • Active: Traffic redirects normally according to your routing and targeting rules.
  • Deactivated (Paused): If you pause a link, incoming visitors are routed to your configured Fallback URL or a branded 404 page. All historical analytics and click metrics are retained. You can reactivate the link at any time.

Group Immutability

Links assigned to a link group cannot be reassigned to a different group after creation. Links created via asynchronous bulk CSV file uploads belong to frozen groups and cannot be individually deleted to preserve audit consistency.