Skip to content
Reports and Alerts

Reports and Alerts

Availability: Scheduled reports are available on every plan, including Free. Triggered alerts require Starter or higher, with higher rule limits on Professional and Agency.

Shortn can send you reports and alerts through your destinations (email, webhook, Slack, Discord, or Microsoft Teams). Manage them from Reports in the dashboard.

Reports vs. alerts

  • Reports run on a schedule — for example, a daily or weekly summary of clicks, top links, or geography.
  • Alerts fire when something happens — for example, a link crosses a click threshold, expires, or fails a health check.

Which links a report or alert covers

When you create a report or alert, pick a workspace and then the links it covers:

  • Links in no team: links that belong to no team in the workspace.
  • A team: the links assigned to that team.

You can pick several. Picking every team and Links in no team covers the whole workspace. You can only pick teams you belong to, unless you’re a workspace owner or administrator.

A report or alert with one team is visible to that team’s members. With several teams, it’s visible only to workspace owners, administrators and people who are members of every selected team, because it shows links from each of them. Its tags and destinations follow the same rule: you can use the ones in no team or in one of the selected teams.

Report library

A scheduled report is built from sections you pick from the report library, in the order you choose. Most sections have settings (the gear on a selected section), such as the time window they cover or how many rows they list. The library groups them by category:

Traffic

  • Total clicks: clicks and unique visitors, compared with the previous period.
  • Top links: your best links by clicks or unique visitors.
  • Daily clicks: the clicks of each of the last 7, 14 or 30 days.
  • Peak times: the busiest hours of the day, or days of the week.
  • Rising and declining links: the links that gained or lost the most clicks against the previous period.
  • Referrer breakdown: the top referrers, referring domains, or channels (search, social, email, and so on).
  • UTM campaigns: the top campaigns, sources, mediums, terms or contents from your UTM parameters, and how many clicks carried one.
  • QR code scans: how many clicks came from QR codes and which links were scanned most.

Audience

  • Geographic breakdown: the top countries or cities.
  • Device mix: the top devices, browsers or operating systems.
  • Languages: the languages your visitors’ browsers use.
  • Traffic quality: human visitors against bots, crawlers, datacenter and VPN traffic, classified as in analytics.

Revenue (with conversion tracking)

  • Conversions: leads, sales, net revenue and click-to-lead and click-to-sale rates, compared with the previous period, in your workspace’s reporting currency.
  • Top converting links: the links with the most net revenue, sales or leads.
  • Commissions: partner and member commissions by status (pending, approved, payable, paid, void) and who earned the most. Only workspace owners and administrators can include it, and it covers the whole workspace.
  • Payouts: commissions approved and due to pay, those in payout batches not yet paid, what was paid out during the period, and anything owed back after refunds, with the people owed the most. Only workspace owners and administrators can include it.

Links

  • Tag performance: your tags by clicks or unique visitors.
  • Team performance: clicks on each team’s links.
  • Inactive links: active links that got no clicks during the whole period.
  • A/B tests: running and recently ended tests, each variant’s clicks and conversion rate, and which variant leads, as the link’s A/B results show it.
  • Link activity: links created, gone live and expired, and the newest links.
  • Expiring and scheduled links: links that expire or go live in the next 24 hours, 7 days or 30 days.

Workspace

  • Workspace changes: links created, edited and deleted, destinations and statuses changed, members who joined or left, role changes, new teams and domains, with who made each change and the latest changes listed. It reads the workspace’s activity history, so it needs the workspace owner’s plan to include workspace activity (Professional and higher), and covers what that plan keeps.

Health & security

  • Health snapshot: links by their last health check result.
  • Quota snapshot: active links against your plan’s limit.
  • Abuse reports: recent abuse reports on your links and how their review stands.
  • Destination security: links whose destination the security scan flagged or locked.
  • Custom domains: your custom domains’ setup state, and the ones that need attention.
  • Conversion connectors: whether your Stripe, Shopify and other connectors are working, including any disconnected in the last 30 days. Only workspace owners and administrators can include it.

Times of day and days are in the time zone of your profile, which the report states.

Geographic breakdown, Device mix, Referrer breakdown and Tag performance can also cover All time. Reports saved before these sections had a time window keep covering all time until you choose one.

In emails, Daily clicks and Peak times come with a column chart, and ranked sections (top links, countries, referrers and so on) with a bar for each row. Slack, Discord and Teams messages show the same trends as a one-line sparkline.

Report options

  • Include comparison with previous period adds the change against the period before.
  • Attach the report’s data to emails as a CSV file adds one spreadsheet-ready file with every section’s figures and rows to each email the report sends.
  • Report language (English, Spanish, Czech, German or French) is the language the report is written in, in every destination: emails, Slack, Teams, Discord, webhooks and the CSV file, with numbers, amounts and dates written the way that language writes them. New reports start in the language you use the app in; reports saved before this option follow their creator’s profile language. Alerts have the same option (Alert language).

Send a test

