Format a knowledge base V2 question and answer article

Prerequisites
  • Genesys Cloud CX 1 Digital Add-on II, Genesys Cloud CX 2, Genesys Cloud CX 2 Digital, Genesys Cloud CX 3, or Genesys Cloud CX 3 Digital
  • Knowledge > All permissions
  • Analytics > Knowledge Aggregate > All permissions
  • Response Assets > Asset > All permissions (to upload images)

      You can perform general updates to your knowledge base article, such as change font style, change font size, change font color, change background color, change text emphasis, alignment, add bulleted or numbered lists. You can also customize your article to include rich media, tables, and more. These updates appear in your touchpoints. These sections describe how to perform various tasks to tailor your question and answer article for your audience.

      Notes:
      • Make sure that you create question and answer articles in the same language as the knowledge base.
      • Questions and answers must include a minimum of five characters.
      • The maximum size of article content or uploaded file size is 300 KB.
      • The maximum number of articles in a knowledge base is 15,000.
      • The maximum number of knowledge bases in a single organization is 500.
      • Hyperlinks cannot include an ampersand (&) in the construction of the string.
      • For more information about constraints, see Limits in the Developer Center. For more information about how to create an FAQ, see Knowledge workbench FAQ creation tips.

      Note: Functionality varies depending on the touchpoint that you choose. For more information, see Channel, bot, and touchpoint capabilities feature comparison.
      1. Click Admin
      2. Under Knowledge, click Articles.
      3. Create a new knowledge base or open an existing one.
      4. Open an existing question and answer article or create a new one.
        Note: If you select an existing article with multiple variations that include touchpoints and segments in an existing article, to view details about the article, perform these steps:
        1. Select the variation from the list.
        2. Click Variation Details. The Variation Details dialog box opens.
        3. To view segment information, under Segments, click to expand the segment that you want to view.
      5. Add your article text.
      6. As appropriate, double-click to select the text to change and then use these steps to format your article:
        1. To change the font style, position the cursor anywhere in the line or paragraph, click the arrow at the end of Paragraph, and choose from one of the following options:
          • Paragraph (default)
          • Heading 1–6
          • Preformatted
        2. To change the font size, click the arrow at the end of Medium and choose from one of these options:
          • XX-Small
          • X-Small
          • Small
          • Medium (default)
          • Large
          • X-Large
          • XX-Large
        3. To change the font color, click the arrow next to Text Color Text Color button and choose one of these steps:
          • Select a predefined font color.
          • Click Custom Color . The Color Picker opens. Enter the color’s RGB or Hex code and then click Save.
        4. To add highlight to a word, phrase, or paragraph, click the arrow next to Background Color Background color button and choose one of these steps:
          • Select a predefined highlight color.
          • Click Custom Color . The Color Picker opens. Enter the color’s RGB or Hex code and then click Save.
        5. To adjust the text emphasis, select from the formatting options in the toolbar:
          • Bold
          • Italic
          • Underline
          • Strikethrough
        6. To change the text of the alignment, position the cursor anywhere in the line or paragraph, click Alignment , and select an option:
          • Decrease indent
          • Increase indent
          • Align left
          • Align center
          • Align right
        7. To create bulleted lists, select the text for which you want to add bullet points and click Bullet List .
          Note: To change from the default disc style, click the arrow at the end of Bullet List and choose circle or square.
        8. To create numbered lists, select the text for which you want to add numbering and click Numbered Points .
          Note: To change from the default numbering style, click the arrow at the end of Numbered Points and choose lower alpha or lower Roman.

      Genesys Cloud supports the following image formats: .jpg, .jpeg, .png, and .gif.

      Insert image into knowledge article

      1. Click Image and do one of the following.
        • To select an existing image, follow these steps:
          1. Search for the image that you want to use.
          2. Click to select the image.
          3. Click Insert image.
        • To select a locally saved image, follow these steps:
          1. Click Browse for image.
          2. Drag and drop the image into the dialog box or click to search for the image that you save locally.
          3. Click Upload.
        • To select an image from a hyperlink URL, perform these steps:
          1. Click the down arrow next to Browse for image.
          2. Click Insert image from URL.
          3. Enter the URL that contains the image to add.
          4. Click Insert image.
      2. To resize an image, follow one of these steps:
        • Click the image. A blue border appears around the image. Click any blue corner of the image and drag the image to the preferred size.
        • Right-click the image and from the menu that appears, select Edit Image. The Edit Image dialog box opens. Adjust the alternative description, width, and measurement in units.
      3. After you upload and insert an image, to link the image to a hyperlink URL, perform these steps:
        1. Click to select the inserted image.
        2. Click Create Hyperlink . The Create Hyperlink dialog box opens.
          Create Hyperlink in knowledgebase article
        3. To create a URL link type, follow these steps:
          1. Remain on the default URL tab.
          2. Under Display image, to link the display the image, leave the default Image setting. Conversely, to display wording other than the URL string, click Text and enter the text to display to the customer.
          3. Under URL, add the fully qualified URL string.
            Note: Currently, the only supported transfer protocol is https.
          4. Under Target, leave the default New tab setting unchanged.
        4. To create an email link type, follow these steps:
          1. Click the E-mail tab.
          2. Under Display image, to link the display the image, leave the default Image setting. Conversely, to display wording other than the URL string, click Text and enter the text to display to the customer.
          3. Under E-mail, type the complete email address.
          4. Under Action, leave the default Open e-mail provider setting unchanged.
        5. To create an article link type, follow these steps:
          1. Click the Article tab.
          2. Under Display image, to link the display the image, leave the default Image setting. Conversely, to display wording other than the URL string, click Text and enter the text to display to the customer.
          3. Search for and select the article link.
        6. Click Create.

      Genesys Cloud supports the following media formats: Vimeo and YouTube.

      Notes: Functionality varies depending on the touchpoint that you choose. For more information, see Channel, bot, and touchpoint capabilities feature comparison.
      1. Click Insert/Edit Media . The Add/Edit Video dialog box opens.
        Add or Edit Media dialog box in knowledge base article
      2. Under Media URL, enter the URL of the media source that you want to add.
      3. (Optional) adjust the width and height of the media file.
      4. To allow a participant to adjust the media file size, click Constrain proportions . The Constrain proportions changes.
      5. Click Save.

      You can add a URL, email address, or an article from the same knowledge base as a hyperlink in an article. You can also display these hyperlinks as text or as an image that you upload.

      Note: This option is only available for Knowledge Portal.

      1. Click Create Hyperlink . The Create Hyperlink dialog box opens.
        Create a hyperlink in a knowledge base article
      2. To create a URL hyperlink, follow these steps:
        1. Remain on the URL tab.
        2. Under Display Text, perform one of these steps:
          • Leave the Text option selected and to display wording other than the URL string, enter the text to display to the customer.
          • Click Image and either upload a new image, select an existing image, or add the image URL.
        3. Under URL, add the fully qualified URL string.
          Note: Currently, the only supported transfer protocol is https.
        4. Under Target, leave the default New tab setting unchanged.
      3. To create an email address as a hyperlink, follow these steps:
        1. Click the E-mail tab.
        2. Under Display Text, perform one of these steps: 
          • Leave the Text option selected and to display wording other than the email address, enter the text to display to the customer.
          • Click Image and either upload a new image or select an existing one.
        3. Under Email, type the complete email address.
        4. Under Action, leave the Open e-mail provider setting unchanged.
      4. To create a link to another article in the same knowledge base, follow these steps:
        1. Click the Article tab.
        2. Under Display Text, perform these steps:
          • Leave the Text option selected and to display wording other than the article string, enter the text to display to the customer.
          • Click Image and either upload a new image or select an existing one.
        3. Under Article, search for and select the article that you want to link to in the current article.
        4. Under Variation, select the appropriate variation for which to provide this hyperlink.
      5. Click Create.
      6. To resize the image, follow one of these steps:
        • Click the image. A blue border appears around the image. Click any blue  corner of the image and drag the image to the preferred size.
        • Right-click the image and from the menu that appears, select Edit Image. The Edit Image dialog box opens. Adjust the alternative description, width, and measurement in units.

        Note: Some functionality is limited, depending on the touchpoint you choose. For example, tables in Messenger touchpoints are unsupported. For more information, see Channel, bot, and touchpoint capabilities feature comparison.
        1. Create a table:
          1. Click Table . The Table menu appears.
          2. Hover over Table and move your cursor over the grid until you highlight the number of columns and rows that you want.
        2. To make general changes, click anywhere in the table and from the menu that appears, choose to perform any of these actions:
          1. Open the table properties
          2. Delete the table
          3. Insert row before
          4. Insert row after
          5. Delete row
          6. Insert column before
          7. Insert column after
          8. Delete column
        3. To configure the cell properties, select the cell or cells that you want to format, click Table Cell, and from the menu that appears, perform these steps:
          1. To configure the cell format, click Cell Properties. The Cell Properties dialog box opens.
            1. On the General tab, customize any of these options: 
              • Width
              • Height
              • Cell type (header or regular cell)
              • Scope (row, column, row group, or column group)
              • Horizontal align
              • Vertical align
            2. On the Advanced tab, configure these optional border settings:
              • Border width
              • Border style
              • Border outline color
              • Border background color
            3. Click Save.
          2. To merge cells, click Merge cells
          3. To split a cell, click Split cell.
        4. To set row properties, select the row or rows that you want to format, click Table  > Row, and from the menu that appears, follow these steps:
          1. To insert a row before the selection, click Insert row before.
          2. To insert a row after the selection, click Insert row after.
          3. To remove a row, click Delete row.
          4. To format row properties, click Row properties. The Row Properties dialog box opens.
            1. On the General tab, customize any of these options: 
              • Row type (header, body, or footer)
              • Alignment (left, center, or right)
              • Row height
            2. On the Advanced tab, configure these optional border settings:
              • Border style
              • Border outline color
              • Border background color
            3. Click Save.
          5. To cut a row and paste it elsewhere, click Cut row.
          6. To copy a row and insert a duplicate copy in another location, click Copy row.
          7. To paste a cut or copied row before the selection, click Paste row before.
          8. To paste a cut or copied row after the selection, click Paste row after.
        5. To set column properties, select the column or columns that you want to format, click Table  > Column, and from the menu that appears, follow these steps:
          1. To insert a column before the selection, click Insert column before.
          2. To insert a column after the selection, click Insert column after.
          3. To remove a column, click Delete column.
          4. To cut a column and paste it elsewhere, click Cut column.
          5. To copy a column and insert a duplicate copy in another location, click Copy column.
          6. To paste a cut or copied column before the selection, click Paste column before.
          7. To paste a cut or copied column after the selection, click Paste column after.
        6. To set properties for the entire table, click Table  > Table properties. The Table Properties dialog box opens.
          1. On the General tab, customize any of these options: 
            • Width
            • Height
            • Cell spacing
            • Cell padding
            • Border width
            • Table caption
            • Show table caption
            • Border Width
            • Alignment
          2. On the Advanced tab, configure these optional border settings:
            • Border style
            • Border outline color
            • Border background color
          3. Click Save.
        7. To resize a cell, right-click inside the cell and from the menu that appears, select to resize a cell. The properties dialog box opens. Adjust the width, height, cell type, scope, horizontal alignment, and vertical alignment.
        8. To resize a row, follow one of these steps:
          • Hover over the row that you want to increase and when the cursor changes to Resize horizontally , drag the row to the preferred size.
          • Right-click the row and from the menu that appears, select to resize a row. The properties dialog box opens. Adjust the row type, height, and alignment. Click the advanced tab and configure border properties.
        9. To resize a column, follow one of these steps:
          • Hover over the column that you want to increase and when the cursor changes to Resize vertically , drag the row to the preferred size.
          • Right-click the column and from the menu that appears, select to resize a column. The properties dialog box opens. Adjust the width, height, cell type, scope, horizontal alignment, and vertical alignment. Click the advanced tab and configure border properties.
        10. To resize the table, follow one of these steps:
          1. Click anywhere in a table cell. A blue border appears around the table. Click any blue corner of the table and drag it to the preferred size.
          2. Right-click inside the table and from the menu that appears, select Table Properties. The Table Properties dialog box opens. Adjust the width, height, cell spacing, cell padding, border width, caption, and alignment. Click the advanced tab and configure border properties.
        11. Click Save.
        12. To remove the entire table, click Table  > Delete Table.


        1. Under Content for the Answer, click More next to the variation you want to edit.
        2. To view and edit the variation, follow these steps:
          1. Click Edit Variation.
          2. Update the variation name.
          3. Add or remove touchpoints.
          4. Modify segments.
          5. Click Update.
        3. To delete the variation if more than one exists, click Delete Variation.

          • To save the article and continue working, click Save.
          • To save the article and close the knowledge base, click Save & Close.