Skip to content

Profile Options

profile.cfg is the main configuration file for a funnelback frontend.

The profile.cfg configuration file is created when a profile within a collection is created (though it is permitted to be empty or absent).


The locations of where these options can be read:

  • $SEARCH_HOME/conf/[collection]/[profile folder]/profile.cfg: This file is optional, options in this file have the highest precendence overriding values in all other files.
  • $SEARCH_HOME/conf/[collection]/collection.cfg: Options in this file provide defaults for all profiles within the collection.
  • $SEARCH_HOME/conf/collection.cfg: Options in this file provide defaults for all profiles in all collections.
  • $SEARCH_HOME/conf/collection.cfg.default: Options in this file are read only, this provides the product default values.


The format of the file is a simple name=value pair per line, with the values $SEARCH_HOME and $COLLECTION_NAME automatically expanded to the funnelback installation path and the name of the current collection automatically.

Configuration options

The following tables contain descriptions of the options that are used in the configuration file. All values which can be set within profile.cfg can also be set in the containing collection.cfg, and default values are inherited from the collection's defaults

access_alternateProvides an alternate collection to query if access is denied due to the access_restriction setting.
access_restrictionAllows restricting search interface access to certain IPs/hosts.
access_restriction.ignored_ip_rangesConfigures any ranges which should be considered 'internal' and hence ignored in X-Forwarded-For processing.
access_restriction.prefer_x_forwarded_forConfigures whether the content of an X-Forwarded-For header is preferred to the apparent remote address.
auto-completionEnable or disable auto completion.
auto-completion.alphaAdjust balance between relevancy and length for auto completion suggestions.
auto-completion.formatSet the display format of the suggestions in the search results page.
auto-completion.lengthMinimum length of query term before triggering auto completion.
auto-completion.programProgram to use for auto completion. on search based auto completion. to use for search based auto completion.
auto-completion.showMaximum number of auto completion to show.
auto-completion.sortSets the auto completion suggestions sort order.
auto-completion.sourceSets the source of the data for auto completion suggestions.
auto-completion.source.extraSets extra sources of data for auto completion suggestions.
auto-completion.standard.enabledEnables the standard auto completion feature.
click_trackingEnable click tracking
restrict_preview_to_authenticated_usersAllows restricting the preview search interface to authenticated users only.
ui.modern.cache.form.formName.content_typeSets custom content type header for a given cache form
ui.modern.cache.form.formName.headers.keySpecify custom headers for a cache form file.
ui.modern.cache.form.formName.remove-headersRemoves headers for a given cache form.
ui.modern.click_linkSet click URI
ui.modern.curator.query-parameter-patternPattern used to identify 'query' parameters for curator to trigger on.
ui.modern.external_num_ranks_limitLimit the maximum number of results that can be requested in a single search request
ui.modern.extra_search_cpu_count_percentageLimit the percentage of processors extra searches can use per search.
ui.modern.extra_search_total_timeout_msHow much time (in milliseconds) all extra searches are permitted to use before extra searches are terminated.
ui.modern.form.formName.content_typeSets custom content type header for a given form
ui.modern.form.formName.headers.keySpecify custom headers for a form file.
ui.modern.form.formName.remove-headersRemoves headers for a given form.
ui.modern.freemarker.display_errorsSpecify whether to display Freemarker errors in the browser or not.
ui.modern.freemarker.error_formatSpecifies in which format the Freemarker errors should be displayed in the browser
ui.modern.max_facet_extra_searchesThe maximum amount of extra searches that will be run for faceted navigation.
ui.modern.metadata-alias.aliasCreates a key for Metadata alias key
ui.modern.pseudonymise_client_ipsSpecify whether client IP addresses should be pseudonymised before processing.
ui.modern.related-document-fetch.relatedDocumentKeyConfigures fetching of documents related to the primary results.
ui.modern.related-document-fetch.relatedDocumentKey.depthConfigures repeating depth of fetching of documents related to the primary results.
ui.modern.remove-internal-extra-searchesControls if any internal extra searches should be removed or not.
ui.modern.session.search_history.metadataControls what metadata should be stored and returned by Search Sessions click history.


Funnelback logo