Open a saved report or alert and choose Send test to see how it looks in its destinations. The test has the report’s own sections, or the alert’s conditions and context, filled with sample values, never your real data, and every destination marks it as a test: “[Test]” in the subject and a note at the top (webhooks get "test": true). Real data goes out only on the report’s schedule, or when the alert’s conditions are met.

The test uses the saved version (save your changes first) and doesn’t change the schedule. A test can be sent again after a couple of minutes, and a paused report or alert must be resumed first. Tests appear as “Test send” in the recent deliveries, but don’t count towards their “Delivered” summary. Test sends are available on every plan, Free included.

Alert examples

Alerts can trigger on:

Traffic

  • A link reaching a click threshold
  • A sudden rise or drop in a link’s traffic
  • Clicks from a country a link doesn’t usually get
  • A link’s QR code reaching a number of scans (every 100 scans by default)

Revenue

  • A new sale or lead credited to a link, with its amount (optionally with a cooldown, so a busy link doesn’t send one alert per sale)
  • New commissions waiting for approval (workspace owners and administrators only)
  • A refund of a sale credited to a link, with its amount: every refund, or only refunds that leave nothing of the sale

Links

  • A scheduled link going live
  • An A/B test reaching its review date, so someone picks a winner

Workspace

  • Someone joining the workspace, leaving it or being removed, with their role. People are named by their profile name, never their email address.

Health & security

  • A link’s health changing (failing or recovering)
  • A link expiring or nearing expiration
  • A link’s status changing
  • A link being reported for abuse (see below)
  • Someone changing where a link points: its main destination, a device, language or country target, or an A/B variant. The alert names who changed it (never their email address).
  • A surge of bot traffic: bots, crawlers and datacenter traffic making up a large share of a link’s recent clicks
  • A custom domain losing its DNS verification or its certificate failing
  • A conversion connector starting to fail to deliver conversions, or being disconnected (workspace owners and administrators only); each problem is reported once
  • Workspace usage approaching its quota

Conversion and refund alerts count live conversions only; test conversions and test refunds never trigger them.

An alert can also carry up to three context sections from the report library, such as the top links, traffic quality or the abuse reports below. Sections with a time window cover the last 24 hours in an alert (Daily clicks, the last 7 days).

Abuse reports

Anyone can report a short link through its public report form (/report/<code>). When that happens, the link’s owner and the workspace owners and administrators get an in-app notice only; Shortn sends no email for it. To get reports by email, webhook, Slack, Discord, or Teams, create an alert with the Link reported for abuse condition.

  • The alert fires on the first report of a link each day, with the reason category the reporter chose (phishing, malware, spam, and so on).
  • With the condition’s Review outcome setting it can also fire when an administrator closes the link’s reports: only when the link is suspended, or also when the reports are dismissed.
  • Add the Abuse reports context section to include the latest reports of the links the alert watches (last 30 days): the link, the reason, when, how the review stands, and the link’s current status.

Alerts never include who reported a link or what they wrote.

Delivery

Each report or alert sends to one or more of your destinations. The destination types you can use depend on your plan (see webhooks).

Delivery status

Each report and alert on the Reports page shows how its last delivery went: delivered, partly delivered, failed, or still being retried. Hover over it to see what each destination got and, for a destination that failed, why (for example, a Slack webhook that was deleted, or a server that didn’t answer). Open a report or alert to see its Recent deliveries: the last 10 runs and what each destination got.

A delivery that fails is tried again for about two hours before it counts as failed.

When a destination stops working

When a destination stops getting a report or alert, the report’s creator and last editor, and the workspace’s owners and administrators, get a notification in the app. The creator and last editor also get an email, in their language, when the cause is something they can fix (the destination itself). You hear once when it starts failing, not on every run, and again when it works again. You can turn these off in your profile’s notification settings (Report delivery failed and Report delivered again).

The same people are told, in the app, when a report or alert can’t be generated at all, so nothing is sent (“Report not generated”), and when it’s generated again. That’s usually a problem on our side or with the data, so there’s nothing to change and no email; the next run tries again. The same two settings cover these notices.

Limits by plan

PlanReports & alertsTriggered alertsAlerts sent a monthScheduling
Free1——Scheduled, at most weekly
Starter5✓500Scheduled
Professional20✓5,000Scheduled
Agency100✓UnlimitedScheduled

Free plans can create scheduled reports (no more often than weekly) but not triggered alerts. See plans.

Reports and alerts count against the plan of whoever created them, and only while they’re on.

  • Alerts a month: on Starter and Professional, the alerts that a creator’s alerts send are counted per calendar month (UTC); test sends don’t count. Alerts sent in the usage panel on Home and in Billing shows this month’s count against the limit. At 85% of it the creator gets one notice in the app. Once the limit is reached, further alerts that month are skipped (they show as “Skipped: alert limit” in the recent deliveries) and the creator is told once, in the app and by email. Scheduled reports keep going out.
  • After a plan change: reports and alerts the new plan doesn’t allow are paused: the newest ones over its number of reports and alerts, alerts on Free, reports sent more often than weekly on Free, and ones sending to a webhook, Slack, Teams or Discord destination the plan doesn’t include. The creator is notified, and they turn back on by themselves once the plan allows them again.
Last updated on