Skip to main content
Project Overview

Guide to Setting Up Your Marker.io Projects

Joe Scanlon avatar
Written by Joe Scanlon
Updated over 3 months ago

Welcome to Marker.io! In this guide, we'll walk you through everything you need to know about setting up, managing, and deleting projects. Whether you're a seasoned user or just getting started, we'll make sure you understand each step in simple terms.

What is a Project?

A project is a dedicated space where you can collect and manage issues about your website. You can create a project directly in Marker.io or connect it with your favorite issue tracker or project management tool. This integration helps keep everything organized in one place.


Adding a Project

Here's how you can create a new project in Marker.io:

  1. Create a Project:

    • Click on "Create Project."

    • Enter your project name and the website URL where you'd like to collect issues.

  2. Select an Integration:

    • Choose your preferred integration tool from the list.

    • If you don’t want to use an integration, simply continue without one.

  3. Connect to an Integration (Optional):

    • If you choose an integration, select an area within that tool where you want to log issues.

    • Click "Create Project."

    For example, when using Jira, you'll need to choose the specific project or area where issues will be logged.

  4. No Integration? No Problem:

    • If you choose not to use an integration, just click "Create Project" to finish.


Project Settings

Project Notifications

Stay updated with Slack and email notifications. Customize your notification settings to suit your needs. Check out our notification options for more details.

Widget Appearance

You can change the widget's color, text, and position or even use custom branding to match your website. Learn how to do this in our widget appearance guide.

Configure Forms

You can customize a wide range of settings for your forms to best suit your workflow needs. Take time to configure these settings to ensure issues are directed to the right areas in your tools. For step-by-step help, check out our comprehensive guide on widget form configuration.

Install The Widget

You have many options to install our widget on your website. We generally recommend the JavaScript snippet code. Check all installation options here.


Collecting Website Issues

When someone clicks on the Marker.io widget on your site, they’ll see a clear screenshot and a form to report issues. The system automatically includes technical information to help you resolve problems faster. Reporters can monitor their issues, add comments, upload files, and view the status on their personal issue page.

See our issue guide for more info.


Inviting Users to a Project

Why Invite Users?

Inviting users can be beneficial in many ways:

  • Guests: If someone is expected to report many website issues, invite them as a guest. They'll be able to see their issues and those reported by other guests.

  • Members: If you have internal users who need to give detailed issue reports (QA Team), or see the technical details on issues (Developer Team) consider adding them as members.

How to Invite People

Learn how to invite people to your account by checking out our user roles guide.


Archiving and Deleting Projects

Archive a project

Archiving a project disables issue reporting and removes it from your dashboard, but you can restore it later if needed.

  • To archive, go to the project’s General settings > Archive.

  • You can also archive projects directly from your dashboard.

CleanShot 2023-02-01 at 17

Delete a Project

Deleting a project permanently removes it along with all its issues and settings. Be sure you no longer need it before taking this step.

  • To delete, go to the project’s General settings > Delete.


Frequently Asked Questions

Can I set up two separate projects, one with and one without an integration?

Yes, you can create as many projects as you like, with or without integrations.

Can I link my no-integration project to an integration later on?

Currently, this feature is not available, but we're working on it. Check out our guide on this topic here.


Need Help?

If you have any questions, comments, or corrections, chat with us at the bottom right of our web pages.

Did this answer your question?