Data & Services - Collections
Create and manage Solr search collections for full-text indexing
Overview
Collections in ColdFusion are Solr-based full-text search indexes that allow you to index and search documents, database content, and file system data. Collections provide powerful search capabilities including faceted search, highlighting, and relevance ranking.
Solr runs as a separate add-on service (with Jetty), which you install with the ColdFusion 2025 Add-on Services installer from Adobe's downloads page (the full installer also offers it as an option). The search tags also need the search package, which you can install with cfpm. All collections are created under the Solr Home directory set on the Solr Server page, and ColdFusion 2025 removed the path attribute of cfcollection and deprecated its language and engine attributes. If the Collections page cannot retrieve collections, make sure the Solr service is running.
Collection Operations
Manage Solr collections through the ColdFusion Administrator interface or programmatically.
Create Collection
language attribute of cfcollection is deprecated in ColdFusion 2025Index Collection
Optimize Collection
Optimizes the Solr index for better search performance by consolidating index segments and removing deleted documents. Run periodically after major index updates or bulk deletions to maintain optimal search speed.
Purge Collection
Deletes all documents in a collection but not the collection itself, so you can rebuild the index from scratch. The Administrator's collection actions are Reload, Index, Optimize, Purge, and Delete. The repair action of cfcollection is deprecated and does nothing.
Delete Collection
Permanently removes a collection and all its indexed data. This operation cannot be undone. Back up important collection data before deletion.
Creating Collections Programmatically
Use the cfcollection tag to create and manage collections in your application code:
// Create a new collection
cfcollection(
action = "create",
collection = "myDocuments"
);
// Verify collection was created
writeOutput("Collection 'myDocuments' created successfully!");<!--- Create a new collection --->
<cfcollection
action="create"
collection="myDocuments">
<!--- Verify collection was created --->
<cfoutput>Collection 'myDocuments' created successfully!</cfoutput>Indexing Strategies
Choose the right indexing approach based on your content source and update frequency requirements.
File System Indexing
Example: Index File System Directory
// Index all PDF and Office documents in a directory
cfindex(
action = "update",
collection = "myDocuments",
type = "path",
key = expandPath("/documents"),
extensions = ".pdf,.doc,.docx,.xls,.xlsx",
recurse = true,
urlpath = "https://example.com/documents"
);
writeOutput("Directory indexed successfully!");<!--- Index all PDF and Office documents in a directory --->
<cfindex
action="update"
collection="myDocuments"
type="path"
key="#expandPath('/documents')#"
extensions=".pdf,.doc,.docx,.xls,.xlsx"
recurse="true"
urlpath="https://example.com/documents">
<cfoutput>Directory indexed successfully!</cfoutput>Database Indexing
Example: Index Database Content
// Query articles to index
articles = queryExecute("
SELECT id, title, body, category, dateModified
FROM articles
WHERE dateModified > :lastIndexDate
", {
lastIndexDate: {value: lastIndexDate, cfsqltype: "cf_sql_timestamp"}
});
// Index the query results
cfindex(
action = "update",
collection = "articles",
type = "custom",
query = articles,
key = "id",
title = "title",
body = "body",
custom1 = "category",
urlpath = "https://example.com/article/"
);
writeOutput("#articles.recordCount# articles indexed!");<!--- Query articles to index --->
<cfquery name="articles">
SELECT id, title, body, category, dateModified
FROM articles
WHERE dateModified > <cfqueryparam value="#lastIndexDate#" cfsqltype="cf_sql_timestamp">
</cfquery>
<!--- Index the query results --->
<cfindex
action="update"
collection="articles"
type="custom"
query="articles"
key="id"
title="title"
body="body"
custom1="category"
urlpath="https://example.com/article/">
<cfoutput>#articles.recordCount# articles indexed!</cfoutput>Custom Programmatic Indexing
Example: Custom Document Indexing
// Index a custom document with metadata
cfindex(
action = "update",
collection = "products",
type = "custom",
key = productID,
title = productName,
body = productDescription,
custom1 = category,
custom2 = price,
custom3 = inStock ? "yes" : "no",
urlpath = "https://example.com/product/#productID#"
);
writeOutput("Product #productID# indexed successfully!");<!--- Index a custom document with metadata --->
<cfindex
action="update"
collection="products"
type="custom"
key="#productID#"
title="#productName#"
body="#productDescription#"
custom1="#category#"
custom2="#price#"
custom3="#inStock ? 'yes' : 'no'#"
urlpath="https://example.com/product/#productID#">
<cfoutput>Product #productID# indexed successfully!</cfoutput>Search Features
Leverage Solr's powerful search capabilities to build rich search experiences.
Full-Text Search
Search across all indexed content with automatic stemming and relevance ranking. Results are scored by relevance and can be sorted by score, date, or custom fields.
Field-Specific Search
Target specific fields in queries using field:value syntax. Example: title:ColdFusion searches only in title fields.
Boolean Operators
Combine search terms with AND, OR, NOT operators for complex queries. Example: ColdFusion AND (tutorial OR guide) NOT beginner
Wildcard Search
Use * and ? wildcards for partial matches. * matches multiple characters, ? matches single character. Example: Cold* matches "ColdFusion", "Cold", etc.
Phrase Search
Exact phrase matching using quotes. Useful for finding exact text sequences. Example: "ColdFusion Administrator" matches the exact phrase.
Proximity Search
Find terms within N words of each other using ~N syntax. Example: "ColdFusion tutorial"~5 finds documents where these words appear within 5 words.
Faceted Search
Category-based filtering with counts. Display facets for categories, tags, dates, etc. Enables drill-down filtering in search interfaces.
Result Highlighting
Automatically highlight search terms in results with context. Shows snippets of text where search terms appear for better relevance display.
Example: Search Collection
// Search for documents
results = "";
cfsearch(
name = "results",
collection = "myDocuments",
criteria = "ColdFusion tutorial",
maxrows = 10,
startrow = 1
);
// Display search results
writeOutput("<h2>Found #results.recordCount# results</h2>");
for (row in results) {
writeOutput("
<div>
<h3><a href='#row.url#'>#row.title#</a></h3>
<p>#row.summary#</p>
<p>Score: #row.score# | Size: #row.size# bytes</p>
</div>
");
}<!--- Search for documents --->
<cfsearch
name="results"
collection="myDocuments"
criteria="ColdFusion tutorial"
maxrows="10"
startrow="1">
<!--- Display search results --->
<cfoutput>
<h2>Found #results.recordCount# results</h2>
<cfloop query="results">
<div>
<h3><a href="#url#">#title#</a></h3>
<p>#summary#</p>
<p>Score: #score# | Size: #size# bytes</p>
</div>
</cfloop>
</cfoutput>Best Practices
Follow these guidelines for optimal collection management and search performance.
Collection Organization
Create separate collections for different content types or applications. Use meaningful collection names that reflect their purpose (e.g., "products", "articles", "documentation").
Regular Index Updates
Schedule regular index updates to keep content fresh. Use incremental indexing for large datasets to minimize resource impact.
Collection Optimization
Optimize collections periodically for better search performance. Run optimization during low-traffic periods to minimize user impact.
Language Analyzers
Use language-specific analyzers for better search quality. The Solr Server page lets you configure indexing languages (a language name and suffix); the language attribute of cfcollection is deprecated in ColdFusion 2025.
Monitoring
Monitor collection size and performance metrics regularly. Track index size, search response times, and memory usage to detect issues early.
Memory Allocation
Configure appropriate Solr memory allocation based on collection size. Increase Solr heap size for large collections or high search volumes.
Performance Tuning
Optimize Solr collections for maximum search performance and minimal resource usage.
Field Optimization
Limit the number of indexed fields to only what's needed for search. Use stored fields sparingly to reduce index size and improve performance.
Solr Cache Settings
Configure Solr cache settings for frequently accessed data. Tune filter cache, query result cache, and document cache sizes based on usage patterns.
Optimization Scheduling
Run optimization during low-traffic periods to avoid performance degradation. Optimization is I/O intensive and can temporarily impact search performance.
JVM Tuning
Monitor Solr heap usage and adjust JVM settings as needed. Set appropriate -Xmx and -Xms values, and tune garbage collection for large indexes.
Dedicated Server
Consider running Solr on a dedicated server for production environments. Isolating Solr improves reliability and allows independent scaling.
Index Size Management
Keep index sizes manageable by archiving old content. Split very large collections into multiple smaller collections for better performance.