Tokr for Craft CMS

FAQ

What does it cost?

$99, one-off, per production environment. There is no free tier, no renewal, and no feature gating — the plugin you install is the whole plugin.

Does it work with any TikTok account?

Any account you can log into. Tokr uses TikTok's official Login Kit, so connecting means signing in as that account and granting access. There is no way to pull a feed for an account you do not control — that is a TikTok restriction, not a Tokr one, and no plugin can work around it.

Can I show several accounts?

Yes. Connect as many as you like and point a feed at each. Nothing is limited by edition.

Does it embed TikTok's own widget?

No. Tokr stores the video metadata and renders your own markup, so the feed inherits your CSS and costs you no third-party JavaScript. The optional lightbox does use TikTok's official embed iframe, and only loads it once someone clicks a video.

Will it slow my site down?

No. Videos live in your database and are read like any other query. TikTok's API is only contacted by the refresh cycle — a queue job or a cron run — never in the middle of rendering a page.

Why do thumbnails expire?

TikTok's cover image URLs are signed and stop working roughly six hours after they are issued. Tokr refreshes them before that happens. This is why the refresh interval is capped at five hours, and it is the one operational thing worth understanding. See Troubleshooting.

Can I download the videos?

No, and you should not want to. The Display API gives metadata and a cover image; re-hosting someone's video is a licensing problem. Tokr links to TikTok or embeds their player.

Does it work with private or unpublished videos?

No. The Display API returns public videos only.

What happens if TikTok is down?

Your feed keeps rendering. It renders from your database, so an outage means the videos stop updating — visitors see no difference.

Do I need my own TikTok developer app?

Yes. TikTok issues API credentials per app, tied to the app owner, so there is no shared key a plugin could ship. Setting one up is free; see Installation.

Can I change the markup?

Three levels of it:

  1. Feed settings, for layout and what is shown
  2. _tokr/feed.twig in your templates, to replace the markup and keep the behaviour
  3. craft.tokr.videos() and write everything yourself

See Usage.

Does it support Craft 4?

No. Tokr is Craft 5.3+ only.

Is there a GraphQL API?

Not in 5.0.0.