Edit a knowledge base in QnA Maker

QnA Maker allows you to manage the content of your knowledge base by providing an easy-to-use editing experience.

Edit your knowledge base content

  1. Select My knowledge bases in the top navigation bar.

    You can see all the services you created or shared with you sorted in the descending order of the last modified date.

    My Knowledge Bases

  2. Select a particular knowledge base to make edits to it.

  3. Select Settings. Here you can edit mandatory field Service Name.

    Goal Action
    Add URL You can add new URLs to add new FAQ content to Knowledge base by clicking Manage knowledge base -> '+ Add URL' link.
    Delete URL You can delete existing URLs by selecting the delete icon, the trash can.
    Refresh content If you want your knowledge base to crawl the latest content of existing URLs, select the Refresh checkbox. This will update the knowledge base with latest URL content once. This is not setting a regular schedule of updates.
    Add file You can add a supported file document to be part of a knowledge base, by selecting Manage knowledge base, then selecting + Add File
    Import You can also import any existing knowledge base by selecting √ćmport Knowledge base button.
    Update Updating of knowledge base depends on management pricing tier used while creating QnA Maker service associated with your knowledge base. You can also update the management tier from Azure portal if required.
  4. Once you are done making changes to the knowledge base, select Save and train in the top right corner of the page in order to persist the changes.

    Save and Train


    If you leave the page before selecting Save and train, all changes will be lost.

Add a QnA pair

On the EDIT page, select Add QnA pair to add a new row to the knowledge base table.

Add QnA pair

Delete a QnA pair

To delete a QnA, click the delete icon on the far right of the QnA row. This is a permanent operation. It can't be undone. Consider exporting your KB from the Publish page before deleting pairs.

Delete QnA pair

Add alternate questions

Add alternate questions to an existing QnA pair to improve the likelihood of a match to a user query.

Add Alternate Questions

Add metadata

Add metadata pairs by first selecting View options, then selecting Show metadata. This displays the metadata column. Next, select the + sign to add a metadata pair. This pair consists of one key and one value.

Add Metadata


Make sure to periodically Save and train the knowledge base after making edits to avoid losing changes.

Manage large knowledge bases

  • Data source groups: The QnAs are grouped by the data source from which they were extracted. You can expand or collapse the data source.

    Use the QnA Maker data source bar to collapse and expand data source questions and answers

  • Search knowledge base: You can search the knowledge base by typing in the text box at the top of the Knowledge Base table. Click enter to search on the question, answer, or metadata content. Click on the X icon to remove the search filter.

    Use the QnA Maker search box above the questions and answers to reduce the view to only filter-matching items

  • Pagination: Quickly move through data sources to manage large knowledge bases

    Use the QnA Maker pagination features above the questions and answers to move through pages of questions and answers

Delete knowledge bases

Deleting a knowledge base (KB) is a permanent operation. It can't be undone. Before deleting a knowledge base, you should export the knowledge base from the Settings page of the QnA Maker portal.

If you share your KB with collaborators then delete it, everyone loses access to the KB.

Delete Azure resources

If you delete any of the Azure resources used for your QnA Maker knowledge bases, the knowledge bases will no longer function. Before deleting any resources, make sure you export your knowledge bases from the Settings page.

Next steps