This guide explains how end-users interact with JoomHelpDesk on the frontend of a Joomla 5.x website to submit, track, and manage support tickets.
1. Overview
JoomHelpDesk provides a complete helpdesk experience directly on the frontend of your Joomla website. As an end-user, you can:
- Submit new support tickets describing your issue or request.
- Track the status of existing tickets.
- Reply to tickets and upload file attachments.
- Close or reopen tickets (when permitted by the site administrator).
- Search your ticket history by keyword, reference number, or status.
All ticket-related actions take place on the frontend of the website. You do not need access to the Joomla administrator area.
2. Accessing the Helpdesk
To access the helpdesk, navigate to the JoomHelpDesk menu item on the website. The site administrator will have created a menu link, typically labeled something like "Support", "Help Desk", or "Submit a Ticket".
If you are already logged into the website, clicking the helpdesk menu item will take you directly to the ticket list or the ticket creation page, depending on your site's configuration.
If you are not logged in, you will be presented with a login page or a combined login/guest submission page, depending on how the site administrator has configured access.
3. Logging In
If the helpdesk requires authentication, you will see a login form. The login page may display one or two cards side by side, depending on whether guest access is also enabled.
Login Form Fields
- Username -- Enter your Joomla account username.
- Password -- Enter your Joomla account password.
- Remember Me -- Optionally check this box to stay logged in (if the Remember Me plugin is enabled on the site).
Click the Sign In (or Login) button to authenticate.
Account Recovery Links
Below the login form, you will find links for:
- Forgot your password? -- Sends a password reset email to your registered address.
- Forgot your username? -- Sends a username reminder email.
These links may point to the standard Joomla recovery pages or to custom URLs configured by the site administrator.
Registration
If the site administrator has enabled user registration and has not hidden the registration link, a Create Account link will appear below the login form. Clicking it will take you to the registration page where you can create a new Joomla user account. Once registered, you can log in and use the helpdesk.
The registration link may also point to a custom URL if the administrator has configured one.
4. Guest / Unregistered Ticket Submission
If the site administrator has enabled guest ticket submission, you can create a support ticket without having a Joomla user account.
How It Works
When guest access is enabled, the login page displays two cards side by side:
- Returning User -- A standard login form for users with existing accounts.
- Continue as Guest -- A simple form where you provide your name and email address to proceed without an account.
Submitting as a Guest
- Enter your email address.
- Enter your name.
- Click Create Ticket.
You will then be taken to the ticket creation steps (product selection, department selection, and the ticket form).
Email Lookup for Returning Guests
If your email address is already associated with a registered Joomla account, the system will prompt you to log in instead, displaying a message that the email address is already in use.
Ticket Access Credentials for Guests
After submitting a ticket as a guest, you will receive access credentials so you can return later to view your ticket. Depending on the site configuration, these credentials may include:
- Email address + password -- You use your email and a system-generated password to look up your ticket.
- Ticket reference + password -- You use the ticket reference number and password.
- Ticket reference only -- You use only the reference number (no password required).
These credentials are displayed on screen after ticket creation and are also sent to you by email.
Password Recovery for Guest Tickets
If your guest access mode uses a password and you have forgotten it, the ticket lookup page includes a Forgot your password? section. Expand it, enter your email address, and click Email Ticket List. The system will send you an email with your ticket references and passwords.
Domain Restriction
The site administrator may configure domain-based restrictions for guest email addresses. This means:
- Only email addresses from certain domains may be accepted (e.g., only
@company.com). - Or email addresses from certain domains may be blocked.
If your email domain is not permitted, you will see an error message when attempting to submit.
5. Opening a New Ticket
Creating a new ticket is a multi-step process. The number of steps depends on the site's configuration -- if there is only one product or one department, those selection steps are skipped automatically.
Step Indicator
A visual step indicator may appear at the top of the page, showing your progress through the ticket creation process. The administrator can configure this in one of three styles:
- Numbered -- Circular step numbers connected by lines, with a checkmark for completed steps.
- Breadcrumb -- A breadcrumb trail showing each step with icons.
- Progress bar -- Step icons connected by a progress bar that fills as you advance.
Completed steps are clickable, allowing you to go back and change your selections.
Step 1: Select a Product
You will be asked to select the product or service your ticket relates to. Products are displayed according to the site's configured display mode:
- Card view -- Products appear as clickable cards in a responsive grid. Each card may include a product image, title, and description.
- List view -- Products appear as a clean vertical list with titles and descriptions.
- Tree view -- Products are displayed in a hierarchical tree structure with expandable folders for categories and subcategories.
- Dropdown -- Products appear in a standard dropdown select box, with categories shown as option groups.
If there are many products, a search bar may be available to filter the list. Type part of the product name and press Enter or click the search icon. Use the reset button (X icon) to clear the search.
Products may be organized into categories and subcategories. In card and list modes, categories may be displayed as collapsible accordion sections. In tree mode, categories appear as expandable folder nodes.
If you are a member of a product group, your assigned products may appear under a "My Products" heading, with other available products listed separately under "Other Products".
Pagination is available if there are more products than the configured per-page limit.
Click or select a product to proceed to the next step.
Step 2: Select a Department
After selecting a product, you may be asked to choose a department for your ticket (e.g., "Sales", "Technical Support", "Billing"). The department selection uses the same display modes as the product selection (card, list, tree, or dropdown).
Departments may be linked to specific products. If the administrator has enabled advanced department mode, only departments relevant to your chosen product will be shown. A search bar may also be available to filter departments.
If there is only one department available for the selected product, this step is skipped automatically.
A Back button allows you to return to the product selection step.
Click or select a department to proceed.
Step 3: Search Before Submitting (FAQ/KB Search)
If the administrator has enabled the "search before submit" feature, you will see a search step that encourages you to look for existing answers before creating a ticket.
- Enter your question or issue description in the search field.
- Click Search FAQs & KB or wait for live search results (if live search is enabled).
- Review the results -- matching FAQ articles and Knowledge Base entries will appear as clickable links that open in a new tab.
- If you find your answer, you can follow the link and avoid creating a ticket.
- If you do not find a helpful answer, a Open New Ticket button will appear, allowing you to continue to the ticket form. Your search text will be carried forward as the ticket subject.
This search step can appear at different points in the flow depending on the configuration: before product selection, after product selection, or after department selection.
Step 4: Fill In the Ticket Form
This is the main ticket submission form. The fields shown depend on the site configuration.
Product and Department Information
If a product and/or department were selected in previous steps, they are displayed at the top of the form for your reference (shown as read-only labels with optional product/department images).
Subject
A text field for the ticket subject or title. Enter a brief, descriptive summary of your issue.
This field may be hidden if the administrator has configured the system to hide the subject. If hidden, the system may auto-generate a subject from the ticket content.
Message Body
A text area for describing your issue in detail. Depending on the site configuration, this may be a plain text area or a rich text editor (WYSIWYG) that supports formatting such as bold, italic, lists, links, and more.
This field may also be hidden in certain configurations.
Category
If categories have been defined for the selected product and department, a category dropdown will appear. Categories help classify the nature of your request (e.g., "Bug Report", "Feature Request", "General Inquiry"). Categories may be grouped into sections displayed as option groups in the dropdown.
Priority
A dropdown allowing you to indicate the urgency of your ticket. Common priority levels include Low, Normal, High, and Urgent, though the exact labels and colors are defined by the administrator. The administrator may pre-select a default priority.
This field may be hidden if the administrator has chosen to hide priority selection from users.
CAPTCHA
If the administrator has enabled CAPTCHA protection, a CAPTCHA challenge will appear on the form. This may be a built-in image CAPTCHA or Google reCAPTCHA, depending on the configuration. CAPTCHA may be required for all users or only for unregistered/guest users.
Custom Fields
The administrator may have defined additional custom fields that appear on the ticket form. These can include:
- Text inputs
- Dropdown menus
- Checkboxes
- Date pickers
- File upload fields
- And other field types
Custom fields may be organized into named groups, which appear as card-style sections with headers. Required custom fields are marked and must be filled in before submission.
Some custom fields may only be visible to registered users or only to guests, depending on the configuration.
File Attachments
If file attachments are enabled, an upload section will appear. You can attach one or more files to your ticket. The maximum file size is displayed next to the upload label. Allowed file types are configured by the administrator (common types include images, PDFs, and documents).
Submitting the Ticket
After filling in all required fields, click the Create New Ticket button to submit your ticket.
If there are validation errors (missing required fields, invalid CAPTCHA, etc.), an error alert will appear at the top of the form listing the issues. Correct the errors and submit again.
A Back button is available to return to the department or product selection step.
After successful submission, you will be taken to the ticket detail view where you can see your new ticket, its assigned reference number, and any access credentials (for guest tickets).
6. Viewing Your Tickets
Once logged in, you can view all your support tickets from the ticket list page. The ticket list is accessed via the helpdesk menu item or the tab bar at the top of the helpdesk area.
Tab Bar
A navigation tab bar appears at the top of the helpdesk area showing:
- Open New Ticket -- Takes you to the ticket creation flow.
- Status tabs -- Individual tabs for ticket statuses such as "Open", "Awaiting Reply", "Closed", etc. Each tab shows the count of tickets in that status.
- All Open -- Shows all tickets that are not closed.
- Closed -- Shows all closed tickets (excluding archived ones).
- All -- Shows all tickets except archived ones.
- Other -- A dropdown containing additional status tabs and any status views not shown as top-level tabs.
The exact tabs shown depend on the administrator's configuration.
Ticket List Table
The ticket list displays a table with columns that may include:
- Reference -- The unique ticket reference number.
- Subject -- The ticket title/subject, shown as a link to the ticket detail view.
- Status -- The current ticket status, often color-coded.
- Priority -- The ticket priority level, often color-coded.
- Created -- The date the ticket was opened.
- Last Update -- The date of the most recent activity on the ticket.
- Assigned -- The name of the support handler assigned to the ticket.
- Custom fields -- Any custom field values configured to show in the list.
Filtering and Sorting
A filter bar is available above the ticket list:
- Add Filter -- Opens a dropdown where you can enter a keyword to search across ticket subjects, messages, reference numbers, and searchable custom fields.
- Ordering -- A dropdown to sort tickets by last update, subject, reference number, creation date, status, or priority.
- Active Filters -- When filters are applied, they appear as removable badge chips. Click the X on a chip to remove that filter, or click Clear All to reset all filters.
Pagination
If you have more tickets than the per-page limit, pagination controls appear below the table.
Empty State
If you have no tickets matching the current tab/filter, an informational message is displayed.
7. Viewing Ticket Details
Click on a ticket subject in the list to open the full ticket detail view. The detail view is organized into two columns.
Left Column: Conversation and Attachments
- Messages -- The full conversation thread between you and the support team. Each message shows the sender name, date/time, and message body. Messages may include formatted text if the rich text editor was used.
- Attachments -- If any files have been attached to the ticket (by you or the support team), they appear in an attachments section with the filename, file size, uploader name, and upload date. Click a filename to download the attachment.
Right Column: Ticket Information
A sidebar panel displays ticket metadata, which may include:
- Reference number
- Status (color-coded)
- Priority (color-coded)
- Product
- Department
- Category
- Assigned handler
- Date opened
- Last updated
- Custom field values
The administrator may configure which of these details are visible to users.
Rating
If ticket rating is enabled, you may be able to rate the support you received.
Printing
A print option may be available to print the ticket details.
Handler View Link
If you are also a support handler, an informational banner may appear offering a link to view the ticket in the full handler/admin support panel with additional functionality.
8. Replying to a Ticket
To reply to an open ticket, navigate to the ticket detail view and click the Post Reply button.
Inline Reply
In the ticket detail view, clicking Post Reply reveals a reply form directly below the button. The reply form includes:
- Message body -- A text area (or rich text editor) where you type your reply.
- File attachment -- If attachments are enabled, you can upload a file with your reply.
Click Post Message to submit your reply.
Reply and Close
If the administrator has enabled the "Reply and Close" option, a Reply and Close button appears alongside the Post Message button. Clicking it submits your reply and simultaneously closes the ticket.
Full Reply Page
Alternatively, a full-page reply form may be used, which includes:
- Subject -- Pre-filled with "Re: [original subject]".
- Message body -- The text area for your reply.
- File attachment -- Upload section.
- Post Message button to submit.
- Reply and Close button (if enabled).
- Cancel link to return to the ticket view without replying.
Below the reply form, the existing conversation messages and attachments are displayed for reference.
9. Closing and Reopening Tickets
Closing a Ticket
If the site administrator has enabled the user-close option, you can close your own tickets. This is typically done by:
- Clicking a Close button on the ticket detail view, or
- Using the Reply and Close button when posting a reply.
Closing a ticket signals to the support team that you consider the issue resolved.
Reopening a Ticket
If the site administrator has enabled the user-reopen option, you can reopen a previously closed ticket. This is useful if the issue recurs or was not fully resolved. Look for a Reopen button on the ticket detail view of a closed ticket.
10. Changing Ticket Status
If the site administrator has enabled user status changes, you may see a status dropdown on the ticket detail view that allows you to change the ticket's status (e.g., from "Open" to "Awaiting Reply" or another configured status).
Select the new status from the dropdown. The change takes effect immediately or after clicking an update/save button, depending on the implementation.
This feature is optional and may not be available on all helpdesk installations.
11. Ticket Reference Numbers
Every ticket is assigned a unique reference number when it is created. This reference serves as an identifier for your ticket and is used in:
- The ticket list display.
- Email notifications about the ticket.
- Guest ticket lookup (for unregistered users).
The format of the reference number is configured by the site administrator. Common formats include sequential numbers, numbers with prefixes (e.g., TICK-0001), or numbers combined with dates or other identifiers.
You can search for a ticket by its reference number using the search/filter functionality in the ticket list, or by entering it in the ticket lookup form on the login page.
12. Tips and FAQ
How do I find my ticket if I submitted as a guest?
Go to the helpdesk page and use the Track Ticket section at the bottom of the login page. Enter your ticket reference number. If your site uses password-protected guest tickets, you will also need the password that was emailed to you. If you have forgotten your password, use the "Forgot your password?" link to request an email with your ticket details.
Can I attach files to my ticket?
File attachments are available if the site administrator has enabled them. The allowed file types and maximum file size are displayed on the upload form. If you do not see an upload option, attachments may be disabled for your access level.
Why am I asked to search before creating a ticket?
Some helpdesk installations require you to search the FAQ and Knowledge Base before submitting a ticket. This helps you find answers faster and reduces duplicate requests. After performing the search, you will be able to proceed with creating a ticket if you did not find a suitable answer.
Why can I not see certain fields or options?
The site administrator controls which fields, buttons, and options are visible to end-users. Features such as priority selection, status changes, close/reopen buttons, and certain custom fields may be hidden or restricted based on the site's configuration and your user permissions.
Can I view tickets from other users in my organization?
If the administrator has set up ticket groups, you may be able to see tickets submitted by other members of your group. This is configured on a per-group basis and depends on the group's shared visibility settings.
How do I know when there is a reply to my ticket?
The system sends email notifications when there is activity on your ticket (such as a reply from the support team or a status change). Make sure the email address associated with your account is correct and check your spam folder if you are not receiving notifications.
What should I include in my ticket for the fastest resolution?
- Use a clear, descriptive subject line.
- Provide detailed information about your issue in the message body.
- Attach relevant screenshots or files if possible.
- Fill in all required custom fields accurately.
- Select the correct product, department, and category so your ticket reaches the right team.