This knowledge article guides TeamDynamix (TDX) Agents with the Knowledge Candidate role on how to create, update, renew, address feedback, and monitor their articles in the Knowledge Base.
Before You Begin
Want to create and edit articles for your group? Here's a quick path to get these permissions.
Required (no escaping these):
Strongly Recommended (and 100% free):
- Take the Digital Accessibility Awareness and Web Accessibility Basics from the Digital Accessibility Office — your future readers will thank you.
Only doing one or two simple articles? Skip everything above and send the draft via ticket — they may have a trick or two up their sleeve for this.
If you have Knowledge article create/edit permissions, you can do the following tasks:
In This Article:
Creating New Articles
Before you create a new article, consider these checks:
Step 1: Open the New Article Form
- Log in to the Client Portal and navigate to Knowledge Base.
- Click +New Article button. The new article form appears.
Step 2: Select an Article Category
- Search and select a Category for the article.
Tip: Sort the Category Lookup list by the Category column to find a category more easily.
Note: By default the articles in the main categories inherent public visibility. You can change the article visibility to only for logged-in users later. For now continue to next step.
Step 3: Complete the Article Settings
- Leave the Order field set to 1.0.
- Leave Pin Article unchecked.
- Enter the article Subject (title) according to the Article Title Guidelines.
- In the Body text box, enter the article's scope statement according to the Article Scope Statement Guidelines.
Note: You’ll add the rest of the article content later. For now, continue to the next step.
- Copy the scope statement from the Body text box into the Article Summary text box.
- Add the appropriate Tags according to the Article Keywords or Tags Guidelines.
- If you want to receive notifications when users submit feedback, select Notify Owner on Feedback.
- Select the primary contact person for the article form the Article Agent lookup.
- Click Save.
Result: The article edit mode closes, and the article appears in view mode.
Step 4: Add the Main Article Content
Assuming you are already looking at the article in view mode on the Client Portal.
- Click the Edit Article to open the article in edit mode.
- Enter the article content in the Body text box. Follow these guidelines as you build the article:
Tip: Tip: To save your work in progress, select the Update Article button while editing.
- Copying text from external sources: If you copy text from Word or another website, use Paste as Plain Text
option. Then format the text in TDX. This prevents unnecessary or incompatible HTML tags from entering the article code and causing fonts or formatting issues.
- Formatting text: Use the formatting panel controls to format the article content.
- Hyperlinks: Embed URL behind descriptive hyperlinks instead of displaying just long URLs.
- Screenshots: If you are adding screenshots and need help see Inserting Images insturctions.
- Table of Contents: If the article contains two or more H2 headings, consider Adding a Table of Content.
- Alert boxes: If needed select a call-out alert boxe from Templates in the formatting panel.
- Tables: If you add a table, consider enabling the hover-over effect in the Table Properties.
Note: For comprehensive formatting and styling guidelines refer to Article Styling Guidelines.
- When you finish adding content, click Update Article.
Result: The article is saved, and it remains open in edit mode.
Step 5: Submit Article for Style Review
Assuming you are already looking at the article in view mode on the Client Portal.
- Click the article title's breadcrumb above the article title to exit edit mode and display the article in view mode.
- Click Submit Article.
Result: The article is sent to a KB Admin on the TDX Admin team for formatting and styling review. It is not yet available to its intended audience.
Steps 6: Check Article Visibility (if needed)
-
While your article awaits review, confirm that its visibility matches your intended audience. You can change an article's visibility at any time. For instructions, see the Change Article Visibility section.
Tip: You do not need to resubmit the article for the KB Admin's review after changing its visibility.
What Happens Next. After you submit your article, a KB Admin on the TDX Admin team reviews it to ensure it follows the Article Style Guidelines. Reviews usually take 24–48 hours, depending on the type and volume of content. You will receive a notification when your article is published and available to its intended audience..
Updating Published Articles
Follow the instructions to modify the main content in an already published article.
Step 1: Access the Article
Go to Step 2: Modify the Body Content if you are already viewing the article.
- Ensure you are logged in to the Client Portal.
- Click Knowledge Base on the menu bar.
- Search for the article you want to update.
- From the search results, click the article title to display it.
Result: The article is displayed in view mode on the Client Portal.
Step 2: Modify the Body Content
Assuming you are already looking at the article in view mode on the Client Portal.
- Click the Edit Article to open the article in edit mode.
- Edit the article content in the Body text box. Follow these guidelines as you build the article:
- Copying text from external sources: If you copy text from Word or another website, use Paste as Plain Text
option. Then format the text in TDX. This prevents unnecessary or incompatible HTML tags from entering the article code and causing fonts or formatting issues.
- Formatting text: Use the formatting panel controls to format the article content.
- Hyperlinks: Embed URL behind descriptive hyperlinks instead of displaying just long URLs.
- Screenshots: If you are adding screenshots and need help see Inserting Images insturctions.
- Table of Contents: If the article contains two or more H2 headings, consider Adding a Table of Content.
- Alert boxes: If needed select a call-out alert boxe from Templates in the formatting panel.
- Tables: If you add a table, consider enabling the hover-over effect in the Table Properties.
Note: For comprehensive formatting and styling guidelines refer to Article Styling Guidelines.
- When you finish adding content, click Save as Draft.
Result: The article changes are saved, and it remains open in edit mode.
- Click the article title's breadcrumb above the article title to exit edit mode and display the article in view mode.
What Happens Next. After you save the content changes, a KB Admin on the TDX Admin team reviews it to ensure the article still follows the Article Style Guidelines. Reviews usually take 24–48 hours, depending on the type and volume of content. You will receive a notification when the updated article is available to its intended audience..
Change Article Visibility
The following three user-facing article visibility levels are available:
- Public: Anyone can view the article without logging in. This is default for the articles in all Main categories.
- Internal: Only logged-in users can view the article. This is default for the articles in the Departmental category.
- Limited: Only logged-in users who belong to a specific college.
If you want to keep your article’s default visibility, no changes are needed. Use the table below to determine whether you need to modify your article’s visibility settings.
| If the Article is in |
Desired visibility Level is Public |
Desired Visibility Level is Internal |
Desired Visibility Level is Limited |
| Any Main category |
No change needed, already default. |
Change visibility to Internal. |
Change visibility to Limited. |
| Departmental category |
— |
No change needed, already default. |
If you need to change your article's visibility, follow the steps below:
Step 1: Open the Article
Skip to Step 2 if you are already viewing the article.
- Ensure you are logged in to the Client Portal.
- Click Knowledge Base on the menu bar.
- Search for the article you want to update.
- Click the article's title in the search results to display it in the view mode mode.
Result: The article opens in view mode..
Step 2: Open the Permissions Settings
Assuming you are already viewing the article in view mode.
- Click the Edit Article button to open it in edit mode.
- Click the Permissions tab below the article title.
Result: The current Permissions settings are displayed.
Step 3: Choose the Visibility Level
Assuming you are already viewing the article in edit mode.
Follow the instructions in the desired option for the visibility level you want to apply.
Option A: Set Visibility to Internal
Choose this option to make the article visible the logged-in users only.
- Clear the Inherit Permissions checkbox.
- Clear the Public checkbox.
- Select the Allow all individuals to view this article EXCEPT the associated groups below.
- Make sure the Add Group field is empty.
- Click Save.
Result: The article visibility change takes effect immediately..
Option B: Set Visibility to Limited
Choose this option to make the article visible only to the logged-in users who belong to specific college.
- Clear the Inherit Permissions checkbox.
- Clear the Public checkboxe.
- Select Allow ONLY the associated groups below to view this article.
- In the Add Groups dropdown, select the desired PG-xxxx group(s).
Caution: Only choose the groups with a PG- prefix.
- Click Save.
Result: The article visibility change takes effect immediately.
Modify Article Settings
You can modify the article title, change the article category, update the article summary text, add or remove article tags, and transfer or take article ownership under article settings.
You can work with these settings in two steps. First, access the article you want to change. Then, make the actual changes to the settings.
Step 1: Access the Article
Go to Step 2 if you are already viewing the article.
- Ensure you are logged in to the Client Portal.
- Click Knowledge Base on the menu bar.
- Search for the article you want to update.
- From the search results, click the article title to display it.
Result: The article is displayed in view mode on the Client Portal.
Step 2: Modify the Settings
Assuming you are now already looking at the article you want to update in view mode.
- Click the Edit Article button to open it in edit mode.
- Click the Settings tab under the article title.
- On the Settings window, make the desired changes:
- Subject (or Title): See how to make effective Article Titles.
- Category: You can sort the Category Lookup list by the Category column. This makes it easier to find a category.
- Summary: See what to include in Article Summary.
If you update the Article Summary, you also have to update the
Article Scope or Intro with the same text.
- Tags: See Article Tags to know what to include as tags.
- Notify Owner on Feedback: If enabled, all members of the article owner group will receive this notification.
- Owner: This is the article owning group.
Do not add a person in the Owner field; Otherwise, the Admin-provided Knowledge reports will not work for this article.
- Article Agent: This person is the point of contact and owner of the article who represents the group and coordinates with the KB Admin.
- When you finish updating Settings, click Save.
- Click the article's breadcrumb above the article title to close edit mode and display the article in view mode.
Result: Your changes are saved and will take effect immediately.
Submitting Article Reviews
All published articles must be reviewed every six months for accuracy and currency. The six-month countdown starts from the article’s publish date or its last review date.
Members of the article-owning group get an Article Review Due email 30 days before the due date.
An article is retired if it isn’t reviewed by its due date.
You can submit an article review anytime before the due date. The review process has two steps:
Step 1: Find the Article
Go to Step 2 if you are already viewing the article.
- Sign in to the Client Portal.
- Choose one of these reports:
- When the report page opens in a new tab, click the Run Report button.
If the report displays a blank page with (0) results, it means currently you don't have any articles needing review.
- From the report results, click the article Title (in Subject column)
Result: You are viewing the article on the Client Portal.
Step 2: Complete the Review
Assuming you are now already looking at the article you want to update in view mode.
- Check the article to see if anything needs to be updated. (if needed, see how to Update Existing Articles).
- Scroll to the Feedback section and address any unaddressed feedback (if needed, see how to Address Article Feedback).
- Scroll to Was this helpful? and click Yes.
- In the Comment box, type a short note like: Article reviewed, extend next review date.
- Click Submit (only once).
In rare a case, if the Comment box stays open after you click Submit, ignore it. Your review is still recorded. This is a known issue.
- Refresh your browser.
Result: Your article review is now recorded in the Feedback section.
What Happens Next:
- Your review is recorded immediately, but the next review due date updates within 24 hours. If the article still shows up in the Review Due reports right after you submit the article review, ignore it — you’re done.
- During the article review, if you also update the article body, customers will see those changes only after the KB Admin reviews them. This usually takes 24–48 hours. If the update is urgent, contact the KB Admin on Teams.
Addressing Article Feedback
User feedback helps improve knowledge articles. Addressing each feedback submission recognizes the submitter’s contribution and encourages continued participation.
Article owners are primarily responsible for monitoring and addressing feedback on their articles
Highly recommended: To monitor feedback submissions on your articles, add the My Articles – Unaddressed Feedback report to your existing ticketing dashboard.
Logged-in users can submit one of two types of feedback on any article they can view by selecting Yes or No for Was this helpful? at the end of an article.
- Reaction feedback: The user selects only Yes or No without adding comments.
- Detailed feedback: The user also provides written comments or additional context.
Follow the steps below to find and address article feedback.
Step 1: Find Articles with Unaddressed Feedback
Note: Skip to Step 2 if you already have found the article with unaddressed feedback.
If you are not monitoring the article feedback on your ticketing dashboard, you can also find articles with unaddressed feedback using any of the following methods. Choose the method that best works for you.
Method 1: Find Articles with Feedback in Work Management
- Navigate to Work Management > Tickets and select My Articles – Unaddressed Feedback from the left navigation under Knowledge Reference Reports.
Method 2: Run the Article Unaddressed Feedback Report
- Sign in to the Client Portal.
- Choose the desired report:
- When the report opens in a new tab, click Run Report.
Note: If the report returns no results, you currently have no articles with unaddressed feedback.
- To open an article with unaddressed feedback, click the article Title in the Subject column.
Result: The article opens in view mode.
Step 2: Review and Address Feedback
Note: Assuming now you have accessed the article with unaddressed feedback in view mode.
- Scroll to the bottom of the article and click Feedback.
- Look for unaddressed feedback submissions, which looks like this,

