[GH-ISSUE #2511] Tag variable mentioned in the docs "$tags" does not work. "$Tags" does work (maybe) #1506

New issue

Open

opened 2026-03-02 11:57:44 +03:00 by kerem · 0 comments

kerem commented

2026-03-02 11:57:44 +03:00

Owner

Originally created by @BryanWall on GitHub (Feb 23, 2026).
Original GitHub issue: https://github.com/karakeep-app/karakeep/issues/2511

Describe the Bug

The documentation says:

You can use the placeholders $tags, $aiTags, $userTags in the prompt.

When I use "$tags" in a custom tagging rule, AI tagging does not work. I tried "$Tags" and tagging does work. This behavior changed in some way in 0.31.

While troubleshooting this issue I noticed that in the Prompt Preview section of AI settings it says:

Preview the actual prompts sent to AI based on your settings

Is what is shown in the prompt preview actually what is sent at the prompt? The tag variables are not expanded in the preview, so either the tag variables aren't really working, or what is shown in the preview isn't what is actually sent.

Are the API requests logged anywhere for debugging? I was wondering if the "$tags" variable possibly wasn't being expanded properly in the API request, but I don't see any way to view the actual prompt being sent.

Steps to Reproduce

Create custom tagging rules using "$tags". Example:

Check if any of the previously used tags are relevant for this content. Reuse them when appropriate to maintain consistency.
Here are the previously used tags that you should prioritize when appropriate: $tags

Expected Behaviour

Tags should be created

Screenshots or Additional Context

No response

Device Details

No response

Exact Karakeep Version

v0.31.0

Environment Details

Docker on Unraid

Debug Logs

No response

Have you checked the troubleshooting guide?

I have checked the troubleshooting guide and I haven't found a solution to my problem

Originally created by @BryanWall on GitHub (Feb 23, 2026). Original GitHub issue: https://github.com/karakeep-app/karakeep/issues/2511 ### Describe the Bug The [documentation](https://docs.karakeep.app/configuration/environment-variables/#inference-configs-for-automatic-tagging) says: > You can use the placeholders $tags, $aiTags, $userTags in the prompt. When I use "$tags" in a custom tagging rule, AI tagging does not work. I tried "$Tags" and tagging does work. This behavior changed in some way in 0.31. While troubleshooting this issue I noticed that in the Prompt Preview section of AI settings it says: > Preview the actual prompts sent to AI based on your settings Is what is shown in the prompt preview _actually_ what is sent at the prompt? The tag variables are not expanded in the preview, so either the tag variables aren't really working, or what is shown in the preview isn't what is actually sent. Are the API requests logged anywhere for debugging? I was wondering if the "$tags" variable possibly wasn't being expanded properly in the API request, but I don't see any way to view the actual prompt being sent. ### Steps to Reproduce Create custom tagging rules using "$tags". Example: 1. Check if any of the previously used tags are relevant for this content. Reuse them when appropriate to maintain consistency. 2. Here are the previously used tags that you should prioritize when appropriate: $tags ### Expected Behaviour Tags should be created ### Screenshots or Additional Context _No response_ ### Device Details _No response_ ### Exact Karakeep Version v0.31.0 ### Environment Details Docker on Unraid ### Debug Logs _No response_ ### Have you checked the troubleshooting guide? - [x] I have checked the troubleshooting guide and I haven't found a solution to my problem