Skip to main content

How do I search documents by several metadata fields at once?

Use FormKiQ's supported attribute-search operations to express the combination of fields you need, with types and indexes appropriate to the query. Composite keys support configured multi-field access patterns; they do not make every arbitrary filter equivalent. Full-text combinations depend on the selected search backend. Follow pagination tokens to retrieve the complete result set.

Design around a real query​

Write the business question first: find invoices for a selected vendor and accounting period, for example. Define stable attribute keys and consistent value formats. Preserve numeric values as numbers rather than strings when numeric comparisons are required.

Use the multi-attribute tutorial to configure the attribute filters and optional composite-key structure for the actual access pattern. Check the API schema for supported operators, ordering, and combinations. A JSON object's nested-field query is a different request shape from a regular attribute search.

Prove completeness​

Create documents that match all fields, only some fields, and boundary values. Confirm the response contains only the intended matches. Treat returned continuation tokens as opaque and follow next using the same filters and site until no continuation remains.

When combining content text with metadata, use an operation supported by the installed backend. Measure latency and pagination under representative volume before promising interactive reports from an unbounded search.

Edition and configuration​

Structured metadata search is available in Core. Multi-attribute filtering and composite-key selection are version-specific; OpenSearch is a separate Advanced/Enterprise extension. Check the installed release rather than inferring support from the SDK alone.

Continue with the detailed guides​

Privacy settings

Analytics is optional. Your analytics choice is shared with formkiq.com and remembered for up to six months. Change it here at any time.

Essential preferences and search

We remember your privacy choice and display preferences. Search runs in your browser using Pagefind files hosted with the docs. It works whether you accept or reject analytics.

Measure page views and installation-link clicks. This does not enable advertising on the docs. Existing marketing choices for the main website are kept unchanged.

Read the docs privacy notice or manage other main-website privacy choices.