Tip: An article may have multiple unaddressed feedback submissions, and an unaddressed submission may not always be the most recent one.
- Choose the instructions for the appropriate feedback type below:
Option A: Address Reaction Feedback
If the feedback is only a Yes or No without any comments:
- Click Mark Addressed.
Result: The feedback is marked as addressed.
Option B: Address Detailed Feedback
If the feedback also includes written comments:
- Review the feedback comments.
- Update the article if appropriate.
- Click Mark Addressed.
- Recommended: If the feedback resulted in content corrections, send the feedback submitter a brief thank-you message.
Result: The feedback is marked as addressed.
KB Admin Responsibility:
Detailed Feedback. The KB Admin converts outstanding unaddressed detailed feedback submissions into tickets and assigns them to the appropriate article owner groups. Article owner groups determine whether changes are needed. Tickets may be closed when no revision is needed or if the appropriate updates have already been completed.
Reaction Feedback. The KB Admin marks outstanding unaddressed reaction feedback as addressed without creating tickets.
Managing Articles
You can use Knowledge Reports to monitor or track your articles for common needs, such as checking upcoming review dates, viewing unaddressed feedback, or knowing approval status.
Monitor Your Articles
Here are a few ways to view the articles where you are the article agent:
Method 1: Run the Knowledge Reports in the Client Portal:
- Make sure you are signed in to the Client Portal.
- Click the desired report link:
- When the report opens in a new tab, click Run Report.
Result: Articles matching the report’s scope are displayed.
If a report displays a blank page with (0) results, it means you currently have no articles that meet the report’s criteria.
Method 2: Run the Knowledge Reports in TD Work Management.
- Go to TD Work Management
- Click View Applications and select the Tickets application.
- In the left navigation, scroll to the Knowledge Reference Reports section
- Click the desired report from the list in that section
Result: Articles matching the report’s scope are displayed.
If a report displays a blank page with (0) results, it means you currently have no articles that meet the report’s criteria.
Method 3: Add the Knowledge Reports you want to your dashboard.
Result: You can see your list of articles in real time, right next to your TDX tickets, on the same dashboard.
If a report on your dashboard shows No items, it means none of your articles match the report’s conditions.
Monitor Group Articles
Here are a few ways to view the articles that your Responsible Group owns:
Method 1: Run the Knowledge Reports in the Client Portal:
- Make sure you are signed in to the Client Portal.
- Click the desired report link:
- When the report page opens in a new tab, click the Run Report button.
- Search and select your group for the Owning group is one of prompt.
- Click the Run Report button.
Result: Articles matching the report’s scope are displayed.
If a report displays a blank page with (0) results, it means you currently have no articles that meet the report’s criteria.
Method 2: Run the Knowledge Reports in TD Work Management.
- Go to TD Work Management
- Click View Applications and select the Tickets application.
- In the left navigation, click the Knowledge Reference Reports link.
- From the list of reports in the main window, click the desired 'Groups' Articles - xxx' report.
Result: Articles matching the report’s scope are displayed.
If a report displays a blank page with (0) results, it means you currently have no articles that meet the report’s criteria.
Adding the Group Reports on Dashboards: If you want a Groups' Articles report on your dashboard, first make a copy, set the Owning Group filter to your group, and add that customized version on the dashboard. Using the original report as it is will require you to manually select your group each time the dashboard refreshes. This is because TDX does not currently support dynamic group reporting. Their group-based Knowledge Base reports must either have a specific group selected in the filter or be chosen manually each time they run.
Retiring or Restoring Articles
Retire an Article
Published articles that miss a periodic review are considered outdated or abandoned. They will automatically retire to the archive by the 15th day after the missed review date.
- If you want to retire an article, send a request and ensure to include the ID and Title of the article being retired.
Restore an Article
You can restore a retired or archived article in two steps. First, submit a request to restore the article as a draft. Then, submit the restored draft article for republishing.
Step 1: Submit a request to restore an article
If you already have been notified that your archived article has been restored as a draft, proceed to Step 2 for republishing instructions.
- Sign in to the Client Portal.
- Choose one of these reports:
- When the report opens in a new tab, click Run Report.
If the report shows zero results, you currently have no retired articles.
- From the report list, note the ID and Title of the article you want to restore.
- Submit a request to restore the article and include the article ID and Title.
Result: Your request to restore an archived article has been submitted. The KB Admin will restore it in 24-48 hours.
A restored article does not automatically go live (published), it comes back as a draft. Once you are notified that the requested article has been restored as a draft, complete the instructions in Step 2 to republish the article for the audience.
Step 2: Submit the restored article draft for republishing
Once you are notified that the requested article has been restored as a draft, follow these steps to get it published (make it live) for its audience.
- Access the restored article
- Check the article to see if anything needs to be updated. (if needed, see how to Update Existing Articles).
- Scroll to the Feedback section and address any unaddressed feedback (if needed, see how to Address Article Feedback).
- In the View mode, click the Submit Article button, as you would for a new article.
Result: Your article has been submitted for publishing.
What Happens Next. The article will be published after the KB Admin reviews it to ensure it complies with the Article Style Guidelines. This usually takes 24–48 hours, depending on the volume of content.
Managing Article Notifications
Knowledge articles generate automatic notifications at various points in their lifecycle. These messages are sent on a per-article basis as Outlook emails, and all members of the article’s owning group receive them. You can manage or filter these notifications by creating Outlook Rules that use Advanced Options with the with specific words in the body condition.
- If you want to treat all Knowledge notifications the same (e.g., move them all to one folder), use kb-notifications- in the rule condition to capture all of them with a single rule.
- If you plan to handle Knowledge notifications differently (e.g., route them to different folders), use the corresponding keywords below in the rule condition to create separate rules for each notification.
| Notification |
Trigger |
Keyword to use in the rule |
| Feedback |
A user submits feedback on an article. |
kb-notifications-feedback |
| Review Due |
An article requires a periodic six-month review. |
kb-notifications-review-due |
| Status Change |
An article's lifecycle status is changed. |
kb-notifications-status-change |
| Draft Rejected |
A Knowledge Admin rejects an article. |
kb-notifications-draft-rejected |
Result: This keeps the inbox clean for people who don’t handle articles, while making sure the people who do can still see the notifications.