logo
Analytics•

Filter analytics by link, tag, and date range

Narrow CodeQR Analytics to one link, QR code, tag, domain, country or device, pick a preset or a custom period, and know how far back each plan can look.

Avatar for undefined
CodeQR Team
Content Team

By the end of this guide you will be able to look at one link, one QR code, one tag, or one country in Analytics, choose the period that matters, and know which periods your plan can open.

Availability

  • Plan: all plans can filter. The date range is limited by plan: Free up to 30 days, Starter up to 90 days, Pro up to 1 year, Business and above without limit in the app. Locked presets show a lock icon and an Upgrade to … tooltip.
  • Where: Analytics → Filter and the date button (24h by default). The same filters work on Events and on the UTM Report tab.

Before you start

  • Filters combine with AND: Country = Brazil plus Device = Mobile shows only mobile clicks from Brazil.
  • The date range uses your browser's time zone. A colleague in another time zone can see a click on a different day; the API defaults to UTC unless you pass timezone.
  • Filters live in the page URL (for example ?country=BR&interval=7d), so you can bookmark a view or paste the URL to a teammate who has access to the workspace.

Steps

  1. Open Analytics and click Filter.
  2. Pick a dimension. The list is Domain, Link, QR Code, Link Type, Tag, Trigger, Country, City, Continent, Device, Browser, Operating System, Referrer, URL do Referenciador (referrer URL), and UTM Source, UTM Medium, UTM Campaign, UTM Content, UTM Term. Type to search inside a dimension.

Filter menu open on the Analytics page listing every dimension from Domain to UTM Term

  1. Choose a value. The filter appears as a chip next to Filter; add more chips the same way, or click a row inside any card (a country, a device, a referrer, a UTM value) to add it as a filter. Clear filters removes them all.
  2. To focus on one link or QR code without opening the menu, click its N clicks or N scans badge in the Links or QR Codes list. Analytics opens with the Link or QR Code chip already set, and the Links card gains a URLs tab with the destinations of that link.
  3. Trigger separates the kind of event: Click on link, QR scan, or Page visit. It narrows the cards (countries, devices, referrers, UTM); the counters at the top already split Clicks, Scans, and Views on their own.
  4. Tag shows every link and QR code carrying that tag together — the fastest way to read a campaign that spans several links. See How to use tags in CodeQR.
  5. Click the date button (24h) to change the period. The presets are Última hora (last hour), 24h, 7 dias (7 days), 30 dias (30 days), 3 meses (3 months), Este ano (this year), Últimos 12 meses (last 12 months), and Todo o Tempo (all time). Each has a keyboard shortcut (H, D, W, M, T, Y, L, A). Presets your plan cannot open show a lock.

Date range menu with the presets Última hora, 24h, 7 dias, 30 dias and the locked 3 meses, Este ano, Últimos 12 meses and Todo o Tempo on a Free workspace

  1. For a custom period, click the first and the last day in the two-month calendar on the left of the same menu. The end date cannot be in the future.
  2. Reload later with the same URL to come back to the same view.

How far back you can look

  • Free: 30 days (24h, 7 dias, 30 dias, custom up to 31 days).
  • Starter: 90 days (adds 3 meses).
  • Pro: 1 year (adds Este ano and Últimos 12 meses).
  • Business and above: Todo o Tempo and any custom range in the app. The pricing page states 2 years for Business and 5 years for Scale as the guaranteed retention.

If you downgrade, the history you can open shrinks to the new plan's window; the app warns you before confirming.

The same through the API

Every filter is a query parameter of GET https://api.codeqr.io/analytics: linkId, qrcodeId, domain + key + type, tagIds, country, city, continent, device, browser, os, referer, url, utm_source … utm_term, plus interval (24h, 7d, 30d, 90d, ytd, 1y, all) or start and end with timezone. Example: GET https://api.codeqr.io/analytics?event=clicks&groupBy=count&interval=7d&tagIds=tag_xxxxxxxxxxxxxxxxxxxxxxxx&country=BR. A range above your plan returns 403 with a message naming the plan you need. See Read analytics from the API, MCP, and webhooks.

Verify it works

  1. Filter by Country → your country and by Device → Mobile.
  2. Open your short link on your phone and wait two to three minutes.
  3. Clicks goes up by one, and the chip list still shows both filters. Remove the Device chip: the count does not change unless someone clicked from a desktop in the same period.

Troubleshooting

The preset I want is locked

Your plan's window is shorter than that preset. Hover the item to see which plan opens it, or pick a custom range inside your window. Upgrading opens older data that CodeQR already stores; nothing is deleted while you are below the window.

I chose Última hora and the chart is empty

The counters and the cards update for the last hour, but the chart does not render at that granularity yet. Use 24h: the chart is hourly and the last point is the current hour.

The counters do not change when I choose a trigger

Trigger filters the cards. The counters already show Clicks, Scans, and Views separately — read the one that matches the trigger.

A click made at 11 pm shows on the next day

The dashboard groups by your browser's time zone; the API and exports use UTC unless you pass timezone. Compare like with like. See Clicks not showing or numbers that do not match.

Related articles