--- title: Upgrade from v2 to v3 slug: latest-upgrading-from-v2 canonical_url: https://docs.coveo.com/en/quantic/latest/upgrading-from-v2/ collection: quantic source_format: adoc --- # Upgrade from v2 to v3 Quantic v3 introduces changes that improve the library's performance and usability. Notably, Quantic v3 uses [organization endpoints](https://docs.coveo.com/en/mcc80216/) by default. > **The following are breaking changes from Quantic v2 to v3** > > ==== > > == Organization endpoints > > [Organization endpoints](https://docs.coveo.com/en/mcc80216/) is a feature that improves separation of concerns and resiliency, making multi-region and data residency deployments smoother. > Starting with Quantic v3, the usage of organization endpoints will be enforced, as opposed to [optional in v2](https://docs.coveo.com/en/1275#using-the-advanced-configuration-page). > > The [`CoveoTokenProvider`](https://github.com/coveo/ui-kit/blob/master/packages/quantic/force-app/coveo-token/main/default/classes/CoveoTokenProvider.cls) class will change to always use the [organization endpoints](https://docs.coveo.com/en/mcc80216/). > Since you have most likely copied and changed this class to implement your own [search token provider](https://docs.coveo.com/en/quantic/latest/usage#search-token-provider), you should update your implementation to use the organization endpoints as well. > > == Renamed > > The following elements were renamed without changes to their underlying functionality. > > === `QuanticResultBadge` > > The component has been replaced by [`QuanticResultTag`](https://docs.coveo.com/en/quantic/latest/reference/result-template-components/result-template-result-tag/) > > === Custom events > > Some custom events emitted by Quantic were renamed with the `quantic__` prefix to make them easier to identify. > > * `rating` -> `quantic__rating` > * `headerclick` -> `quantic__headerclick` > * `headerkeydown` -> `quantic__headerkeydown` > * `renderfacet` -> `quantic__renderfacet` > * `selectvalue` -> `quantic__selectvalue` > * `citationhover` -> `quantic__citationhover` > * `like` -> `quantic__like` > * `dislike` -> `quantic__dislike` > * `pressexplainwhy` -> `quantic__pressexplainwhy` > * `registerresulttemplates` -> `quantic__registerresulttemplates` > * `select` -> `quantic__select` > * `deselect` -> `quantic__deselect` > * `loadingstatechange` -> `quantic__loadingstatechange` > * `change` -> `quantic__change` > * `registerrecommendationtemplates` -> `quantic__registerrecommendationtemplates` > * `haspreview` -> `quantic__haspreview` > * `suggestionlistrender` -> `quantic__suggestionlistrender` > * `arialivemessage` -> `quantic__arialivemessage` > * `registerregion` -> `quantic__registerregion` > * `tab_rendered` -> `quantic__tabrendered` > > == Removed > > === Rephrase buttons > > These buttons were removed in v3, due to low usage not justifying their maintenance. [`withRephraseButtons`, `answerStyle`, and `multilineFooter` properties of the `QuanticGeneratedAnswer` component](https://docs.coveo.com/en/quantic/latest/reference/search-components/search-generated-answer#properties) These properties were used for the rephrase buttons and were removed in v3. #### `QuanticGeneratedAnswerRephraseButtons` component This undocumented rephrase button component was removed in v3. ### `quantic_OpensInSalesforceSubTab` custom label This undocumented custom label was removed. Unless you had custom logic based on this label, the change should be transparent. ### `resetSelection` and `blur` methods These methods were exposed on the internal `QuanticSearchBoxInput` component, which was used by the `QuanticSearchBox` and `QuanticStandaloneSearchBox` components. The methods were removed because they weren't used. ### [`QuanticResultQuickview`](https://docs.coveo.com/en/quantic/latest/reference/result-template-components/result-template-result-quickview/) and [`QuanticResultLink`](https://docs.coveo.com/en/quantic/latest/reference/result-template-components/result-template-result-link/) The `useCase` property was removed. It didn't do anything, so the change should be transparent. ## Changed The following changes were made. ### [`QuanticDocumentSuggestion`](https://docs.coveo.com/en/quantic/latest/reference/case-assist-components/case-assist-document-suggestion/) `quanticDocumentSuggestion.showQuickview`, which was set to `false` by default, has been replaced by `quanticDocumentSuggestion.withoutQuickview`, which is also set to `false` by default. If you were setting `showQuickview` to `true`, you can remove this property from your code. **Quantic Version 2** ```html ``` **Quantic Version 3** ```html ``` If you were setting `showQuickview` to `false` or leaving it as `false` by default, you can replace it with `without-quickview` set to `true`. **Quantic Version 2** ```html ``` **Quantic Version 3** ```html ``` ### [`QuanticSmartSnippetSource`](https://docs.coveo.com/en/quantic/latest/reference/search-components/search-smart-snippet-source/) `title` and `uri` properties Both the `title` and `uri` properties have been replaced by the `source` property. This change is unlikely to affect you because it's used by the `QuanticSmartSnippet` and the `QuanticSmartSnippetSuggestions` directly. As a result, you aren't required to use `QuanticSmartSnippetSource` directly. If you were using the `QuanticSmartSnippetSource` directly, you'll need to use `source` instead of `title` and `uri`. **Quantic Version 2** ```html ``` ```js // js get sourceTitle() { // ... } get sourceUri() { // ... } ``` **Quantic Version 3** ```html ``` ```js // js get source() { clickUri: //... title: //... } ``` ### [`QuanticSearchInterface`](https://docs.coveo.com/en/quantic/latest/reference/search-components/search-search-interface/), [`QuanticInsightInterface`](https://docs.coveo.com/en/quantic/latest/reference/insight-panel-components/insight-panel-insight-interface/) and [`QuanticCaseAssistInterface`](https://docs.coveo.com/en/quantic/latest/reference/case-assist-components/case-assist-case-assist-interface/) `originLevel3` default value The `originLevel3` property default value was changed from `default` to [`document.referrer`](https://developer.mozilla.org/en-US/docs/Web/API/Document/referrer). This change should be transparent unless you were doing something specific with the `originLevel3` property in your code or [Coveo Analytics reports](https://docs.coveo.com/en/266/). ### Relevance Generative Answering (RGA) citation clicks now tracked as regular click events As of the Quantic v3.2.0 release, Coveo [Relevance Generative Answering (RGA)](https://docs.coveo.com/en/nbtb6010/) citation clicks are now tracked as regular click events instead of custom click events in [Coveo Analytics](https://docs.coveo.com/en/182/) reports. As a result, citation click events now have a [click rank](https://docs.coveo.com/en/2948#click-rank) value of `1`. Additionally, the click **Event Cause** value is set to [`generatedAnswerCitationClick`](https://docs.coveo.com/en/2948#generatedanswercitationclick). This change applies regardless of the tracking protocol (Coveo UA or Coveo [Event Protocol](https://docs.coveo.com/en/o9je0592/)) used. ## Moved The following example components were moved to the `/examples` folder and are no longer part of the Quantic package. * `packages/quantic/force-app/main/default/lwc/exampleSearch` to `packages/quantic/force-app/examples/main/lwc/exampleSearch` * `packages/quantic/force-app/main/default/lwc/exampleStandaloneSearchbox` to `packages/quantic/force-app/examples/main/lwc/exampleStandaloneSearchbox` This change should be transparent, since examples aren't meant for production use.