Commit Graph
155 Commits
Author SHA1 Message Date
Abdon Pijpelink 7590063d83 Read-write contention troubleshooting guide (#2421)
* New r/w contention troubleshooting guide

* Add snippet to low latency search guide

* Add FAQ entry

* Add 'Read More' section to guide
2026-06-23 16:04:13 +02:00
Abdon PijpelinkandClaude Sonnet 4.6 ffe50340fa Edge 0.7 documentation updates (#2391)
* docs(edge): add "Modify the Vector Schema" step to quickstart

Documents the new Edge 0.7 API for adding and removing named vector
fields on an existing shard without recreating it, with Python and
Rust snippets.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* docs(edge): mention quantization support in quickstart

Adds a note after the EdgeConfig snippet that Edge supports all four
quantization methods (Scalar, Product, Binary, TurboQuant), with a
link to the quantization guide.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* docs(edge): add On-Device BM25 page for Edge 0.7

New guide covering the built-in BM25 sparse embedder: configuring a
sparse vector shard, creating a Bm25/EdgeBm25 embedder, embedding and
upserting documents, and querying. Includes Python and Rust snippets.
Also adds the page to the Edge index navigation table.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* docs(edge): add WAL segment size configuration to quickstart

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Upgrade code snippets to Edge 0.7.2

* Review feedback

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-03 15:51:20 +02:00
9ba29ff4fa New tutorial: "Secure a Self-Hosted Qdrant Instance" (#2385)
* Initial commit

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Edits

* Edits

* Fix links

* Use 'true' instead of '1' in QDRANT__SERVICE__ENABLE_TLS example

* Review feedback

* Add link from Security page

* Update stack designation on overview page

* Update qdrant-landing/content/documentation/tutorials-operations/secure-qdrant.md

Co-authored-by: István Zoltán Szabó <szabosteve@gmail.com>

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: István Zoltán Szabó <szabosteve@gmail.com>
2026-06-01 16:09:56 +02:00
Dylan Couzon 829e187767 Merge pull request #2380 from qdrant/git-indexing
add: Branch-Aware Search
2026-05-29 12:17:42 -04:00
Dylan Couzon 26ea463cf1 new design 2026-05-28 00:19:34 -04:00
Abdon PijpelinkandClaude Sonnet 4.6 72ea635755 Update Security docs (#2368)
* Rewrite security page intro to be feature-forward

Replaces the generic opening paragraph with one that names each security
feature (API key auth, read-only keys, JWT RBAC, network binding, TLS,
audit logging) and links directly to their sections, so scanning readers
see the full capability surface before hitting the warning block.

Also updates the checklist items to surface read-only keys and JWT RBAC
as explicit options under Authentication.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Add Security FAQ section to Qdrant Fundamentals

Adds three new Q&A entries covering default security posture, read-only
API keys, and JWT collection-scoped access control — the exact questions
users ask in Discord. Also adds Security to the page nav table and fixes
the heading depth on the collection-per-user entry (## → ###).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Add Security section to production checklist

Inserts a new section 2 covering the five key security steps — API key
auth, read-only keys, JWT access control, TLS, and network binding —
with direct links to the Security page. Renumbers existing sections
2–4 to 3–5. Closes the gap where a user following the checklist
step-by-step could go to production with an open, unauthenticated instance.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Link production checklist from both quickstart pages

Adds a production checklist callout to the "Next Steps" section of the
local quickstart and a bullet to the "What's Next?" section of the cloud
quickstart, so users completing either tutorial have a clear path to
production readiness.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Make code snippets testable

* Lead Security page by listing all the features; Rename API keys->Admin API keys, and 'Granular Access Control with JWT' section into 'Granular Access API Keys'

* Update links

* Update meta description

* Fix C# snippet

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-27 15:56:52 +02:00
Dylan Couzon 7b20d2ec9e add navigation links 2026-05-26 19:19:47 -04:00
Abdon Pijpelink 04e3e0bb1d Add named vectors scenario to embedding migration tutorial (#2348)
* Initial commit

* Edits

* Update FAQ

* Edits

* Mention required versions
2026-05-26 09:38:24 +02:00
Dylan Couzon e6f688d10a Merge pull request #2362 from qdrant/with_lookup-example
Add with_lookup example
2026-05-21 11:04:34 -04:00
Dylan Couzon 844042032f Merge pull request #2357 from qdrant/hybrid-search-gap-3
Document fusion methods: weighted RRF, DBSF, FormulaQuery
2026-05-20 12:48:26 -04:00
Dylan CouzonandClaude Opus 4.7 bbb09d9310 Give chunk 1 array document_id in ingest example
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-20 12:35:05 -04:00
Dylan CouzonandClaude Opus 4.7 0ead6b8f8b Disambiguate document ids in with_lookup example
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-20 11:35:38 -04:00
Abdon PijpelinkandTim Visée cf94245089 Increase payload indexing advice visibility (#2360)
* Add new 'Create a Payload Index' section

* Add indexing tip to low latency search, search, and filtering docs

* Add bash code snippet

* Edits

* Update qdrant-landing/content/documentation/manage-data/indexing.md

Co-authored-by: Tim Visée <tim@visee.me>

---------

Co-authored-by: Tim Visée <tim@visee.me>
2026-05-20 10:05:33 +02:00
Dylan CouzonandClaude Opus 4.7 a6104d7b7a Add worked with_lookup example
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-19 19:08:36 -04:00
Abdon Pijpelink 97b3a05c5f Reorganize search tutorials (#2352)
* Restructure search tutorials

* Deleted moved tutorial

* Re-instate deleted frontmatter

* Fix links to moved files

* Move code search and build tutorials to 'Develop&Implement' section

* Update landing pages too

* Fix broken links
2026-05-19 16:38:52 +02:00
Dylan CouzonandClaude Opus 4.7 c0128a53bc Apply adversarial-review fixes to hybrid-queries and snippets
Address findings from a code-bot adversarial review of the hybrid-search
materials:

- `hybrid-formula-decay/` (all 7 language sources + http.md +
  `_description.md`): wrap the decay term in `MultExpression(mult=[0.1, ...])`
  in every language. Previously the snippets summed `$score` with
  `ExpDecayExpression` directly, modeling the failure mode the docs
  explicitly warn against (un-weighted decay crowds out small RRF scores).
  Also document the `defaults` requirement and the recommended datetime
  payload index in `_description.md`. Build validated across all 6 SDKs.

- `hybrid-rrf/go.go`: add `Limit: qdrant.PtrOf(uint64(20))` to both
  prefetches so the Go snippet matches the other language tabs.

- `hybrid-queries.md`:
  - Reframe the weighted-RRF intro to drop "semantic search model
    understands meaning better than a simple keyword matcher". On
    SciFact (the corpus in the companion notebook) BM25 actually beats
    dense, so the universal claim was contradicted by our own data.
  - Clarify that the notebook provides a tuning helper to adapt to a
    train/val split, not that it demonstrates the split itself.
  - Add a one-line note that Qdrant uses zero-based rank positions so
    readers can verify the RRF formula against actual scores.
  - Apply brand-voice fixes: Title Case on "Multi-Stage Queries" and
    "Re-Scoring Examples", replace "all the above techniques" with
    "all of these techniques".

`generated/*.md` regenerated via `./docker.sh ./generate-md.py`.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-15 21:54:47 -04:00
Dylan CouzonandClaude Opus 4.7 fc299a0e9c Switch hybrid-rrf snippets to RrfQuery API
Replaces the older `FusionQuery(fusion=Fusion.RRF)` enum form with
`RrfQuery(rrf=Rrf())` across all language tabs (Python, TypeScript,
Rust, Go, Java, C#) plus the REST body in `http.md`, for both the
`hybrid-rrf/` snippet and the inner RRF prefetch inside
`hybrid-formula-decay/`. The newer dedicated `Rrf` message is the
recommended path going forward; the old enum stays supported for
backward compatibility. Server-side both forms converge to the same
`FusionInternal::Rrf { k: 2, weights: None }`, verified against the
qdrant/qdrant source.

`generated/*.md` files in both directories regenerated via
`./docker.sh ./generate-md.py`. `./docker.sh ./check.py build` passes
across all six SDKs.

Also softens the DBSF prose in hybrid-queries.md to drop the
"weighted RRF tends to win" framing. Neither method dominates the
other in general.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-15 21:04:09 -04:00
Dylan Couzon 8cdce983ed upload snippets 2026-05-15 16:49:56 -04:00
Dylan Couzon 1d36116d77 Merge pull request #2334 from qdrant/hybrid-search-gap-2
Multi-representation search tutorial + supporting doc cross-links
2026-05-15 14:17:28 -04:00
brone1323andAbdon Pijpelink 5aa98e5959 fix(docs): correct C# MatchExcept snippet (was using Match instead of MatchExcept) (#2345)
* fix(docs): correct C# MatchExcept snippet to use MatchExcept instead of Match

The C# code example in the match-except filter condition snippet was
incorrectly using Match() instead of MatchExcept(), making it identical
to the match-any example. This is misleading for developers trying to
implement the MatchExcept (NOT IN) filter condition in C#.

Fixes #1656

* Add Markdownified code snippet

---------

Co-authored-by: Abdon Pijpelink <abdon.pijpelink@qdrant.com>
2026-05-12 10:26:57 +02:00
Dylan Couzon d21b5a5435 Merge pull request #2305 from qdrant/retrival-quality-guide-improvement
docs(tutorials): split retrieval-quality into three evaluation layers
2026-05-11 11:55:53 -04:00
Abdon Pijpelink cba308dc31 Fix tracing ID Python snippet import 2026-05-11 11:32:10 +02:00
46e81449a8 Add TurboQuant quantization documentation (v1.18.0) (#2313)
* Add TurboQuant quantization documentation (v1.18.0)

Adds a new TurboQuant section to the quantization guide covering the
four encoding options (bits1/bits1_5/bits2/bits4), automatic asymmetric
quantization, distance metric support, and the automatic TQ+ precision
enhancement for sealed segments. Updates the comparison table and
method-selection guidance to recommend TurboQuant over Binary and
Scalar Quantization for new collections. Adds HTTP-only snippets for
basic setup and explicit bit-depth selection.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Consistently use title case for headers

* Restructure doc to lead with TurboQuant

* Clarify rescoring

* Edits

* Soften TQ advice

* Updates

* Fix

* Apply suggestions from code review

Co-authored-by: Jojii <15957865+JojiiOfficial@users.noreply.github.com>

* Review feedback

* Add Go/Java/C# code snippets

* Add list of 4 quantization methods to introduction

* Review feedback

* Stronger advice for TQ4

* Add Python snippets

* Add Rust snippets

* Add TS snippets

* Update recommendation table

* Update production checklist

* Remove link to article

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: Jojii <15957865+JojiiOfficial@users.noreply.github.com>
2026-05-11 08:13:03 +02:00
Abdon Pijpelink 506639965d Add Rust snippets for adding/removing named vectors 2026-05-07 10:25:37 +02:00
Abdon Pijpelink cb585a1fce Add TS snippets for adding/removing named vectors 2026-05-07 09:46:50 +02:00
Abdon Pijpelink 483b384421 Add Python snippets 2026-05-07 09:36:00 +02:00
Dylan Couzon 67ebec2831 add sidebar + menu references 2026-05-05 09:57:35 -04:00
Abdon Pijpelink 46fc4f0350 Add Go/Java/C# snippets for named vector CRUD 2026-05-04 14:44:48 +02:00
Abdon Pijpelink 0fc11c07de Documentation for the Query Audit Logs API (#2232)
* Documentation for the Query Audit Logs API

* Add missing empty request body

* Review feedback
2026-05-04 13:33:57 +02:00
Dylan CouzonandClaude Opus 4.7 9fbcd1adad Rename retrieval-quality slugs to match tutorial scope
Tutorial slugs now match their content:
- retrieval-quality/ -> ann-recall/ (alias preserves the old published path)
- retrieval-quality-golden-set/ -> retrieval-relevance/
- retrieval-quality-pipeline-output/ -> pipeline-output-quality/

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-30 16:32:46 -04:00
ecd4887576 Document new strict_mode_config parameters (v1.18.0) (#2303)
* Document 7 missing strict_mode_config parameters

Adds documentation sections and code snippets (Python, TypeScript, Rust,
Go, Java, C#, HTTP, bash) for search_allow_exact, search_max_hnsw_ef,
search_max_oversampling, search_max_batchsize, max_resident_memory_percent,
multivector_config, and sparse_config.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Use title case for all headers

* Update qdrant-landing/content/documentation/ops-configuration/administration.md

Co-authored-by: Tim Visée <tim@visee.me>

* Mention default strict mode on Cloud; Clarify behavior of only setting enabled=true

* Apply suggestion from @timvisee

Co-authored-by: Tim Visée <tim@visee.me>

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: Tim Visée <tim@visee.me>
2026-04-30 20:25:21 +02:00
Dylan CouzonandClaude Opus 4.7 33bd663d80 Move retrieval relevance and pipeline-output tutorials to Improve Search
Splits the three retrieval-evaluation tutorials across two sections.
ANN Recall (Web UI, language-agnostic) stays under Search Engineering.
The two Python ecosystem tutorials (ranx, ragas) move to a new top-level
Improve Search section under the Ecosystem partition.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-30 12:30:08 -04:00
Abdon Pijpelink 10b98c3ca2 Docs for adding/removing named vectors (#2282)
* Initial commit

* Switch to title case for Collections page

* Move to Collections page

* One more clarification

* Update section title
2026-04-30 09:03:48 +02:00
Dylan CouzonandClaude Opus 4.7 9f4b4c05ea Rename ANN precision tutorial to ANN recall
Recall@k is the standard metric for ANN benchmarks. Rename the
tutorial title, headings, helper function, and prose; update the
recent inline edits and merge sentence; and update cross-links from
the relevance and pipeline-output tutorials and the tutorials index.
Generic Precision@k mentions in the ranx metric list are unrelated
and left alone.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-29 15:00:06 -04:00
Dylan CouzonandClaude Opus 4.7 6c10996b66 rename Building a Golden Query Set to Measuring Retrieval Relevance
Aligns the layer-2 tutorial title with the parallel "Measuring X" /
"Evaluating X" pattern used by the other two and maps directly to the
four-layer framework. Slug stays the same to preserve URLs and the
golden-set artifact identity in the path. Also updates the nav descriptions
to reflect the tutorial's full scope (build + score, not just build).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-23 23:29:44 -04:00
Dylan CouzonandClaude Opus 4.7 e02bfb0bf1 delete retrieval-quality-fundamentals and remove from nav indexes
The four-layer framework, metric-selection table, and business-impact
guidance now live inside the three execution tutorials. The fundamentals
page is no longer needed as a shared reference and readers don't have to
leave the tutorial flow to get context.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-23 23:22:40 -04:00
Dylan Couzon 7a4129be1e add third guide + update indices 2026-04-23 20:23:10 -04:00
Dylan Couzon 1fbc73c4b2 Merge branch 'master' into retrival-quality-guide-improvement 2026-04-23 12:24:29 -04:00
Dylan Couzon 340c6528ca Clean up, tone 2026-04-23 11:06:18 -04:00
Abdon PijpelinkandClaude Sonnet 4.6 c4ee144773 Document audit logging tracing ID support (v1.18.0) (#2287)
* Document audit logging tracing ID support (v1.18.0)

Add a "Tracing IDs" subsection to the Audit Logging section of security.md,
and code snippets for all six client SDKs showing how to attach an
x-request-id header to requests so it appears in audit log entries.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Small edits

* Don't hide imports in Python snippet

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-23 09:44:02 +02:00
Dylan Couzon 92af150b00 retrieval-quality: rename to "Measuring ANN Precision"
- Update title, H1, and Time in retrieval-quality.md
    (30 min -> 15 min reflects the pivot to Web UI)
  - Rename references in tutorials-lp-overview.md and the headless
    tutorial index; swap the pill from Python to Web UI to reflect
    the new primary flow
  - Replace "ANN recall" with "ANN precision" in Fundamentals
    (4 places: intro, comparison note, ladder table, cross-link)
    and in the golden-set tutorial's layer-1 cross-reference
  - Filename kept as retrieval-quality.md so existing URLs and
    aliases still work
2026-04-22 17:13:27 -04:00
Abdon Pijpelink 434a451c2b Update Hybrid Search with Reranking tutorial (#2274)
* Update for Cloud Inference and data ingestion

* Fix link

* Review feedback

* Make code snippets testable

* Add C# code snippets

* Add Go code snippets

* Add Java code snippets

* Add Rust code snippets

* Add TS code snippets

* Move CSV streaming/parsing to separate function
2026-04-22 11:03:05 +02:00
Dylan Couzon bb8cac5a6e update completion times 2026-04-21 12:00:10 -04:00
kanungleandAbdon Pijpelink 544708f293 Restructure Docs - Stage 4a (#2280)
* create Develop and Deploy tabs; move Operations; re-weight pages

* move capacity planning page; create section dropdown content

* added aliases to frontmatter

* update link references to new canonical links; maintain anchoring

* address remaining link issues and errors

* fix outlier tutorial reference issue

* Treat 'develop' and 'deploy' as a unified search space

* fix some frontmatter aliases

* add section header redirects

* fix 'Operations' redirect to go to 'Deploy' tab

* update redirects file for * pattern

* add :splat to redirect references

* Add wildcard to each entry in _redirects file

---------

Co-authored-by: Abdon Pijpelink <abdon.pijpelink@qdrant.com>
2026-04-20 18:03:45 +02:00
Dylan CouzonandClaude Sonnet 4.6 52a38d255c Link new retrieval quality tutorials from navigation indexes
Updates both search engineering index files (the headless partial and
the tutorials-lp overview) to list Retrieval Quality Fundamentals and
Building a Golden Query Set alongside the existing Retrieval Quality
Evaluation row. The Evaluation row is also retitled from "Measure
quality and tune HNSW parameters" to "Measure ANN recall and tune
HNSW parameters" to match the refactored page.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-20 10:47:02 -04:00
Derrick MwitiandAbdon Pijpelink dc564bbab0 Time based sharding tutorial (#1805)
* add snippets

* add snippets

* add snippets

* add snippets descriptions

* Initial commit

* Updated tutorial

* Expand on shard_number

* Add sentence about optimal batch size

* Show how to query multiple shards

* Small edits

* Fixes

* Add to landing page; adjust weight

* Clean up code snippets

* Don't set shard_key in code snippet

* Review feedback

* Update links to moved pages

* Add C# code snippets

* Add Go code snippets

* Add Java code snippets

* Add Rust code snippets

* Add TS code snippets

* Add note about changing collection settings

* Move CSV parsing to separate function

* Trigger Build

* Remove unused dependency

---------

Co-authored-by: Abdon Pijpelink <abdon.pijpelink@qdrant.com>
2026-04-16 22:19:08 +02:00
Abdon Pijpelink 5705d7e2a2 Fix HTTP code snippets (#2231) 2026-04-07 11:35:51 +02:00
1a40961d62 fix: linkchecker include filter port mismatch (#2242)
* initial commit; fixed anchor links on internal docs pages

* add back in absolute paths for links in code comments

* fix: update linkchecker include filter to match server port 1314

PR #1629 changed the Hugo server to port 1314 but forgot to update
the --include filter, which still matched port 1313. This caused all
links to be excluded, making the checker a no-op (0 checked, 82277 excluded).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Fix url rewrite regex so images are not impacted

* Fix links from non-documentation pages

* Fix broken links

* more broken links

* more broken links

* broken link

* Add srcset width descriptor to .lycheeignore

* Ignore URLs that contain a % character

* Anchor regex so it matches the entire URL

---------

Co-authored-by: kanungle <neil.kanungo@gmail.com>
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-authored-by: Abdon Pijpelink <abdon.pijpelink@qdrant.com>
2026-03-30 17:21:32 +02:00
Abdon Pijpelink 0c49e9d0ef Docs for prevent_unoptimized (#2237) 2026-03-27 17:36:43 +01:00
Mohamed ArbiandAbdon Pijpelink c0db45ed8f Fix Docs : minor grammar fixes (#2218)
* fix(docs): fix typos and some links in documentation

* fix(docs): correct typo in filtering.md

* Update qdrant-landing/content/documentation/headless/snippets/inference/jinaai-upsert/generated/typescript.md

Co-authored-by: Abdon Pijpelink <abdon.pijpelink@qdrant.com>

* Update qdrant-landing/content/documentation/headless/snippets/inference/multiple/generated/typescript.md

Co-authored-by: Abdon Pijpelink <abdon.pijpelink@qdrant.com>

* Update qdrant-landing/content/documentation/hybrid-cloud/configure-scale-upgrade.md

Co-authored-by: Abdon Pijpelink <abdon.pijpelink@qdrant.com>

* Update qdrant-landing/content/documentation/cloud-api.md

Co-authored-by: Abdon Pijpelink <abdon.pijpelink@qdrant.com>

---------

Co-authored-by: Abdon Pijpelink <abdon.pijpelink@qdrant.com>
2026-03-26 17:23:36 +01:00