Docs/Installation guide

Installation guide

Get Asktopus up and running on your website in under 5 minutes

1

1. Create an account

Go to app.asktopus.com and create a free account.

2

2. Add your website

Enter your website URL in the dashboard. Asktopus will automatically start crawling your site.

3

3. Wait for crawling

Crawling typically takes between 1 and 10 minutes depending on your website's size. You can follow the progress in the dashboard.

4

4. Copy the embed code

When the crawl is complete, you'll find your unique embed code on your site's Overview tab in the dashboard, under "Embed code".

5

5. Paste the script tag

Paste the script tag just before </body> on your website.

Standard HTML

<script
  src="https://cdn.asktopus.com/v1/your-site-id.js"
  async
></script>

WordPress

Add the code in Appearance → Theme Editor → footer.php, just before </body>. Or use a plugin like "Insert Headers and Footers".

<!-- Add to footer.php before </body> -->
<script
  src="https://cdn.asktopus.com/v1/your-site-id.js"
  async
></script>

Shopify

Use the Asktopus app for Shopify instead of pasting code. It opens your theme editor with the chat switched on, so you only click Save, and it reads your products, pages and policies directly.

Next.js

Add the script tag in your layout component using next/script.

// app/layout.tsx
import Script from 'next/script'

export default function RootLayout({ children }) {
  return (
    <html>
      <body>
        {children}
        <Script
          src="https://cdn.asktopus.com/v1/your-site-id.js"
          strategy="lazyOnload"
        />
      </body>
    </html>
  )
}