Repository navigation
Releases
LinkHop 2.6.0
You can now tell us about a problem or an idea from inside LinkHop, without sending an email.
Added
- Dashboard, sidebar footer. A new "Feedback" link sits right under "Help" and opens the HOP ID feedback form in a new tab, so what you were doing here stays open. Reason: you can reach us from any dashboard screen in one click.
- Public pages, footer. The footer of the home page, Help, FAQ, Contact, About, Features, API, Status, Terms, Privacy, Changelog, the QR page and the link checker has the same "Feedback" link next to "Help". Reason: visitors who are not signed in can reach the form too. The pages that belong to a short link (the link that has ended, the link that was not found) do not get it, because they are the link owner's pages, not ours.
- Help and Contact pages. One "Send feedback" link on each page opens the same form. Reason: these are the places where people look for a way to reach us.
- Privacy page. One sentence says that the Feedback link opens a form on the HOP ID site, that LinkHop itself receives nothing from it, and points to the HOP ID privacy policy for what the form keeps and for how long. Reason: the form belongs to HOP ID, not to LinkHop, so its rules are written there.
- All nine languages. The new words are translated into every language LinkHop offers. Reason: the link should read naturally for everyone.
Changed
- Short link names. "feedback" can no longer be chosen as the name of a new short link. Reason: that word is the address of the feedback form, and a short link with the same name would be confused with it. Links that already exist are not touched.
LinkHop 2.5.2
A report that a visitor sends about a bio page is no longer listed as if it were about a short link.
Fixed
- Report list in the HOP control center. Visitors report a bio page with the report form on the bio site, and that report is saved in the same place as reports about short links. Until now it showed up in LinkHop's report list and was labelled as a short link, so the people handling reports saw the wrong kind of item. Every report now remembers which app it is about, and LinkHop's list, its count of open reports and the check that stops a reported guest link from being claimed only use reports about short links. Older reports whose address points to a bio page are sorted the same way once, as a best guess. Nothing is deleted. Bio pages get their own report list, with a button to switch the page off, in a later BioHop update.
LinkHop 2.5.1
Every public page now speaks the language you picked, and each one has a proper short summary in search results.
Fixed
- Pages in your language. The About, FAQ, API, Features, Help, Contact, Terms and Privacy pages, and the link checker, now show their title, short summary and headings in the language you picked, in all nine languages. Before, some of them stayed in English even with the German or Indonesian address, and the link checker was English only. Fixed so that search engines and visitors get the language the address promises.
- Page summaries. The short text that search results show under each LinkHop page is now written for every page, 70 to 155 characters long, in all nine languages. The FAQ and Changelog summaries were too short to be useful, and the Status page shared its summary with the home page.
v2.5.0
News from the HOP team now reaches you on the dashboard, the sidebar is tidier, and Analytics opens quickly even with thousands of links.
Added
-
Dashboard announcement. When the HOP team posts an announcement for LinkHop or for all of HOP, one card with its title and a short text shows on your dashboard, and the title opens the full message. Hide it and it stays away for a week; an urgent one cannot be hidden. If the announcement service cannot be reached, the dashboard simply shows no card and opens as fast as before. Asked for so that one message written once reaches every HOP app.
-
Colour sets. At the bottom of the dashboard sidebar you can now choose Classic, Mist or Sand. Mist and Sand change the accent colour and the soft background and card colours, in light and dark, and your choice is remembered in this browser and shared with the other HOP apps that offer it. Classic looks exactly as before, and public pages stay Classic. Asked for so that the whole HOP family can share one look.
Changed
- Sidebar menu. The group that held My links, QR codes, Import CSV, Folders and Tags is now called Library, in all nine languages, because it holds more than links. The word Links is unchanged where it means links, such as the Analytics tab.
- Sidebar footer. The small links at the bottom of the sidebar are now one list, a line each: Help, Terms, Privacy, Changelog, GitHub and Announcement, with "Part of Hop Easy Link" below. On a phone the list scrolls together with the menu. Asked for so that every HOP dashboard has the same footer.
- Analytics link list. The list of links above the charts now loads the newest few and finds the rest as you type, instead of sending every link you own along with the page. With 5,000 links the page is about 85% smaller and opens faster; choosing a link works as before.
Fixed
- Analytics map. Leaving the Analytics page while the world map was still loading no longer counts as a map error; a map that truly fails to load still says so. This was causing a false alarm in the nightly automatic checks.
Removed
- Short links notice on the dashboard. The fixed card about short links moving to the new address is gone from the dashboard; the same message can be posted as a HOP announcement, and the explanation page stays available.
v2.4.0
A new QR codes page inside the dashboard, and a tidier create dialog, analytics page and sidebar.
Added
- QR codes page. The "QR codes" entry in the dashboard menu now opens a page inside the dashboard instead of the public tool. It lists the QR codes of your short links and the codes you keep yourself (Wi-Fi, contact card, link or text). Create QR makes a new one, Save keeps it, and each saved code can be viewed, downloaded as PNG or SVG, renamed or deleted. What a saved code carries, such as a Wi-Fi password, is stored encrypted and shown only to you, up to 50 codes per account. Asked for because the menu used to leave the dashboard and a made code could not be kept.
Changed
- Create dialog. The Folder picker is now on the left, next to Tags, and the right side shows only the link preview, also for the QR and Deep link entries of the Create menu. Reported by a user: the folder belongs with the other fields you fill in.
- Analytics. The list of links is as wide as its button instead of stretching across the page. On wide screens (1280 px and up) the chart sits beside the four key numbers and is taller. The smaller tabs under a tab (Countries, Domains, Devices, Links) now look smaller and sit right under their tab, and the main tabs wrap onto a second line on a phone instead of scrolling sideways. Reported by a user: the page looked stretched and the two rows of tabs looked alike.
- Sidebar. "Part of Hop Easy Link" is now at the bottom of the sidebar on every dashboard page, no longer under the page content, where its place changed with the length of the page.
- Public pages when signed in. On information pages, the changelog, the public QR tool and the link checker, the logo and the back link now take a signed-in person to the dashboard and say so; visitors still go to the front page.
- Public top bar on a phone. The Sign up (or Dashboard) button now lives in the menu on small screens. In German and Russian the bar was wider than the screen and pushed the menu button out of sight.
Fixed
- QR sheet in the create dialog. Reset now only restores the colours and logo; it used to switch the QR code off as well. After the sheet closes, the keyboard focus returns to a control you can see.
- Confirm questions. Questions such as "Delete this QR code?" did nothing when the family's own dialogs could not load and the browser's plain question was used instead; the action now goes ahead after you confirm.
Security
- Framework update. The web framework LinkHop runs on is updated to a version that closes a security advisory published on 2026-11-13, together with a few small packages it relies on. Nothing changes in how the site looks or works.
Removed
- Control center settings. Eight site and search settings that never changed any page are no longer offered to the control center; an older control center that still sends them gets no error and nothing is stored.
v2.3.3
Fixed
- API: the token API follows the link form's alias rule: a new link made with
POST /api/shortentakes an alias of 3 to 48 letters, numbers and hyphens. Older links with an underscore (or a longer slug) stay readable and can still be deleted through the API. - API: a link password set through the token API must be at least six characters, the same as the link form (it used to accept four). The
/api-docspage and the README now state both rules. - Pages now say
Vary: Cookie(they already carriedCache-Control: private), so a cache that followsVarynever keeps one visitor's language for another. Public assets with their ownmax-ageare left as they were. - A request without a language cookie no longer receives the one-time
hop_lang/hop_prefclean-up cookies; the clean-up runs on the first request that carrieshop_lang. A plain page is now free of preference cookies, like the bio pages.
v2.3.2
Changed
- The create dialog is reworked after the dub.co pattern: a lean core (destination, short link, tags) with the folder and the compact preview column that stays in view while the left side scrolls, and every other option group in its own small sheet that opens from a chip — Campaign tags (UTM), QR code, Social preview, Schedule & limits, Protection (password, redirect type, content warning, comments), Open in the app (deep link and app store link), Routing & A/B split and the WhatsApp rotator. A chip that was filled shows a short summary ("2 set", "3 rules · A/B", "Auto"); every sheet closes with Escape or Done and gives the focus back to its chip. The payload, the server contract and the validation are unchanged, and the edit page keeps its full sectioned form.
- The top bar action is now "Create": the main button opens the dialog as before, and the caret beside it offers the presets — Link, QR code (switches the QR on and opens its design sheet) and Deep link (starts the app opener in auto mode). On pages without the dialog the presets travel to
/links?create=qror/links?create=deeplink, which open the dialog with the matching sheet. - Analytics is compact, especially on a phone: the page header that repeated the top bar is gone; one toolbar row (the link picker, a segmented 6/12/24/48/72-hour range — a compact select on a phone — and Location and Device together in one Filter popover with a badge for what is active, Reset only when something is filtered); one KPI card with four numbers (the top country now also carries the country count); a shorter chart; and one card with tabs for every breakdown (Locations with the map, Sources including QR vs direct, Technology, Links, Busiest hours, Networks). The active tab stays in the URL, and the map is only built when its tab first shows it. The busiest-hours heatmap uses fixed-size cells, so a phone no longer scrolls sideways.
- The create dialog and analytics speak the reader's language: the ±150 strings that were English literals in every language are translated in all nine (en, zh-CN, de, id, ja, pt-BR, es, fr, ru), and so are the rank lists' "Show all"/"Show less" buttons on the analytics and link pages.
Fixed
- Analytics: the chart, the map and the country focus work again on the reworked page (one script line produced invalid JavaScript, so the whole block failed to load). A test now renders the member pages and has Node parse every inline script.
- Create dialog: the "QR code" chip only opens its sheet; the QR is switched on with a "Generate QR code" switch inside the sheet (or by the Create ▸ QR code preset) and switches off again for the next link. The dialog and its option sheets are solid surfaces, not half see-through.
?create=…is read once and removed from the address, so the dialog no longer reopens after the page reloads for a new link. The campaign tag sheet starts from the tags on the new address instead of the previous link's fields, the QR sheet keeps its buttons in view on a short window and the Social preview sheet's buttons can be reached by scrolling, and the WhatsApp rotator and app store link sheets say why they are paused when the other one is on.- Analytics: the page has an (invisible) main heading again (the open tab already stays when the filter or the time range changes: the address fragment travels with the form); "24h", "via proxy/VPN" and the empty link list texts follow the reader's language.
v2.3.1
Fixed
- Analytics: the open "All links" list was painted under the stat cards in the default (glass) style, because the filter form's
backdrop-filtermakes it a layer of its own. The form now sits above the cards (z-20, under the top bar) and the open list has a solid surface (.glass-popover), so nothing behind it shows through. Escape closes the list and gives the focus back to its button. - Create dialog: on wide screens the folder, QR and preview column stays in view while the advanced options scroll (sticky), and scrolls on its own when it is taller than the dialog.
- Slug fields (the create dialog, the guest form, the create and edit pages) let the browser pass exactly what the server accepts: letters, digits and hyphens, 3 to 48. The dialog used to allow
_and any length, somy_linkorabcame back with a 422. - API: a hub token with
link:write("Edit and delete short links", the scope the hub offers) can delete a link withDELETE /api/links/{slug};link:delete,link:*and a token without scopes still can,link:readcannot. The docs page (nine languages) and the README namelink:write.
Changed
- Search engines: every indexable public page names its canonical address (
APP_URLand path, plus?lang=only when the request asked for one of the eight languages other than English, which lives at the bare address),og:url, the nine language addresses andx-default, an absoluteog:imageand a twitter card, the family rule the hub uses. The home page and/qrsay what they do in their title and description (nine languages) and carryWebApplicationJSON-LD. The sitemap lists every public page once (now with/docsand/status) with its language alternates. Signed-in pages and the API docs arenoindex, nofollow; error pages and the abuse formnoindex; every answer of a short link (redirect, preview, password, ended, missing, the old/{slug}) sendsX-Robots-Tag: noindex. - Theme and language are shared with the other HOP apps. The theme lives in the cookie
hop_theme(lightordark; absent means the system setting), read before first paint, then the oldlocalStoragekey, which every toggle keeps writing.hop_langis now set forDomain=.hel.inkon hel.ink hosts (host-only elsewhere, so localhost and self-hosted copies work as before); a browser's old host-onlyhop_langis moved to the domain once (hop_pref=2). When a browser sendshop_langtwice (the old host-only one first), the last one counts, for the page and for the value moved, so a newer choice made in another app is not overwritten. Bothhop_langandhop_prefare plain text (not encrypted). No configuration change is needed.
v2.3.0
Added
- WhatsApp rotator per short link (accounts only). A link can hold up to 10 WhatsApp numbers, each with a weight (1 to 100) and an optional prefilled message; every visit goes to
https://wa.me/<number>?text=...of one of them, in turn (round robin) or by weight (a fixed cycle as long as the weights add up to, so the shares are exact). Numbers are stored as digits with the country code and no+(8 to 15 digits, not starting with 0); anything else is refused with a translated error. The message is checked like a destination (the safety checks run on the realwa.meaddress and the words in the text) and is always URL-encoded. The turn comes fromlinks.wa_cursor, moved by oneUPDATE ... + 1inside a transaction, so concurrent visits never take the same turn; an ordinary link does no extra query, and crawlers get the first number without using up a turn. Every visit is still counted as before;link_clicks.variantrecords the number's stable id, and the link's statistics page shows the count of each number. The create dialog and the edit page have a "WhatsApp rotator" section; a rotator has no destination of its own, so the destination is the first number's address, and routing rules, the split and the app opener are switched off while it is on. Guests cannot make one (the guest form refuses the fields). Migration2026_11_13_000001addswa_mode,wa_numbersandwa_cursorand is reversible. - Claim token for guest links. A browser that makes a guest link receives a random claim token in the
hop_claimcookie (HttpOnly,Secure,SameSite=Lax, 30 days); only a keyed hash of it is stored (links.claim_token_hash), and the token never appears in a URL, a log line or a response body. After signing in, that browser sees "You made N links before signing in" with a Claim button on the dashboard and on My links; claiming moves those links to the account in one statement, once, and only links that are still unowned, active, not flagged, not reported and not expired, then clears the cookie.POST /links/claimis rate limited (6 a minute). A link id without the cookie claims nothing. The per-address guest limits (creator_hash) are unchanged. Migration2026_11_13_000002adds the column and its index and is reversible. - Claiming respects the account's active-link limit (
limits.user.max_active_links): the oldest guest links move first, as many as fit, the message says how many are left (Not claimed yet: N ...) and the claim cookie stays so the rest can be claimed after some links are removed or switched off. - App store link: one short link that sends each system to its own app store. The create dialog and the edit page have an "App store link" choice with four optional addresses (Google Play for Android, the App Store for iPhone and iPad, the Mac App Store for macOS, the Microsoft Store for Windows; at least one is needed). Everyone else (Linux, ChromeOS, crawlers, any other system) goes to the link's destination. Each address has to be an
https://page of its own store, otherwise the error names the store; it also passes the same safety checks as any other address. The form writes ordinary routing rules (one per filled store, with astoremarker), so the redirect works as routing rules always did, and the edit page shows them back in the store form; a link whose rules were changed by hand into something the form cannot show opens in the routing rules editor with nothing lost. The API takes the same throughrouting_rules(the API docs page has an example). It is for accounts, like routing rules, and not combined with the WhatsApp rotator; with the A/B split the store rule comes first, and with "Open in the app" the visitor is routed first and then the store's own app opens.
Changed
- The claim cookie's
Secureflag followssession.secure(SESSION_SECURE_COOKIE, which defaults to "APP_URLis https"); only an explicitfalseturns it off, so the claim flow can be tried on local http and production staysSecure. - WhatsApp rotator numbers take the smallest free id (never above the list length, so always within the unsigned tiny integer
link_clicks.variant, which the A/B split shares). Each number records when it was added and only clicks from then on count for it, so a reused id, or the variants of an earlier A/B split, no longer show up as that number's clicks. - "Open in the app" (auto mode) now takes the known apps from the shared
hop/safetyDeepLinks. Same apps, same addresses, but stricter, and every case below is a plain redirect (the page opens as before), never an error: onlyhttps://destinations are deep-linked (anhttp://one no longer is); the host must match a whole name (evilzoom.usis notzoom.us) and may not carry a port or user info; YouTube is limited to watch, playlist, shorts, live andyoutu.belinks (a channel page is a plain redirect); an X post with a suffix (/user/status/123/photo/1) and a Spotify link with extra segments after the id are plain redirects too; and every piece of the destination is percent-encoded into the Androidintent://address, so;,=and spaces of a typed address cannot add Intent fields. The custom mode (the owner types the app address) is unchanged. The edit page says "not recognised" for anhttp://destination.
v2.2.0
Added
- PayHop (pay.hel.ink) joins the family: it is named in the FAQ, the features page, the home page and the sign-in text in nine languages, in the READMEs and on the Pages site, and
payhop,payand thepayhop-prefix are reserved usernames (payhopalso a reserved slug). - The silent account re-check of
hop/auth: the home page,/qr,/changelogand the public pages that show the account (and every signed-in page) confirm with the hub, at most every five minutes, that the account in this session is still the one signed in there. Switching accounts at the hub no longer leaves the old account here.HOP_RECHECK=falseturns it off; short link redirects never do it. /changelogreadsstorage/app/changelog.jsonwhen it exists;update.shbuilds it from GitHub on each update (needs python3 and an authenticatedgh, otherwise the committedresources/changelog.jsonstays in use).scripts/build-changelog.py --out(alias--output, as in the hub) writes it anywhere./qr, a guest page that makes QR codes in the browser: Wi-Fi (WPA/WPA2/WPA3, WEP, open, hidden), a contact card (vCard 3.0) and a link or text, with colour, dot and corner shapes, a centre logo, scan advice (contrast, logo size, density, print size), PNG and SVG download, and a printable table card for A6 or A5 in nine languages (the card texts are a first draft for native speakers to review). The page has no form and no POST route; what is typed is never sent to the server or logged. It loads the vendoredqr-code-stylingand no CDN, and hands the library UTF-8 bytes, which the library does not do itself (non-Latin text decoded as garbage otherwise).- A "QR codes" link in the public top bar and in the account menu, and texts on the link page and the edit page: the code holds the short address, so a new destination keeps the printed code working, and a new slug does not (a warning shows as soon as the slug is edited).
DynamicQrTestlocks that behaviour;tests/jschecks the payload builders and reads every payload back from a rendered code with jsQR (a dev dependency only; workflowqr-js).npm run test:js.
Changed
- hop-assets v9 (PayHop's tile, mark, 3D preset and name font):
public/hop-home/andpublic/hop-brand/are refreshed from the hub, andscripts/sync-hop-assets.shtakes the app list from the manifest instead of a hand-written one.hop/ui^0.4.0andhop/auth^0.2.0are the tagged releases. /sitemap.xmllists only pages on the host that serves it (it listedhel.inkURLs fromlink.hel.ink), androbots.txtno longer carries a "last updated" date.- The public error pages (404, 429, link not found or expired, link ended or not live yet) use the family look: the marketing shell with the visitor's light or dark theme, the standard buttons, no uppercase eyebrow and no round logo; the 500 page follows the same look and still renders without the CSS build. Their texts were already in nine languages.
/changes/short-linksis translated in nine languages (it was English only).qr,wifi,vcard,pay,split,send,secretandembargoare reserved slugs, so the words other HOP apps use cannot become a new short link or bio slug. A link that already has one of them keeps working and can be edited while it keeps its slug; only a new slug or a change of slug is refused.hop/authis pinned to^0.1.5andhop/safetyto the release^0.1.0(it followeddev-main).hop/uiis unchanged.scripts/sync-hop-assets.shcopies the hop-assets version the HEL.ink manifest names (and the full v8 file set), not a fixedv3.scripts/build-changelog.pylists FileHop among the public apps.- The translated READMEs mention FileHop in the family list.
Removed
- Six README screenshots and two files (
docs/social.jpg,docs/assets/tile.svg) that nothing referenced.
Fixed
- The guest form on the home page: a tidier layout with one height and radius for the link field and Shorten, a row of its own for the Turnstile check that opens only when Cloudflare asks for a click (it no longer overlaps the rows below), Advanced on the left and sign-up on the right of one row, and the expiry note under a hairline. Tests pin the form's Alpine wiring and that a missing or empty token is refused;
scripts/check-turnstile.mjs(CI workflowturnstile) loads the page in a browser and requires the widget to render.
Changed
- Home boxes are proportional: the engine, motion and bento files are the hop-assets v8 copies (byte-identical). The five family tiles sit in one row of five from 1100 px up (equal boxes of about 215 px), a 3 + 2 bento on tablets and two columns on phones with the last tile spanning both; the 3D art is capped at 160-200 px (130 px on phones) and the gate scenes at 140 px. The block grid on the BioHop home page keeps two boxes per row beside the phone.
Changed
- Boxes on the home page (and the features page) are laid out by the shared
hop-bentogrid from hop-assets v7 (byte-identical copies ofhop-bento.css,hop-motion.js,hop-hero3d.js): whole rows for any box count, a calm reveal, a pointer spotlight and scenes that only run while a box is on screen. The family tiles settle in all five slots now that the v7 engine keeps unsettled scenes drawing. - The "Part of the HOP family" section on the home page uses the hop-assets v6 3D engine (byte-identical copy, so the LinkHop and BioHop marks are the new ones) and the v6 WebP fallbacks for every app, FileHop included; the section number and eyebrow are gone. The tiles are five across on wide screens, a 3 + 2 bento on tablets and two columns with the last tile spanning both on phones, so no tile sits alone on the last row. The three content-warning gates on the LinkHop home page do the same at tablet width.
Changed
- Every app shows the family row as the first row inside its footer, for everyone and in both looks: the HOP ID mark and "Part of Hop Easy Link" (linking to hel.ink). "Part of" is translated in all nine languages; the name stays in English. It replaces the strip that only the Clean style showed.
- The footer no longer has a language row; the language menu in the top bar is the one place to switch. The copyright line is right-aligned on desktop and centred on phones.
- Signing out sends the person to the hub with
return=<this app's home>, so the hub's chained logout can bring them back here instead of to the hub's home.
Fixed
- The
/changelogpage lists every merged pull request and tag again. The snapshot was never rebuilt for a release, and the build script read a staleorigin/main; it now fetches first, andscripts/build-changelog.py --check(run on release branches in CI) fails when a merged PR or tag is missing.