How to put a value in custom CQL field?

Question

Hey,
I just did this tutorial about adding a custom CQL field to Confluence: https://developer.atlassian.com/server/confluence/adding-a-field-to-cql/

That’s no problem, but how the hell do I put values in custom CQL fields?
There is nothing written in the tutorial that would help and I can’t see any option to put values in those field in the Confluence backend.

I don’t think this is a hard question… But I can't fiend any answer...

Hauke Hörhold · Answer

Thanks for your reply.

But I'm using labels for other stuff on my site  so that's no option.

I just need some custom field on each page where I can put information in that can be changed via User Macros and can be searched by CQL queries.

So I thought that's what CQL field do, but I didn't get how to put or change their content (via user macro).

Best regards

Edit:

Here somebody told me how to put information in CQL fields: https://community.developer.atlassian.com/t/how-to-use-custom-cql-fields/29965/2

But how can I change my custom CQL field content via a User Macro?

Now I'm using $contentPropertyManager.setTextProperty($content, "Info1", $paramInfo1) in a User Macro for saving custom information with each page, but that's now searchable via CQL I think.

Stephen Sifers · Answer

Hello Hauke,

From what you're explaining, it sounds like you’d be better served by using labels on Confluence pages and searching via CQL for those labels. CQL is simply the Confluence Query Language that allows you to query pages. Labels are a field which CQL can be used on. Further information on labels may be found at Add, Remove and Search for Labels.

Here is the documentation which samples how to use CQL when searching for labels: https://developer.atlassian.com/server/confluence/cql-field-reference/#label.

I hope this new information proves helpful and you’re able to more easily search and find your content.

Regards,
Stephen Sifers

Hauke Hörhold · Answer

Hi,

thanks for your answer.

I want to have some searchable fields on each page, where I can put information in.

Because I want to filter my search results by that information in those searchable fields I added.

Now I'm saving some extra information for each page with the contentPropertyManager, but that's not searchable.

So I thought searchable CQL fields just sound like what I'm searching for, but I don't get it how they work.