> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nocknock.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# NOCK Quickstart: Collect Your First Ticket in 5 Minutes

> Set up NOCK from scratch: create an account, add a project, embed the widget script tag, and receive your first feedback ticket in about five minutes.

NOCK is up and running faster than you might expect. This guide walks you through creating your account, setting up a project, embedding the widget, and verifying everything works — from zero to live feedback collection in about five minutes.

<Steps>
  <Step title="Create your account">
    Go to [nocknock.cloud](https://nocknock.cloud) and sign up with your email address. After confirming your email, you'll land in the onboarding flow.
  </Step>

  <Step title="Create a workspace">
    A workspace is the top-level container for your team. Give it a name (e.g., your company or agency name) and continue. You can invite teammates later from the workspace settings.
  </Step>

  <Step title="Create a project">
    A project represents one website or web application. Give it a descriptive name — for example, "Marketing Site" or "App". Each project gets its own widget token.
  </Step>

  <Step title="Copy the widget snippet">
    In your project's **Settings → Widget**, you'll find your personal script tag:

    ```html theme={null}
    <script
      src="https://nocknock.cloud/widget/nock.js"
      data-token="YOUR_PROJECT_TOKEN"
      data-api-base="https://nocknock.cloud"
    ></script>
    ```

    Copy the full snippet — your `data-token` is already pre-filled with your project's token.
  </Step>

  <Step title="Add the snippet to your website">
    Paste the script tag just before the closing `</body>` tag in your HTML. On most frameworks and CMS platforms you can add it in the global layout or footer:

    ```html index.html theme={null}
    <!-- your page content -->
    <script
      src="https://nocknock.cloud/widget/nock.js"
      data-token="YOUR_PROJECT_TOKEN"
      data-api-base="https://nocknock.cloud"
    ></script>
    </body>
    </html>
    ```

    <Tip>Use a global layout file so the widget appears on every page of your site automatically.</Tip>
  </Step>

  <Step title="Send a test ticket">
    Open your website in the browser. You should see the NOCK feedback button in the corner of the page. Click it, fill in a short test message, and submit.

    Switch to the NOCK Dashboard and check the **Tickets** view — your test ticket should appear within a few seconds, complete with browser, OS, and page information.
  </Step>

  <Step title="Optional: Connect Linear">
    If your team uses Linear, you can forward tickets as Linear issues automatically. Head to **Settings → Integrations → Linear** and follow the [connection guide](/linear/connect-linear).
  </Step>

  <Step title="Optional: Share the Customer Portal">
    Give stakeholders or clients a read-only link to view ticket status without dashboard access. Find the share link under **Settings → Customer Portal** or follow the [Customer Portal guide](/customer-portal/enable-share-link).
  </Step>
</Steps>

## What's next

<CardGroup cols={2}>
  <Card title="Configure the Widget" icon="sliders" href="/widget/configure-widget">
    Change the widget position, colors, categories, and more.
  </Card>

  <Card title="Understand Tickets" icon="ticket" href="/dashboard/tickets">
    Learn how to manage, filter, and resolve tickets in the Dashboard.
  </Card>

  <Card title="Connect Linear" icon="link" href="/linear/connect-linear">
    Set up two-way sync with your Linear workspace.
  </Card>

  <Card title="Customer Portal" icon="users" href="/customer-portal/overview">
    Let stakeholders track tickets without a NOCK account.
  </Card>
</CardGroup>