Linkwarden widget: "tags" field empty — API returns paginated object, not array

[caplam]

Description

The Linkwarden widget shows links and collections counts correctly, but the tags block is always empty (no value displayed, no error shown).

The widget (src/widgets/linkwarden/component.jsx) expects GET {url}/api/v1/tags to return a raw array:
const tags = tagsStatsData?.response ?? tagsStatsData;
const tagsTotal = Array.isArray(tags) ? tags.length : null;

The current Linkwarden API returns a paginated object instead:
{"data": {"tags": [{"id": 496, "name": "squeezebox", ...}]}}

So Array.isArray(tags) is false → tagsTotal = null → the block stays empty. /api/v1/collections still returns a raw array, which is why collections works.

Suggested fix (handle both shapes):

const tags = tagsStatsData?.response ?? tagsStatsData?.data?.tags ?? tagsStatsData;

homepage version

v2.0.0 (17456f2, Aug 14, 2026)

Installation method

Docker

Configuration

Linkwarden discovery by tag in compose file:

homepage.group: "Cloud Services"
homepage.name: "Linkwarden"
homepage.widget.type: "linkwarden"
homepage.widget.url: "http://linkwarden.local.domain.tld:3000"
homepage.widget.key: "<access-token>"

Container Logs

no widget-specific errors in the homepage container logs — the tags block is simply empty (no fetch error surfaced by the widget).

Browser Logs

no browser console errors observed.

Troubleshooting

verified the API response shape directly

• GET /api/v1/tags (with the widget's Access Token) returns {"data": {"tags": [...]}} (paginated)
• GET /api/v1/collections returns a raw array.
  Reproduced the widget logic (Array.isArray check) against the real response → tagsTotal is null.

[shamoon]

Thanks, seems like their API changed again, should be easy enough to handle.

#7018

[github-actions[bot]]

This discussion has been automatically closed because it was marked as answered. See our contributing guidelines for more details.