Skip to content
  • There are no suggestions because the search field is empty.

What can I attach to issues?

Add files, images, videos, and interactive content to make your issues more helpful and actionable

Issues work best when they include the context your team needs to understand and solve problems. You can attach files, embed interactive content from other tools, and use AI features to make your issues more comprehensive and useful.

Quick Start: Adding Files and Images

The easiest way to enhance your issues is by adding files directly. Simply drag and drop any file into an issue description or comment, and it uploads automatically. This works for screenshots, documents, videos, and more.

To attach a file:

  1. Open any issue
  2. Drag your file into the description or comment box
  3. The file uploads and appears inline automatically

Most common attachments:

  • Screenshots for showing bugs or desired features
  • Documents like requirements or specifications
  • Videos for demonstrating problems or walkthroughs
  • Design files when you need to share mockups

TIP: Name your files descriptively before uploading. "login-error-screenshot.png" is much more helpful than "Screen Shot 2025-01-15.png" when your team reviews the issue later.

What Files Can I Upload?

Zenhub supports most file types you'll need for project work:

  • Images: PNG, JPEG, GIF, WEBP, SVG (up to 10MB)
  • Videos: MP4, MOV, WEBM (up to 100MB)
  • Documents: Word, PowerPoint, Excel, PDF (up to 25MB)
  • Code files: Text files, log files (up to 25MB)
  • Compressed files: ZIP, GZIP files (up to 25MB)

File Display: Images and videos show up directly in your issues so team members can see them immediately. Other files appear as downloadable links. All files are stored securely and only accessible to people in your organization (unless you change your workspace settings).

Interactive Content from Other Tools

Beyond basic files, you can embed live content from tools your team already uses. When you paste links from supported platforms, they display directly in your issues with full functionality.

Figma Designs Paste any Figma link and see design files directly in your issue. The embedded content stays up-to-date automatically, so developers always see the latest designs without leaving Zenhub.

Loom Videos
Drop in Loom links to show bug demonstrations, feature explanations, or user experience walkthroughs. Videos play right in the issue, making it easy to share visual context.

Miro Boards Include links to collaborative whiteboards, user journey maps, or brainstorming sessions. Team members can interact with the boards directly from the issue.

How embedding works:

  1. Copy the link from Figma, Loom, or Miro
  2. Paste it anywhere in your issue description or comments
  3. The content appears automatically - no setup required

Notion Documents

Notion integration requires a one-time setup but then works seamlessly for embedding documentation and project context.

Setting up Notion:

  1. Go to your Zenhub account settings → "Integrations"
  2. Click "Connect" under "Connect your Notion account"
  3. Choose which Notion pages to make accessible from Zenhub
  4. Click "Allow access"

Once connected, paste any Notion document link into an issue and it displays with a content preview. Your team members need their own Notion accounts to view the full content.

AI-Powered Content Help

Zenhub includes AI features that help you create better issue content and keep things organized consistently.

Smart Label Suggestions When you write an issue description, Zenhub automatically suggests relevant labels based on your content and repository patterns. Just click on any suggestions that fit to apply them instantly.

Acceptance Criteria Generation For feature requests and user stories, click "Generate AI Acceptance Criteria" after writing your description. The AI creates a structured list of requirements you can edit and customize for your needs.

These AI features learn from your team's patterns over time, so they get more accurate and helpful as you use them.

Comments and Connections

Adding Comments Use comments to share updates, ask questions, or provide additional context. You can attach files to comments the same way you do in issue descriptions - just drag and drop.

Linking Related Issues Connect related work by referencing other issues with #123 (same repository) or org/repo#123 (different repository). Include a brief explanation of why issues are connected rather than just dropping in numbers.

File Privacy and Access

Your workspace settings control who can see uploaded files:

  • Private uploads (recommended): Only people in your Zenhub organization can view files
  • Public uploads: Files are accessible to anyone with the link, including GitHub users without Zenhub

Most teams use private uploads to keep their work secure while ensuring everyone on the team has access.

Common Issues and Solutions

Files won't upload?

  • Check your file size (images up to 10MB, videos up to 100MB, others up to 25MB)
  • Try a different browser if uploads keep failing
  • Make sure your file type is supported

Embedded content not showing?

  • Verify you're using direct links to specific content, not general workspace links
  • For Notion, make sure both you and viewers have connected their accounts
  • Check that the original content hasn't been deleted or made private

FAQ

Q: Can I edit files after uploading them?
A: You can delete files from your own comments, but not from other people's comments or issue descriptions. It's usually easier to upload a new version with a clear filename like "design-v2.png".

Q: Do embedded links update automatically?
A: Yes, embedded content from Figma, Loom, and Miro shows the current state automatically. If you update a Figma design, the embedded version in your issue updates too.

Q: What happens if I share an issue with someone outside my organization?
A: They can see the issue text but won't be able to view uploaded files (unless you've set file uploads to public). Embedded content from other tools depends on their permissions in those tools.

Q: Can I embed content from tools other than Figma, Loom, Miro, and Notion?
A: Currently, only these four platforms support direct embedding. For other tools, you can still include links in your issues, but they won't display previews.

Q: How do I know if my files are set to private or public?
A: Check your workspace privacy settings. Look for the "File Uploads" section to see your current setting and change it if needed.