Documentation/Troubleshooting
πŸ”§

Troubleshooting

Solutions to common issues

Chat Capture Issues

Emoji reactions not capturing ideas

Symptoms: You react with πŸ’‘ but nothing appears in IdeaLift.

Solutions:

  • 1.Check bot is in the channel: The IdeaLift bot must be added to each channel where you want to capture ideas. In Slack, use /invite @IdeaLift. In Discord, ensure the bot has access to the channel.
  • 2.Use the correct emoji: Use πŸ’‘ (lightbulb). Some platforms have multiple similar emojisβ€”make sure you're using the standard one.
  • 3.Check connection status: Go to Dashboard β†’ Integrations and verify your Slack/Discord/Teams connection shows as "Connected".
  • 4.Reconnect the integration: If status shows issues, disconnect and reconnect the platform.

Bot not responding to slash commands

Symptoms: /idea or /idealift commands don't work.

Solutions:

  • 1.Discord: Use /idea (not /idealift)
  • 2.Slack: Use /idealift (not /idea)
  • 3.Teams: Mention the bot: @IdeaLift capture
  • 4.Check permissions: Your Slack admin may need to approve the app for slash commands.

Ideas captured but not appearing

Symptoms: Bot confirms capture, but ideas don't show in dashboard.

Solutions:

  • 1.Check the Inbox: New ideas go to the Inbox first. Go to Dashboard β†’ Ideas β†’ filter by "Inbox".
  • 2.Check workspace: Make sure you're viewing the correct workspace (if you have multiple).
  • 3.Refresh the page: Dashboard may need a refresh to show new items.
  • 4.Clear filters: Reset all filters to see all ideas.

GitHub / Linear / Jira Issues

Can't connect GitHub

Solutions:

  • 1.Check GitHub App installation: Install the IdeaLift GitHub App from the GitHub Marketplace.
  • 2.Repository access: Grant access to specific repositories or all repositories in your org.
  • 3.Org permissions: If using an organization, you may need admin approval for the GitHub App.

Issues not syncing back from Linear/Jira

Symptoms: You close an issue in Linear/Jira but IdeaLift doesn't update to "Shipped".

Solutions:

  • 1.Check webhook configuration: Go to Dashboard β†’ Integrations β†’ Linear/Jira β†’ Webhook settings.
  • 2.Verify webhook is active: The webhook URL should be added to your Linear/Jira project settings.
  • 3.Wait a moment: Webhook sync can take up to a minute.
  • 4.Reconnect integration: If webhooks aren't firing, try disconnecting and reconnecting.

Push to issue tracker fails

Symptoms: Error when trying to create an issue from an idea.

Solutions:

  • 1.Check repository/project selection: Make sure you've selected a default repository or project in Dashboard β†’ Integrations.
  • 2.Verify permissions: Your account needs write access to the target repo/project.
  • 3.Token expiration: OAuth tokens can expire. Try disconnecting and reconnecting the integration.
  • 4.Jira issue type: Make sure you've selected a valid issue type for your project.

Dashboard Issues

Dashboard not loading

Solutions:

  • 1.Clear browser cache: Try hard refresh (Ctrl+Shift+R or Cmd+Shift+R).
  • 2.Check session: Your session may have expired. Log out and log back in.
  • 3.Try incognito mode: Browser extensions can sometimes interfere.
  • 4.Check status page: Visit status.startvest.ai for any service issues.

Search not finding ideas

Solutions:

  • 1.Clear all filters: Active filters may be hiding results.
  • 2.Check spelling: Search matches exact words in titles and summaries.
  • 3.Search by parts: Try shorter search terms if full phrases don't match.

Analytics not showing data

Solutions:

  • 1.Check date range: Adjust the date filter to include the period you want.
  • 2.Plan requirements: Some analytics features require Pro plan or higher.
  • 3.Data delay: Analytics may take a few minutes to update after new ideas are captured.

Browser / VS Code Extensions

VS Code extension not connecting

Solutions:

  • 1.Get your API key: Go to Dashboard β†’ Integrations β†’ API Keys and copy your key.
  • 2.Configure the extension: Run IdeaLift: Configure API Key from the command palette.
  • 3.Reload VS Code: After configuring, reload the window (Ctrl+Shift+P β†’ "Reload Window").

Chrome extension not capturing

Solutions:

  • 1.Log in: Click the extension icon and make sure you're logged in.
  • 2.Check permissions: The extension needs access to the current page to capture content.
  • 3.Reinstall: Remove and reinstall the extension from the Chrome Web Store.

Billing & Account

Can't upgrade plan

Solutions:

  • 1.Check workspace ownership: Only workspace owners can upgrade. Go to Team settings to verify your role.
  • 2.Payment method: Make sure your credit card is valid and has available credit.
  • 3.Contact support: If the issue persists, contact support@startvest.ai.

Hit idea limit

Symptoms: "Monthly idea limit reached" message.

Solutions:

  • 1.Upgrade: Pro plan offers unlimited ideas.
  • 2.Wait for reset: Free tier resets on the 1st of each month.
  • 3.Clean up: Delete rejected/duplicate ideas to make room (doesn't reclaim limit).

API & Webhooks

API returning 401 Unauthorized

Solutions:

  • 1.Check API key: Verify the key is correct and hasn't been regenerated.
  • 2.Check header format: Use Authorization: Bearer YOUR_API_KEY
  • 3.Regenerate key: If the key was compromised, regenerate it in Dashboard β†’ Integrations.

Webhooks not firing

Solutions:

  • 1.Verify URL: Make sure your webhook endpoint is publicly accessible (HTTPS required).
  • 2.Check subscription: Ensure the webhook subscription is active in Dashboard β†’ Integrations.
  • 3.Test endpoint: Use a tool like webhook.site to verify your endpoint receives requests.
  • 4.Return 200: Your endpoint must return a 200 status code within 30 seconds.

Still Need Help?

If you couldn't find a solution above, we're here to help.

Tip: When contacting support, include your workspace name, the steps to reproduce the issue, and any error messages you see.