Troubleshooting Ticket Attachment Downloads in BoldDesk
If you are unable to download an attachment from a BoldDesk ticket, the issue is usually related to login identity, brand context, or brand preference settings. This article explains how attachment access works in BoldDesk and provides step‑by‑step instructions to resolve common download issues.
Use Cases
This guide is useful when:
- Customers cannot download attachments from a ticket
- Users are prompted to log in repeatedly when accessing files
- Attachments fail to download in a multi‑brand setup
- Agents need to guide customers on proper attachment access
How Attachment Access Works in BoldDesk Tickets
In BoldDesk:
- Ticket attachments are secured by user identity and brand context
- Attachments can only be downloaded by users authenticated with the same email address used to create the ticket
- Each ticket belongs to a specific brand, and access must match that brand’s customer portal
To resolve the issue, kindly follow these steps.
Verify Login Email Address
Attachments are accessible only when the user is logged in with the exact email address associated with the ticket.
What to Check
- Ensure the email address used to sign in matches the ticket requester’s email
- If you have multiple email addresses, confirm which one was used to submit the ticket
If a ticket was created using a specific email address, attachments cannot be downloaded using a different email, even if both belong to the same user.
Access Tickets Using the Correct Brand URL
In a multi‑brand BoldDesk account, each ticket is associated with a specific brand.
Best Practice
- Always access the ticket using the customer portal URL of the same brand
- Avoid opening a ticket from Brand A while logged into Brand B’s customer portal
This prevents repeated authentication prompts and ensures attachment access is validated correctly.
In BoldDesk, seamless file downloads across multiple brands without repeated logins are supported only within the Agent Portal. This behavior does not apply to the Customer Portal, where brand context and authentication must match the ticket’s brand.
Set Default Brand Preference (Recommended)
Setting your default brand preference ensures that tickets and attachments open under the correct brand context automatically.
Steps to Change Default Brand Preference
- Click Profile → Personal Settings
- Select the Brand option
- Choose Inherit from URL
This automatically aligns the Brand filter on the ticket list with the active customer portal URL.
Common Scenarios and Resolutions
| Scenario | Recommended Action |
|---|---|
| Attachment download fails | Verify login email matches ticket requester |
| Repeated login prompts | Use the correct brand customer portal URL |
| Wrong brand tickets loading | Enable Inherit from URL in Personal Settings |
| Multi‑brand confusion | Access tickets only from their assigned brand |
Frequently Asked Questions
- Can I download a ticket attachment without logging in?
It depends on how the attachment is accessed.
-
Via the BoldDesk UI (Agent Portal or Customer Portal):
No. Users must be authenticated to download ticket attachments. -
Via the Get Ticket Attachments API:
Yes. When using the Get Ticket Attachments API, BoldDesk generates a secure fileURL along with an attachment token. This URL allows the file to be downloaded directly without requiring login credentials.
-
Can agents change attachment permissions for individual tickets?
No. Attachment access is controlled automatically based on ticket requester and brand. -
Does switching brands affect attachment access?
Yes. Attachments must be accessed using the ticket’s associated brand portal. -
Can automation rules grant attachment access?
No. Automation Rules do not control attachment download permissions.
