# CSS Snippets

You can use these snippets to quickly make adjustments to the layout, elements, menus, etc of your superblog. Just add the new CSS in the ["Custom CSS"](./dashboard/settings/#custom-css) section and click the "Deploy" button.

## Manipulate the image's max-width
Increase the image width to exceed the max-width of the blog post's content.  

```css
.se-component.se-image-container.__se__float-none img {
    max-width: 120%;
    width: 120%;
    margin-left: -10%;
}

@media (max-width: 768px) {
    .se-component.se-image-container.__se__float-none img {
        max-width: 100%;
        width: 100%;
        margin-left: 0;
    }
}
```

## Manipulate the iframe's max-width
Increase the iframe width to exceed the max-width of the blog post's content. 

```css

.se-component.se-video-container.__se__float-none {
    max-width: 140% !important;
    width: 140% !important;
    margin-left: -20% !important;
    position: relative;
}

.se-component.se-video-container.__se__float-none figure {
    width: 100% !important;
    padding-bottom: 56.25% !important;
    margin: 0 !important;
}

.se-component.se-video-container.__se__float-none iframe {
    position: absolute !important;
    top: 0 !important;
    left: 0 !important;
    width: 100% !important;
    height: 100% !important;
}

@media (max-width: 768px) {
    .se-component.se-video-container.__se__float-none {
        max-width: 100% !important;
        width: 100% !important;
        margin-left: 0 !important;
    }
}
```


## Center-align the post title

```css
.post-title {
    text-align: center;
}
```

<!-- ## Change background color

```css

:root {
    --theme-color: #16023E;
    --body-bg-color: #FBF6FF;
    }
    
    * .footer {
    background-color: var(--theme-color) !important;
    }
    
    .nav-header {
    background: var(--body-bg-color) !important;
    }
    
    button#nav-cta {
    background-color: #F3C34F !important;
    color: #000 !important;
    border-radius: 24px !important;
    }
    
    .__se__toc-new-container {
    
    background-color: var(--theme-color) !important;
    }
    
    .sitebox {
    
    background-color: var(--theme-color) !important;
    }
    
     .post-content {
    
    background-color: #FFF !important;
    border-radius: 16px !important;
    padding: 8px 16px!important;
    } 
    

``` -->
---
sidebar_position: 2
---

# Deploy
Whenever you make any change in your Superblog like updating settings, adding a new post, editing a post, or anything else you can see the "Deploy" button is activated. 

Read more [here](./../dashboard/deploy.md)


## Trigger a deploy


You can send a `POST` request as below to retieve a list of posts.

#### Javascript

```js
const response = await fetch(
  // you can change the page number for pagination
  "https://write.superblog.ai/api/sites/supername/your-supername/deploy",
  {
    headers: {
      //.....
      //.....
      "x-superblog-access-key": "your-api-key",
    },
  }
);

const data = await response();
```
---
sidebar_position: 1
---

# Intro
Superblog API is completely based on REST.
It is as intuitive as it can get. 

Entire superblog dashboard is built with REST API. So, any action that you can do in dashboard can also be done with API.

You need to be on the [SUPER](https://superblog.ai/pricing) plan for API access.

#### Note
Sample code is shown in the docs is in Javascript. But you can use <b>ANY language</b> to interact with superblog API. 

## Authentication

1. Generate an API key from `View Dashboard > Data > API Keys` section.
2. Pass the obtained API key with every request in a custom header `x-superblog-access-key`.

### Example

#### Javascript

```js
const response = await fetch("https://write.superblog.ai/api/sites", {
    headers: {
        //.....
        //.....
        "x-superblog-access-key": "your-api-key",
    }
});

const data = await response();

```


## Endpoints

Every single action that you do in [superblog dashboard](https://write.superblog.ai) is an endpoint.

You can open developer tools in Google Chrome and Visit `Network` tab to see the endpoints, request, and response data.


## Supername / Superblog Id

You will notice a `supername` component in the url slug for endpoints. It is nothing but the id of your superblog address that you can entered during creation of superblog.

![Image](./../../static/img/superblog-supername.png "superblog supername")
---
sidebar_position: 2
---

# Posts

## Retrieve Posts

You can send a `GET` request as below to retieve a list of posts.

#### Javascript

```js
const response = await fetch(
  // you can change the page number for pagination
  "https://write.superblog.ai/api/sites/supername/your-supername/posts?page=1&getPostContent=true",
  {
    headers: {
      //.....
      //.....
      "x-superblog-access-key": "your-api-key",
    },
  }
);

const data = await response();
```

## Create a post

You can send a `POST` request as below to create a new post.

#### Javascript

```js
const response = await fetch(
  "https://write.superblog.ai/api/sites/supername/your-supername/posts",
  {
    headers: {
      //.....
      //.....
      "x-superblog-access-key": "your-api-key",
    },
    // Mandatory fields
    body: JSON.stringify({
      post: {
        status: "PUBLISHED",
        hideSharingIcons: false,
        enableComments: false,
        title: "sample post title hola",
        tagIds: [],
        content: "<p>hello world</p>",
      },
    }),
  }
);

const data = await response();
```



---
sidebar_position: 3
---

# Categories

```View Dashboard > Categories```

You can select a category for a post from the post editor page.

## Categories on Home page

You can add categories section on your blog's homepage.

![Image](./../../static/img/categories-homepage.png "superblog post categories home page")


### How to configure

Visit `View Dashboard > Settings > Advanced section`

### Note
If a post has no category assigned then the first tag of the post is displayed below the post title on the homepage.

## Exclude posts of certain categories from homepage

You can select certain categories to be excluded, then the posts of those categories will not be displayed on the homepage but they will be available as individual posts on their specific urls.

### How to configure

Visit `View Dashboard > Settings > Advanced section`
---
sidebar_position: 3
---

# Custom Domain

`View Dashboard > Custom Domain`

You can connect Superblog to your own domain. It can be a subdomain or subdirectory.  
Once you enter your desired URL like `blog.example.com` or `example.com/blog` in the text box, click the `Connect` button to receive instructions.

![Image](./../../static/img/custom-domain.png "superblog custom domain")

## Subdomain

Connecting your subdomain `blog.example.com` to Superblog is probably the easiest way. If you are non-technical or not really focused on SEO then choose this method.

However, most SEO experts say to use a subdirectory instead of a subdomain. Read more about this [here](https://superblog.ai/blog/blog-hosting-subdomain-vs-subfolder-cklto3qsr00101imuikysv7yd).

## Subdirectory

For the best SEO benefits, prefer connecting your blog to a subdirectory like `example.com/blog`. Configuring this is a bit technical and might require expert guidance.

But do not panic, once you connect your required URL, step-by-step instructions will be shown in the Superblog dashboard itself. You can select your tech stack to receive the configuration details.

It'll take around 10 minutes to superblog on your subdirectory.

### Note

Typically, you can setup a reverse proxy or Superblog provides one for you.  
(No additional purchase is needed, it is included in the plan)
---
# sidebar_position: 3
---

# Data

`View Dashboard > Data`

All things related to your Superblog's data like import, export, and API keys are found this section.

<!-- ![Image](./../../static/img/data.png "superblog data section") -->

## Import posts

You can migrate your blog from existing platforms like WordPress, Ghost, Webflow, Blogger, Medium, Drupal, Spreadsheets, Zip files, etc. easily with one click. All your existing posts, tags, url-slugs are imported automatically.

However if you want to optimize the images and store them in Superblog CDN automatically then you need to run the migration after upgrading to a paid plan.

## Migrate From WordPress

You can import your existing WordPress posts to Superblog in less than 2 minutes with one click.

![Image](./../../static/img/data-import.png "superblog migration from other platforms")

![Image](./../../static/img/data-import-wordpress.png "superblog migrate from wordpress")

1. Create a Superblog.
1. Visit your Dashboard by clicking ‘View Dashboard’.
1. Click ‘Data’ in the left sidebar.
1. Click the ‘Import from WordPress' button in the ‘Data’ section.
1. Now, you will see a popup asking you to enter your WordPress blog’s URL.
1. You need to give the URL of your WordPress installation and not the vanity URL of the blog.

### Note

For example, if your WordPress installation is at the root URL of your domain called mysamplesite.com then enter http://mysamplesite.com (if you have SSL, then https).

Some people might be confused about it because they have their blog at mysamplesite.com/blog and tend to enter that URL. Always enter the URL of your WordPress installation as mentioned above.

### Special cases

1. Sometimes, your root domain will be mysamplesite.com and your WordPress is installed in mysamplesite.com/blog. Then you need to enter https://mysamplesite.com/blog.

1. If your WordPress is installed at https://blog.mysamplesite.com then enter https://blog.mysamplesite.com.

## Migrate From Ghost

You can import your existing Ghost posts to Superblog in less than 2 minutes with one click.

![Image](./../../static/img/data-import.png "superblog migration from other platforms")

![Image](./../../static/img/data-import-ghost.png "superblog migrate from ghost")

1. Create a Superblog.
1. Visit your Dashboard by clicking ‘View Dashboard’.
1. Click ‘Data’ in the left sidebar.
1. Click the ‘Import from Ghost' button in the ‘Data’ section.
1. Enter your blog’s URL, Content API Key, Select Ghost’s API Version, and click the **“Start Import”** button.

### Note

You can get your Content API key from Ghost's admin panel.

1. Login to your Ghost blog's admin planel.
1. Click "Integrations" in the sidebar.
1. Create a new "Custom Integration" to receive your Content API key.

## Migrate From Blogger

You can import your existing Blogger posts to Superblog in less than 2 minutes with one click.

![Image](./../../static/img/data-import.png "superblog migration from other platforms")

![Image](./../../static/img/data-import-blogger.png "superblog migrate from blogger")

1. Create a Superblog.
1. Visit your Dashboard by clicking ‘View Dashboard’.
1. Click ‘Data’ in the left sidebar.
1. Click the ‘Import from Blogger' button in the ‘Data’ section.
1. Enter your blog’s URL and click the **“Start Import”** button.

## Migrate From Webflow

You can import your existing Webflow posts to Superblog in less than 5 minutes with one click.

![Image](./../../static/img/data-import.png "superblog migration from other platforms")

![Image](./../../static/img/data-import-webflow.png "superblog migrate from webflow")

1. Create a Superblog.
1. Visit your Dashboard by clicking ‘View Dashboard’.
1. Click ‘Data’ in the left sidebar.
1. Click the ‘Import from Webflow' button in the ‘Data’ section.
1. Enter your blog’s URL and click the **“Start Import”** button.

Now, you will see a popup asking you to enter your Webflow details.  
They are explained below.

#### API key

![Image](./../../static/img/data-import-webflow-s4.png "webflow API key generate")

1. Visit your Webflow Dashboard.
1. Go to your site>settings>"Apps & Integrations".
1. Scroll down to see the “Generate new API token” button and click it. (always choose v2 token)
1. Select "CMS" field and choose "Read-only" access.
1. Give your token a name and click "Generate" button.
1. Copy-paste the API token in the above form.

#### Post Collection Id

You might have created a CMS collection to write posts on your webflow site. You can visit the CMS section of your webflow site and find the ID in the settings.

![Image](./../../static/img/data-import-webflow-s2.png "webflow post collection id")

#### Post Body Field

You might have created the Post model with certain fields in Webflow CMS. You need to enter the name of the field that holds the content of your post during migration.

For example, I created a “content” field to hold the post's body/text/html in my CMS. It could be “post-body”, “post-content”, etc in your CMS depending on who created it.

![Image](./../../static/img/data-import-webflow-s3.png "webflow post body field")

## Migrate From Medium

You can import your existing Medium posts to Superblog in less than 2 minutes with one click.

![Image](./../../static/img/data-import.png "superblog migration from other platforms")

![Image](./../../static/img/original/data-import-medium-zip.png "superblog migrate from medium")

1. Create a Superblog.
1. Visit your Dashboard by clicking ‘View Dashboard’.
1. Click ‘Data’ in the left sidebar.
1. Click the ‘Import from Medium' button in the ‘Data’ section.
1. Now, you will see a popup asking you to upload your Medium archive [data zip](https://help.medium.com/hc/en-us/articles/115004745787-Export-your-account-data). 
1. Upload the zip file and click the "Start Import" button.

<!-- ### Note

If your medium’s address is **abcd.medium.com**, then you need to enter **abcd**.  
If your medium’s address is **medium.com/@xyz**, then you need to enter **xyz**. -->

## Migrate From Wix

You can import your existing Wix posts to Superblog in less than 2 minutes with one click.

![Image](./../../static/img/data-import.png "superblog migration from other platforms")

![Image](./../../static/img/data-import-wix.png "superblog migrate from wix")

1. Create a Superblog.
1. Visit your Dashboard by clicking ‘View Dashboard’.
1. Click ‘Data’ in the left sidebar.
1. Click the ‘Import from Medium' button in the ‘Data’ section.
1. Now, you will see a popup asking you to enter your API key and Wix Site Id.
1. Enter your Wix API key and Site Id as shown [here](https://dev.wix.com/api/rest/getting-started/api-keys).
1. Click the "Start Import" button.

### Note

1. Site Id will be in this format `rshmsa-a6ab-4e17-ae17-klm9dfb4e79d`.
1. Wix API Key will be a huge string like below
   `IST.eyJraWQiOiJQb3pIX2FDMiIsImFsZyI6IlU2In0.eyJkYXRhIjoie1wiaWRcIjpcIjFmNTAzMjZkLTE5MzEtNDcwMS04ZTZlLTU3N2U4MzE4NzYzMVwiLFwiaWRlbnRpdHlcIjp7XCJ0eXBlXCI6XCJhcHBsaWNhdGlvblwiLFwiaWRcIjpcImI5MWNmNzRhLWNkYjgtNDg5My04OTcyLWJlZTM1MzkwY2Y2NFwifSxcInRlbmFudFwiOntcInR5cGVcIjpcImFjY2MbB73oMrFJ9kugCTDOLu7GtKjPsv-Nhp51QNslYL_E8X7_OmaFRXPzn3FRwFvAoIjDLxCfWZLlGXtZruggi5ca-TP8lANjKnVfELWPAJVY1FRp5LS5h33GW3TyqTx_gsGftvHllcL_keagVs_E5-b2_BTYXvuzovk1-EIuBeJRQeTbLw6nUQiK5bOkBTyt6rWzb_jp3LzDlswkcL5tq2s8g`

## Migrate from Custom CMS

If you are using a CMS like strapi or contentful or any other custom CMS then you can export your posts into JSON file.

Then use the process as explained [here](#import-from-json-file).

## Import from Spreadsheet

![Image](./../../static/img/original/data-import-spreadsheet.png "superblog spreadsheet to blog posts")

You can import upto to 300 blog posts from Spreadsheet into Superblog in less than 2 minutes with one click.

1. You can have the content of the blog post written in HTML or Markdown.
1. The formatting of the content is retained.
1. You need to be on a paid plan to use this feature.
1. The spreadsheet can be of xlsx, csv or xls format.
1. The spreadsheet should strictly be of this format: https://write.superblog.ai/files/import-sample.xlsx

### Spreadsheet format

Your spreadsheet should contain the following columns:

1. **Title**: This is the title of the post
2. **Content**: This is the content of the post. It can be in HTML or Markdown format.
3. **Markdown**: If the content column is in Markdown format, it should be "YES" otherwise "NO" (without quotes).
4. **Published**: If you want the post to be published, it should be "YES" otherwise "NO" (without quotes).
5. **Date**: This is the date of publishing of the post. Format: 9/13/2022 12:30:00 PM GMT+5:30
6. **Slug**: This is the url of the post. Example: how-to-write-a-blog-post-in-2024
7. **Tags**: This is the list of tags seperated by comma that you want to assign for the post. Ex: Tips, Tech, Tutorial
8. **Meta Title (optional)**: This is the meta title of the page. 
9. **Meta Description (optional)**: This is the emta description of the page. 
10. **Schedule DateTime (optional)**: You can schedule posts via spreadsheet. You can mention a date that is in future so that the posts are imported but not published. Format: 9/13/2022 12:30:00 PM GMT+5:30
11. **Disable Auto ToC (optional)**: If you want to disable auto-ToC, it should be "YES" otherwise "NO" (without quotes).
11. **Thumbnail URL (optional)**: You can assign thumbnails to your posts if you add a link to the thumbnail image here. Example: https://upload.wikimedia.org/wikipedia/en/a/a9/Example.jpg

## Import from JSON file

If you have your blog posts in a JSON file then you can import them directly superblog.

![Image](./../../static/img/data-import.png "superblog import posts from json file")

### How to

1. Your JSON file should not have any formatting errors. It should be parsable by `JSON.parse()` method.
1. It should contain an array of posts with fields like title, content, category, tags, etc.
1. You can import 300 blog posts in one go.

### Blog Post Schema Details

1. **Title**

   - **Description**: The title of the blog post. It is a mandatory string field.

2. **Content**

   - **Description**: The main body content of the blog post. It's a mandatory string field.

3. **isPublished**

   - **Description**: A boolean indicating whether the post is published or not. If true, the post is visible to the public.

4. **isMarkdown**

   - **Description**: An optional boolean field indicating whether the content is written in Markdown format.

5. **createdAt**

   - **Description**: The creation date of the post. It must be a valid date string.

6. **publishedAt**

   - **Description**: The date when the post was published. This must be a valid date string.

7. **updatedAt**

   - **Description**: Reflects the last update date of the post. This must be a valid date string.

8. **category (optional)**

   - **Description**: A field for categorizing the post. Useful for filtering posts by category on a blog platform.

9. **tagNames (optional)**

   - **Description**: An array of strings, where each string is a tag related to the blog post. Tags help in organizing content and improving the discoverability of related posts.

10. **slug (optional)**

    - **Description**: A string used as the URL slug for the post. This should be a URL-friendly version of the title or a custom string that helps in SEO.

11. **metaTitle (optional)**

    - **Description**: A string used as the SEO title of the page. This is what will typically be displayed in search engine results and browser tabs.

12. **metaDescription (optional)**

    - **Description**: A string that provides a brief summary of the post for SEO purposes. This description appears under the title in search engine results.

13. **customFeaturedImageUrl (optional)**
    - **Description**: A URL to a custom image for the post. This can be used as a featured image in listings or headers.

### Sample JSON file

```json
[
  {
    "title": "Understanding Zod for Schema Validation",
    "content": "<p>Zod is a powerful library that simplifies the process of validation in JavaScript applications...</p>",
    "isPublished": true,
    "isMarkdown": false,
    "createdAt": "2024-04-20T14:48:00.000Z",
    "publishedAt": "2024-04-21T00:00:00.000Z",
    "updatedAt": "2024-04-21T12:00:00.000Z",
    "category": "Programming",
    "tagNames": ["JavaScript", "Validation", "Zod"],
    "slug": "understanding-zod-validation",
    "metaTitle": "Understanding Zod for Schema Validation",
    "metaDescription": "An in-depth guide on how to use Zod for schema validation in JavaScript.",
    "customFeaturedImageUrl": "https://example.com/images/zod.png"
  },
  {
    "title": "Advanced Techniques in React",
    "content": "# What is React? React offers a plethora of advanced techniques that can help developers optimize their applications...",
    "isPublished": false,
    "isMarkdown": true,
    "createdAt": "2024-04-19T09:30:00.000Z",
    "updatedAt": "2024-04-20T08:45:00.000Z",
    "publishedAt": "2024-04-20T08:45:00.000Z",
    "category": "Web Development",
    "tagNames": ["React", "Web Development", "Frontend"],
    "slug": "advanced-react-techniques",
    "metaTitle": "Advanced Techniques in React",
    "metaDescription": "Learn about advanced techniques in React to improve your web development skills.",
    "customFeaturedImageUrl": "https://example.com/images/react.png"
  },
  {
    "title": "Introduction to Svelte",
    "content": "<p>Svelte is a radical new approach to building user interfaces. Unlike traditional frameworks...</p>",
    "isPublished": true,
    "createdAt": "2024-04-18T07:20:00.000Z",
    "publishedAt": "2024-04-20T10:15:00.000Z",
    "updatedAt": "2024-04-20T11:30:00.000Z",
    "category": "Frontend Technologies",
    "tagNames": ["Svelte", "JavaScript", "UI"],
    "slug": "intro-to-svelte",
    "metaTitle": "Introduction to Svelte",
    "metaDescription": "Discover Svelte, a new way to build efficient, fast, and reactive web interfaces.",
    "customFeaturedImageUrl": "https://example.com/images/svelte.png"
  }
]

```

## Import from Zip file

You can import upto to 300 blog posts from a zip file into Superblog in less than 2 minutes with one click.

1. The zip file can contain .html or .md files.
1. If there any image URLs in the posts, they will be automatically downloaded and uploaded to superblog CDN for maximum performance. (only on paid plans)
1. This feature is available only in SUPER and higher plans.

![Image](./../../static/img/original/data-import-zip.png "superblog import from zip file")

## Export Superblog data

You can export your complete Superblog data like posts, tags, categories, authors in case you want to move out of Superblog at any point of time. The data is downloaded as a JSON file. You can [convert the JSON file to CSV file](https://www.convertcsv.com/json-to-csv.htm) and import it into your favorite CMS.

You can then use the JSON file to import in WordPress using JSON-importer plugin. Or you can use the JSON file programmatically in any CMS. However you need to download the images manually at this point of time.

[Here is a tutorial](https://www.youtube.com/watch?v=w49K3txnmVc) to import superblog data into WordPress. The PRO version of this plugin will automatically download the images.

**Note:**
Always delete your superblog after you confirm the data migration.

![Image](./../../static/img/data-export.png "download superblog data")

## API Keys

You need to be on PRO or higher plan to use this feature. API keys are useful if you want to manage your Superblog via API.

![Image](./../../static/img/data-api-keys.png "superblog migration from other platforms")

1. Click on the 'Generate API key' button to generate a new API key.
1. Copy the code somewhere safe, because you will be able to see it ever again.
1. Click on the "Revoke" button to invalidate the API key.
---
sidebar_position: 2
title: Deploy
---
import useBaseUrl from '@docusaurus/useBaseUrl';

# Deploy


Whenever you make any change in your Superblog like updating settings, adding a new post, editing a post, or anything else you can see the **"Deploy"** button is activated. It is seen in the top right of the dashboard.

You need to click the "Deploy" button to make those changes live. You do NOT need to click "Deploy" after every change. Instead, make all the changes you want and then **Deploy** **once** in the end. **ONCE**.

You will get an email alert after your Superblog is deployed.

![Image](./../../static/img/deploy.png "superblog deploy button")
<!-- <img alt="superblog deploy button" src={useBaseUrl("/img/deploy.png")} /> -->


## Why does it take time to deploy?
You might have noticed that Superblog is blazing fast when compared to WordPress, Medium, Ghost, and almost any other blogging platform out there. It is because Superblog uses a new technology.

If you click the ‘Deploy’ button then your entire blog is re-built into small bits and pieces. Then those are optimized for Speed and SEO to be stored in multiple locations around the world (CDN). That's why it takes a minute or two to deploy. 

When a visitor wants to read your blog, it is served from a server that is located nearest to that visitor.

## What is deploy limit?

If you have received an email that says "You have reached deploy limit" then do not panic. It is simply a measure to prevent abuse of the platform.

The best approach is to make a number of changes (like updating settings, editing existing posts, publishing a new post, changing theme color, etc.,) and then click the 'Deploy' button ONCE at the end.

However, if you need more quota for a day, you can write an email to support to get it reset. 


## Activate the deploy button

If **Deploy** button is disabled for some reason then you can click on the **Question Mark** next to the deploy button to activate it manually.


![Image](./../../static/img/deploy-activate.png "activate superblog deploy button")
<!-- <img alt="activate superblog deploy button" src={useBaseUrl("/img/deploy-activate.png")} /> -->

## Pro Tip

Deploy button gets activated whenever you make a change in your dashboard. For example: edit a post, change a setting, add a menu item, etc.

Instead of clicking deploy each time, you can perform all activities and click **deploy once in the end**.

---
sidebar_position: 1
title: Introduction
---
import useBaseUrl from '@docusaurus/useBaseUrl';

# View Dashboard


After [creating your Superblog](/get-started/create-your-superblog), you can write posts, connect domain, and manage various sections by visiting the dashboard. Click on the **"View Dashboard"** button to proceed. 
<!-- <img alt="customize superblog lead gen form" src={useBaseUrl("/img/new-superblog.png")} /> -->
![Image](./../../static/img/new-superblog.png "customize superblog lead gen form")
---
sidebar_position: 3
---

import useBaseUrl from '@docusaurus/useBaseUrl';

# Leads

`View Dashboard > Leads`

## Intro

You must be writing great blog posts to get readers to your posts. Superblog provides in-built lead generation tools to capture those audience so that you can convert them into leads for your business.

1. Collect leads via Form or Popup or Sidebar Widget.
1. Collect email addresses or mobile numbers (available on ALL plans).
1. By default you can collect either email or mobile number. The reason for this limtiation is the probability of a visitor filling the form down if there are more number of fields.
1. But you can collect custom data using custom fields (only on SUPER plan) if it is mandatory for you.
1. Download your leads anytime as a CSV file.
1. Connect your lead generation to Zapier to automate your marketing (only on SUPER PLAN).
1. Superblog will post your new leads to your Webhook endpoint (only on SUPER PLAN).

<!-- <img alt="customize superblog lead gen form" src={useBaseUrl("img/leadgen-form-samples.png")} /> -->

## Advanced Options

Normally, you can setup lead generation for your entire superblog at once. But if you wish you setup different forms for different posts, you can do that using the **"Advanced Options"** button in the post editor while you are editing a post.

## Form

It will be shown below every blog post and also on the homepage of your Superblog.
The form colors are automatically mapped to your Superblog's theme color.

![Image](./../../static/img/leadgen-form-samples.png "superblog lead gen form samples")

## Popup

Popups must be used cautiously. They cause a bad UX in the reading flow. That's why, Superblog provides popup feature with best practices in mind.

1. Popup is shown only when a visitor tries to exit from the posts page.
1. Popup is not shown when the visitor tries to exit from the home page or any other pages.

![Image](./../../static/img/leadgen-popup-sample.png "superblog lead gen popup")

## Sidebar

A sibebar widget can be used to redirect users to your desired URL or collect email, phone number, or other custom fields. It will be shown on every post.

![Image](./../../static/img/leadgen-sidebar-sample.png "superblog lead gen sidebar widget")


## Customization

You can customize various aspects like Heading, Caption, CTA button, CTA Link, Image, Custom fields.

1. The same form (as configured) is shown beneath every post and also on the home page of the blog.
1. The same popup (as configured) is shown when a user tries to leave any post page.
1. The same sidebar widget is shown on every post's page.
1. You can also add custom fields to collect various points.

<!-- <img alt="customize superblog lead gen form" src={useBaseUrl('img/leads-config.png')} /> -->

<!-- ![Image](./../../static/img/leads-config.png "customize superblog lead gen form") -->

<!-- ## Preview -->

<!-- <img alt="superblog lead gen form preview" src={useBaseUrl('img/leadgen-form-preview.png')} /> -->

<!-- ![Image](./../../static/img/leadgen-form-preview.png "superblog lead gen form preview") -->

## Leads

You can view all leads connected in a table. Details like email or mobile number, date, page (on which the lead was captured), and custom data can be seen.

<!-- <img alt="superblog lead gen form preview" src={useBaseUrl('img/leads-table.png')} /> -->

![Image](./../../static/img/leads-table.png "superblog leads table list")

## Download leads

You can download all the leads as a CSV file by clicking the 'Download Icon' button.

## Zapier integration

You can connect your Superblog to Zapier using official Superblog Integration. This is available only on SUPER plan.

1. Create an API Key from "Data" section in your superblog dashboard.
1. Search for Superblog in Zapier to create a Zap.
1. Paste the API Key obtained in step #1 into the superblog app on Zapier.
1. Choose your destination and configure it to finish the Zap.
1. From now on, whenever you receive a lead your Zap, superblog will make sure it will end up in your zapped location.

## Webhook

Superblog will post your lead data (email, mobile number, custom fields, etc) instantly to your desired webhook or API endpoint. This is available only on SUPER plan.

1. You need to give a http endpoint in the config section.
2. You need to give a bearer token (only the token without "Bearer") so that you can have some authentication while superblog makes a http `POST` request.

## Newsletter feature

There is no newsletter feature. Superblog is built with businesses in mind.
The probability of a reader filling the lead-gen/inquiry form is much much higher than a newsletter subscription form.

However you can customzie the lead generation form to act as a "Subscribe Form".

Once your readers fill the form, you get an email alert and you can manage them from your superblog dashboard. You can download that list to integrate with any other mailing solution or Connect Superblog to Zapier to setup automation.

## Note

This is feature is disabled during trial period to prevent abuse of the platform.
---
sidebar_position: 5
---

# Menu

`View Dashboard > Menu`

Superblog has a beautiful navigation menu options to help your blog's visitors browse your blog. There are two menus available.

1. Navigation Menu
2. Footer Menu

## Navigation Menu

![Image](./../../static/img/menu-nav-sample.png "superblog menu navigation")

## Footer Menu

![Image](./../../static/img/menu-footer-sample.png "superblog menu footer")

## Menu items

You can manage the menu items from dashboard. They can be edited, deleted or rearranged by dragging across the list to edit the navigation menu. You can also add nested items (dropdown menu).

You need to enter an absolute URL for the menu item's destination. For example: "http://my-website.com/sample-path".

![Image](./../../static/img/menu-add.png "superblog menu")

## Dropdown menu (nested menu items)

![Image](./../../static/img/menu-dropdown.png "superblog dropdown menu")



<!-- ## Preview

This is how the navigation menu looks on your blog.

![Image](./../../static/img/menu-sample.png "superblog navigation menu sample") -->

## Call to action button (CTA)

You can have a CTA button in your menu to drive blog traffic to your product/app/landing page. The last item in the menu items automatically becomes a CTA button.

![Image](./../../static/img/menu-sample-cta.png "superblog navigation menu sample")
---
sidebar_position: 6
---

# Pages


```View Dashboard > Pages```

Sometimes you might want to add some pages like About, Contact, or anything to your blog. Superblog has `Pages` feature for this purpose. 

Page displays only the title and content. All other options like Author, Date, Sharing Icons, Comments, Site Description, etc will be hidden.



<!-- <img alt="superblog post render as page" src={useBaseUrl("img/posts-render-page.png")} /> -->
![Image](./../../static/img/pages.png "superblog pages")---
# sidebar_position: 3
---

# Plan

`View Dashboard > Plan`

## Change Plan

You can see the details of your paid plan in this section. (<u><b>Only the OWNER of the superblog can see this section</b></u>)

By clicking the `Change Plan` button you will be taken to [Stripe](https://stripe.com) portal to upgrade/downgrade your plan. You can also download invoices and change your card details.

Stripe is one of the most secure and famous payments providers. We partnered with Stripe for safe billing. Your secure details are never stored on our server.

![Image](./../../static/img/plan.png "superblog billing plan")

## View & Download Invoices

You can view and download your invoices by clicking the **"View Paid Invoices"** button as seen in the above picture.

![Image](./../../static/img/plan-view-paid-invoices.png "superblog view and download invoices")

## Update Address and Billing information

![Image](./../../static/img/plan-billing-information.png "superblog update billing information")

You can view and edit your address, billing information by clicking the **"Update Billing Info"** button as seen in the above picture.

## TAX ID / VAT / GST

![Image](./../../static/img/plan-billing-information.png "superblog update billing information")

You can add your appropriate TAX ID like VAT or GST by editing your billing information. Afterwards, all your invoices will contain the TAX ID.

Also, you can select "Purchase as a business" option while purchasing superblog subscription to get invoices on your company name with TAX ID.

## Delete Superblog & Cancel Subscription

![Image](./../../static/img/plan-delete.png "delete superblog")

We are sorry to see you go! If you think that we can make your experience better, please write to: hello@superblog.ai.

#### How to delete

1. Login to superblog. https://write.superblog.ai
1. Click ‘View Dashboard’ on your blog.
1. In the sidebar, click Plan.
1. Now, you can see the ‘Delete’ button.
1. Once you confirm the deletion, your superblog is deleted.
1. If you have any active subscription, it’ll be cancelled.

### Note

Be sure to back up your blog’s entire data beforehand from the [data](./data.md#export-superblog-data) page.
---
sidebar_position: 2
---

import useBaseUrl from '@docusaurus/useBaseUrl';

# Posts

`View Dashboard > Posts`

You can write new posts and edit existing posts from here. Click on the **"Write New Post"** button or **any post** to go the editor.

<!-- <img alt="superblog posts" src={useBaseUrl("img/posts.png")} /> -->

![Image](./../../static/img/posts.png "superblog posts")

## Bulk View

You can browse your posts in a table format via bulk view.

![Image](./../../static/img/posts-bulk-view.png "superblog posts bulk view")

## Import Post

You can import post from .docx, .html, and .md files. This feature is handy if you want to write your blog posts in Google Docs, Notion, or Markdown. Simply export your post as html or docs or markdown format from anywhere and import into superblog in one click.

![Image](./../../static/img/posts-import.png "superblog import posts from google docs, notion")

## Editor

Superblog has a very advanced editor that helps you write SEO-focused content with certain restrictions for sanity. All the content you see is when you write is rendered exactly on your Superblog. This is a WYSIWYG editor and that's why no preview is required.

<!-- <img alt="superblog editor" src={useBaseUrl("img/posts-editor.png")} /> -->

![Image](./../../static/img/posts-editor.png "superblog editor")

### Features

1. Text formatting - Normal, Heading, Subheading, Quote, Code
1. Text style - Bold, Italic,
1. List - Numbered, Normal
1. Anchor links - can open in new tab
1. Schedule Posts
1. Upload images
1. Insert videos links from Youtube/Vimeo
1. Align text - left, right, center, justified
1. Paragraph seperator
1. Table of Contents (ToC) - can autogenerate a table of contents from the content
1. Code view - you can edit the html directly
1. Callout CTA section

## Publish post

You can find the "Publish Post" button on the right side to the editor if a post is not published already. Click it to publish the post. (You can see its status below the action button)

<!-- <img alt="superblog publish a post" src={useBaseUrl("img/posts-publish.png")} /> -->

![Image](./../../static/img/posts-publish.png "superblog publish a post")

## Unpublish post

You can find the "Unpublish Post" button on the right side to the editor if a post is published already. Click it to unpublish the post anytime. (You can see its status below the action button)

<!-- <img alt="superblog unpublish a post" src={useBaseUrl("img/posts-unpublish.png")} /> -->

![Image](./../../static/img/posts-unpublish.png "superblog unpublish a post")

## Schedule post

You can find the "Calender Icon" button on the right side to the editor to schedule a post.

![Image](./../../static/img/posts-editor-schedule-1.png "superblog schedule a post")

![Image](./../../static/img/posts-editor-schedule-2.png "superblog schedule a post modal")

## SEO best Practices

<!-- <img alt="superblog SEO best practices" src={useBaseUrl("img/posts-seo-best-practices.png")} />   -->

![Image](./../../static/img/posts-seo-best-practices.png "superblog SEO best practices")

You might have noticed the **SEO Best Practices** section on the post editor page. They are opiniated guidelines to make your post rank better on search engines. Let us try to understand more.

#### Title

This is the title of the post. Make sure your post’s title is around 8-12 words and has your post’s keyword.

#### Content

This is the contents of your post.

#### Images

Always include images in your posts. A picture is worth 1000 words.

#### Headings

Format your content properly. You need to have at least two headings. Write a catchy sentence to explain the section of your post and use the “Heading” format from the toolbar. Internally superblog will convert a heading to h2 which is good for SEO.

#### Subheadings

Format your content properly. You need to have at least 1 subheading. “Subheading” format from the toolbar. Internally superblog will convert a heading to h3 which is good for SEO.

#### Tags

You need to tag your post with relevant topics. For example, if you are writing a post on “Impact of covid in 2021 on health care industry” then you use tags like covid, healthcare, planning etc.

You can add the tags from the right-side “tag” editor.

#### Internal links

This is a very high-level SEO concept. All your blog posts should link to each other. So, make sure that you add a link to posts on your blog.

For example, let us assume you have a post on your blog with the topic of “Understanding economics of scale”. If you are writing a new post with the topic of “Scaling a business with 3 proven ways” then make sure you add a link to your previous post.


## Table of Contents (TOC)

Sometimes you might have a lengthy post. Or may be you just need to structure the post with headings, subheadings, and provide a glance of the post content. Superblog has this functionality built-in.


<!-- ### Automatic Mode -->

Superblog generates a ToC for every post that has Headings(h2) and Subheadings(h3) automatically. But superblog only shows h2 in the ToC container. You do not need to perform any action for to enable this. The ToC is placed at the top left of the blog post on desktops and at the beginnning of the post's body in mobiles.

<!-- ### Manual

Sometimes you might need to place the ToC somewhere inside the post instead of at the beginning. Or maybe you need to manually edit/add something in the ToC. So, there is an option to generate the ToC manually also.

### How to add ToC manually

It is very easy to generate a ToC for your post.

1. Write your complete post with headings and subheadings.
1. Click the "ToC" button in the editor toolbar as shown in the below image.
1. The ToC is generated at the cursor position if it is not already added.
1. You can remove the existing ToC by clicking the ToC button again.

![Image](./../../static/img/posts-editor-toc-toolbar.png "superblog table of contents")

### Preview

When you generate the ToC manually, it is added within the post editor.

The position of ToC on your blog is based on the width of the post page. If the page is wide enough (like a desktop) then the ToC is visible as a sticky section on the left. Otherwise, it is shown inline. -->

If you want to disable the ToC on any post, you can do so from the "Advanced Options" of each post.


### Desktop

![Image](./../../static/img/posts-editor-toc-preview-desktop.png "superblog table of contents desktop preview")

### Mobile

![Image](./../../static/img/posts-editor-toc-preview-mobile.png "superblog table of contents mobile preview")


## Change the date of creating/publishing

You can change the date of creating/publishing a post by clicking the "Date" of the post in the right side section.

![Image](./../../static/img/posts-change-date.png "superblog change post date")

## Change the post author

You can change the author of a post by clicking the "Author Name" of the post in the right side section. You can assign the post to any member of your team. This can be done only by the users with roles of "OWNER", "ADMIN", or, "EDITOR".

<!-- <img alt="superblog change post author" src={useBaseUrl("img/posts-change-author.png")} /> -->

![Image](./../../static/img/posts-change-author.png "superblog change post author")

## Review

![Image](./../../static/img/posts-review.png "superblog post review click element")

Team members (editors, admins, owner) can review a post and leave comments in the editor itself. An email notification will be sent for each comment to the post's author and to anyone else that participated in the review.

![Image](./../../static/img/posts-review-box.png "superblog post review comments box")

## Tags

You can add related tags to a post. These will be added to your post as `meta keywords`. Be wise, do NOT stuff keywords here. Your readers can browse posts based on the tags.

![Image](./../../static/img/posts-tags.png "superblog post tags")

### Preview

This is how the tags added to a post are displayed on your Superblog.

![Image](./../../static/img/posts-tags-preview.png "superblog post tags preview")

## Categories

You can create categories to group your posts. Select or create new Category in the post editor page.
![Image](./../../static/img/post-category-select.png "superblog post category select")

Then you can choose what categories to be dispalyed on the homepage.

![Image](./../../static/img/categories-homepage.png "superblog post categories home page")

## Callout CTA Section

You can add a bold callout CTA section in your post to drive traffic from a blog post to your required destination url. You need to click the <b>"CO"</b> button in the editor's toolbar.

### Preview

![Image](./../../static/img/post-callout-cta-section.jpeg "superblog post CTA callout section")

## Advanced Options

There are several advanced options to modify a post if you want finer control. Click the **Advanced Options** button to see them.

<!-- <img alt="superblog post advanced" src={useBaseUrl("img/posts-advanced.png")} />   -->

![Image](./../../static/img/posts-advanced.png "superblog post advanced")

<!-- ![Image](./../../static/img/posts-advanced-options.png "superblog post advanced options") -->

### Social sharing icons

You can show/hide social sharing icons for each post. A global setting is also available to enable/disable for blog-wide control.

Click the [**Advanced Options**](#advanced-options) button in the post editor to see this button (you can find it on the right side).

### Comments

You can show/hide comments for each post. A global setting is also available to enable/disable for blog-wide control.

Click the [**Advanced Options**](#advanced-options) button in the post editor to see this button (you can find it on the right side).

### Pinned post

You can pin a post to the top by checking this box. It will be always displayed on the home page as a featured post.

<!-- ### Render as Page

Sometimes you might want to add some pages like About, Contact, or anything to your blog. Superblog has `Pages` feature for this purpose. When you are creating a post, you will see the option **Render as Page** in advanced options.

If you enable this option, this post will be rendered as a page. It means, only the title and content are displayed. All other options like Author, Date, Sharing Icons, Comments, Site Description, etc will be hidden. -->

Click the [**Advanced Options**](#advanced-options) button in the post editor to see this button (you can find it on the right side).

<!-- <img alt="superblog post render as page" src={useBaseUrl("img/posts-render-page.png")} /> -->

![Image](./../../static/img/posts-pinned-post.png "superblog pinned posts")

### Meta Title & Description

You can set a post's meta title and description by clicking the **"Set Post Metadata"** button. This is an advanced option and should be modified ONLY if you know what you are doing.

Click the [**Advanced Options**](#advanced-options) button in the post editor to see this button (you can find it on the right side).

### Post URL/slug

Superblog automatically generates a post URL/slug from the post's title. But if you prefer assigning a custom URL/slug to the post, you can do it by clicking on the **Set Custom Slug** button.

Click the [**Advanced Options**](#advanced-options) button in the post editor to see this button (you can find it on the right side). You can also use nested slugs for a post.

Examples:

```
https://example.com/blog/my-post-1
https://blog.example.com/my-post-2
https://example.com/blog/travel/my-post-3
https://example.com/blog/tech/my-post-4

```


<!-- ![Image](./../../static/img/posts-slug.png "superblog post slug") -->

#### Note

1. You might have noticed a unique set of characters being attached to every post’s URL as shown below. That is the post id.

2. Superblog creates the post URL in the below format if you haven't set a [custom slug](#post-urlslug).

Example:
`https://example.com/blog/my-example-post-title-1cko8rasqs5nerasf0g`

This is the standard structure for superblog URLs. You need not worry about them.

1. Do they affect SEO?
   No.

1. Can you change it?
   Yes.

1. You need to manually assign a slug to a post for custom URL. Otherwise the auto-generated slug will be generated using the title of the post.

### Schema Markup

Schema Markup (also known as structured data) is a powerful tool for enhancing your website's SEO and improving how your content appears in search engine results. It provides search engines with additional context about your content, making it easier for them to understand and categorize your pages.

If you add [FAQs](#faq-module) to your post, they are automatically added to the Schema Markup.

#### Why is Schema Markup important for SEO?

1. **Rich Snippets**: Schema markup can lead to rich snippets in search results, which are more visually appealing and informative, potentially increasing click-through rates.

2. **Improved Search Visibility**: By providing clear, structured information about your content, you increase the chances of appearing in relevant search results and featured snippets.

3. **Better Understanding by Search Engines**: Schema helps search engines comprehend the context and relationships within your content, leading to more accurate indexing.


Superblog offers two ways to implement Schema Markup:


1. Auto
2. Manual

#### 1. Auto

Superblog automatically adds a valid JSON schema to all your blog posts.

**Default schema:**
```json
<script type="application/ld+json">
{
  "@context": "https://schema.org/",
  "@type": "BlogPosting",
  "author": [
    {
      "@type": "Person",
      "name": "<Post Author Name>",
      "url": "Author page url on your superblog"
    }
  ],
  "headline": "Post Title",
  "description": "It will be added if there is a meta description added by you"
  "image": "<Post coverimage/thumbnail url>",
  "publisher": {
    "@type": "Organization",
    "name": "<Your superblog name that you added in settings>general",
    "logo": {
      "@type": "ImageObject",
      "url": "<Your logo url that you added in settings>advanced"
    }
  }
}
</script>

```

**Note:**
```Author``` type is ```Person``` by default. If you hide the author names via settings then this type will be set as ```Organisation``` and your website url will be added to maintain Schema standards.



#### 2. Manual

You can add a schema markup (also known as structured data) for your posts (JSON LD/JSON+LD format) manually if you want to override the automatic schema.

Click on the **Set Schema Markup** button.

![Image](./../../static/img/posts-schema-markup.png "superblog set post schema markup button")

![Image](./../../static/img/posts-schema-markup-preview.png "superblog post schema markup preview")

Click the [**Advanced Options**](#advanced-options) button in the post editor to see this button (you can find it on the right side).

#### Example

```js
<script type="application/ld+json">
{
    "@context": "https://schema.org/",
    "@type": "BlogPosting",
    "@id": "https://dataliberate.com/2019/05/14/library-metadata-evolution-final-mile/#BlogPosting",
    "mainEntityOfPage": "https://dataliberate.com/2019/05/14/library-metadata-evolution-final-mile/",
    "headline": "Library Metadata Evolution: The Final Mile",
    "name": "Library Metadata Evolution: The Final Mile",
    "description": "When Schema.org arrived on the scene I thought we might have arrived at the point where library metadata  could finally blossom; adding value outside of library systems to help library curated resources become first class citizens, and hence results, in the global web we all inhabit.  But as yet it has not happened.",
    "datePublished": "2019-05-14",
    "dateModified": "2019-05-14",
    "author": {
        "@type": "Person",
        "@id": "https://dataliberate.com/author/richard-wallis/#Person",
        "name": "Richard Wallis",
        "url": "https://dataliberate.com/author/richard-wallis/",
    },
    "url": "https://dataliberate.com/2019/05/14/library-metadata-evolution-final-mile/",
    "keywords": [
        "Bibframe2Schema.org",
        "Libraries",
        "Library of Congress"
    ]
}
</script>

```

### Multiple Schema Markup

You can also add multiple schemas to a page using the same method. Just put your schemas in an array as shown below.

#### Example

```js
<script type="application/ld+json">
[
    {
    "@context": "https://schema.org/",
    "@type": "BlogPosting",
    "@id": "https://dataliberate.com/2019/05/14/library-metadata-evolution-final-mile/#BlogPosting",
    "mainEntityOfPage": "https://dataliberate.com/2019/05/14/library-metadata-evolution-final-mile/",
    "headline": "Library Metadata Evolution: The Final Mile",
    "name": "Library Metadata Evolution: The Final Mile",
    "description": "When Schema.org arrived on the scene I thought we might have arrived at the point where library metadata  could finally blossom; adding value outside of library systems to help library curated resources become first class citizens, and hence results, in the global web we all inhabit.  But as yet it has not happened.",
    "datePublished": "2019-05-14",
    "dateModified": "2019-05-14",
    "author": {
        "@type": "Person",
        "@id": "https://dataliberate.com/author/richard-wallis/#Person",
        "name": "Richard Wallis",
        "url": "https://dataliberate.com/author/richard-wallis/",
    },
    "url": "https://dataliberate.com/2019/05/14/library-metadata-evolution-final-mile/",
    "keywords": [
        "Bibframe2Schema.org",
        "Libraries",
        "Library of Congress"
    ]
},

{
 "@context": "http://schema.org",
 "@type": "FAQPage",
 "name": "FAQ on Widgets",
 "description": "Find answers to the most popular questions about our range of widgets",
 "url": "https://www.example.com/faq",
 "numberOfItems": 2,
 "itemListElement":
 [
  {
   "@type": "ListItem",
   "position": 1,
   "item":
   {
    "question": "what color widgets do you sell?",
    "answer": "we sell blue and red ones"
    }
  },
  {
   "@type": "ListItem",
  "position": 2,
  "item":
   {
     "qusetion": "how much do the widgets cost?",
     "answer": "1usd each"
   }
  }
 ]
}

]
</script>

```

### FAQ Module

You can add a Frequently Asked Questions module to your post. Just click on the **Manage FAQ** button. This is generally considered as a best practice for SEO. If you add FAQs, the required [Schema](#schema-markup) Markup is also automatically added to your post. 

![Image](./../../static/img/posts-advanced-faq.png "superblog post faqs preview")

#### Preview

![Image](./../../static/img/posts-advanced-faq-preview-light.png "superblog post faqs preview light mode")

![Image](./../../static/img/posts-advanced-faq-preview-dark.png "superblog post faqs preview dark mode")


### Custom Javascript

You can add custom js/code to every post easily. Click on the **Add Custom JS** button. Add the your `<script>` in the modal popup.

### Share Preview

You can share a post that you are working on to someone outside of your team or to anyone with a simple link. Click on the **Share Preview** button.

Click the [**Advanced Options**](#advanced-options) button in the post editor to see this button (you can find it on the right side).

<!-- <img alt="superblog post slug/url" src={useBaseUrl("img/posts-share-preview.png")} /> -->

![Image](./../../static/img/posts-share-preview.png "superblog post share preview")

#### Note

This is a premium feature available only in PRO and higher plans.

### Custom Canonical URL

You can set a post's canonical URL by clicking the **"Set Canonical Url"** button. This is an advanced option and should be modified ONLY if you know what you are doing. Superblog automatically generates accurate canonical URL automatically.

Click the [**Advanced Options**](#advanced-options) button in the post editor to see this button (you can find it on the right side).

### Custom Leadgen 

You can add a custom leadgen form, exit intent popup or sidebar widget per post. This config will override the [global leadgen settings](/dashboard/leadgen).
This is a premium feature available only in SUPER and higher plans.

![Image](./../../static/img/posts-custom-leadgen.png "superblog post share preview")


<!-- ### Submit sitemap to Google

You need to let Google know that you published a new post. Usually, Google will crawl your blog periodically depending how popular your blog is. However, you can submit your sitemap to Google manually to fasten the process. Click on the **Submit sitemap to Google** button.

Click the [**Advanced Options**](#advanced-options) button in the post editor to see this button (you can find it on the right side).

![Image](./../../static/img/posts-sitemap-submit.png "superblog submit sitemap")

#### Note

You need to submit only when a new post is published. Do NOT submit multiple times. Google will NOT crawl your website faster even if you submit multiple times. -->

### Delete post

You can delete a post by clicking the **"Delete Post"** button. Deleted post cannot be recovered.

Click the [**Advanced Options**](#advanced-options) button in the post editor to see this button (you can find it on the right side).

<!-- <img alt="superblog post slug/url" src={useBaseUrl("img/posts-sitemap-submit.png")} /> -->

![Image](./../../static/img/posts-delete.png "superblog delete post")

## Thumbnail / Cover image

You can add a custom featured image to a post. The ratio of the cover image must be 3:2 (width: height). This image is not shown in the post. It is used for post thumbnail only. It is also used as OG Image (open graph image) for the social sharing preview.

If you don't add a featured image then Superblog uses the first image in a post as the thumbnail/cover image (banner image) for the post. The images you upload will be scaled without losing proportions accordingly. Also, the images are auto-compressed to reduce their size and load fast.

You can upload the first image to be in the ratio of 3:2 (width:height) to be displayed correctly in the cover image. If there is no image present in a post then Superblog will automatically render a dynamic image as the cover image.

If you do not add an image in your post or assign a thumbnail to your post, superblog will add beautiful [dynamic thumbnails](https://www.linkedin.com/posts/s-kris_now-superblog-creates-a-dynamic-cover-image-activity-7150044494661308416-bSgx?utm_source=share&utm_medium=member_desktop) to your posts automatically.

## Social Preview / OG Image

Read above

### Note

If you change the first image in your post and want the social media to show the latest image as preview image then you need to force the said social media to refresh to their cache. Here is an article that explains how to [refresh social media preview image](https://superblog.ai/blog/how-to-update-a-website-link-preview-on-social-media-cksptmtol00121zlep5hlxa6z).


## Alternative Text vs Insert Description

<!-- <img alt="superblog image alt vs description" src={useBaseUrl("img/posts-image-alt-desc.png")} /> -->

![Image](./../../static/img/posts-image-alt-desc.png "superblog image alt vs description")

<br/><br/>

When you try to upload an image in the post editor, you can see **Alternative text** and **Insert description** fields.

1. Alternative text is shown when an Image isn’t available. (standard web practice, also useful for SEO)
1. Description is shown below the uploaded image. This is typically used to describe the image or credit the image's source or photographer.

## Embed

![Image](./../../static/img/posts-embed.png "superblog embed widgets")

You can embed external iframes, widgets, media players, polls, quizzes, forms, etc into superblog posts.

You need to click on the "EM" button in the editor's toolbar and then paste the HTML Embed code. Give a name for your embed.

You should see a blank reserved space for the embed with the name given by you. Once you click “Deploy” and visit the post URL, you can notice that the embedded content is visible and interactive.

### Sample Embed Code for Spotify
```html
<iframe 
  style="border-radius:12px" 
  src="https://open.spotify.com/embed/track/4WmB04GBqS4xPMYN9dHgBw?utm_source=generator" 
  width="100%" height="152" frameBorder="0" allowfullscreen="" 
  allow="autoplay; clipboard-write; encrypted-media; fullscreen; picture-in-picture" 
  loading="lazy">
</iframe>
```

### Live Demo:
 https://testblog.superblog.cloud/testing-embeds-from-3rd-part-websites/



## Supported Image formats

You can embed images of all popular formats like `PNG`, `JPEG`, `GIF`, `WEBP`.
Some `SVG` images might be broken after uploading, please try to use other formats.

## Internal links

You can add anchor links within the same post or page.

1. Click the `code view` button in the editor's toolbar.
1. Select the text you want to link to and wrap it like this: `<span id="my-link">target element</span>`.
1. Click the `code view` button again.
1. Select the text to add an anchor tag by clicking the `link` button in the toolbar.
1. Give the address as `#my-link` and click submit.
---
# sidebar_position: 3
---

import useBaseUrl from '@docusaurus/useBaseUrl';

# Settings

`View Dashboard > Settings`

You can customize your Superblog in almost every aspect possible.  
There are some sane restrictions in place to make sure that the user experience and reading experience are not compromised.

Settings are divided into three sections for easier use.

1. General
2. Advanced
3. Expert

## General settings

![Image](./../../static/img/settings-basic.png "superblog basic settings")

### Site Name

This is the name of your brand/product/company. You can change it anytime.  
It will be used in multiple places throughout your Superblog:

- In the header of your blog if no logo is uploaded.
- In the footer of your blog if no logo is uploaded.
- Appended at the end of every post's meta title if there is no custom meta title given by you. Example: "This is my sample post | Sample Blog"

This is also used in meta title of your blog's home page. It will appear on the browser tab as shown below.

<img alt="superblog site name" src={useBaseUrl("/img/settings-basic-name.png")} style={{height: 200}} />

### Color Scheme

You can this as the accent/theme color. You can choose a color from the default palette or edit a hex color code to match your brand's color. This can be changed anytime.

Buttons, Links, Lead generation forms, Tags, Call-to-actions (CTAs) will use this color.

![Image](./../../static/img/settings-basic-color.png "superblog color scheme")

### Description

Description is shown below every blog post. Use a short and concise intro about your product or service. It will make your blog readers visit your landing page by making them click on the CTA button.

You can enable/disable this.

![Image](./../../static/img/settings-basic-description.png "superblog settings description")

### Superblog branding

Sueprblog branding can be removed completely once you upgrade to a paid plan. During trial period, a small "Made with Superblog" is shown in the bottom right corner.

#### Note

If you use a coupon code for discount then you cannot remove the branding.

## Advanced Settings

![Image](./../../static/img/settings-advanced.png "superblog advanced settings")

### Short description

This is used in meta title of your blog's home page. It will appear on the browser tab as shown below.

<!-- ![Image](./../../static/img/settings-advanced-short-name.png "superblog advanced settings") -->

<img alt="superblog short description" src={useBaseUrl("/img/settings-advanced-short-name.png")} style={{height: 200}} />

### Logo

You can upload your own logo in Superblog. It will be shown in the header and footer.

Recommended format: PNG  
Recommended dimensions: 450 x 150 (width x height)(px)

### Favicon

Favicon is the small icon that you see on the browser's tab for each website visited.

Recommended format: ICO or PNG  
Recommended dimensions: 32 x 32 (width x height)(px)

### Homepage layout

You can customize your Superblog's layout from available formats.

#### Grid

![Image](./../../static/img/settings-advanced-grid.png "superblog grid layout")

#### List

![Image](./../../static/img/settings-advanced-list.png "superblog list layout")

### Fonts

The default fonts for Superblog are carefully selected for readability, design, and class. Here are our [recommended](https://superblog.ai/blog/font-combinations-for-blog) fonts.
You can also change the default fonts by choosing from thousands of options that are available in [Google Fonts](https://fonts.google.com).


#### Blog UI Font

This is the font used for Headings, Menu Items, Buttons, Footer, etc.

Default: Roboto

#### Blog Post Font

This is the font used for text content of the blog post body.

Default: IBM Plex Serif

#### Note

You cannot choose your own custom font for Superblog at this point of time.
This is a conscious decision to keep the reading experience standard. You can only choose fonts from a list of given options.

### Header title

This is the prominent header text to tell about your blog or product or service.

![Image](./../../static/img/settings-advanced-header-title.png "superblog header title")

### Header caption

This is the caption to explain a bit more or leave a taste of your offering.

![Image](./../../static/img/settings-advanced-header-caption.png "superblog header caption")

### Header CTA

You can use this section to bring your blog visitors to your landing page or product page.  
Write a catchy `Call to Action` text to be displayed on the button. You can enter a custom URL to which the visitor should be taken.

![Image](./../../static/img/settings-advanced-header-cta.png "superblog header CTA")

### Blog Interface Language

You can select a language for your blog interface (internationalization/i18n).
The UI elemenets like "View Older Posts", "New Posts", "5 min read", etc are automatically translated to the language of your choice.

You can also add your own vocabulary for the interface elements.

#### Available languages

1. English
1. French
1. Italian
1. Russian
1. Spanish
1. Custom

![Image](./../../static/img/settings-advanced-blog-language.png "superblog i18n")

![Image](./../../static/img/settings-advanced-blog-language-customize.png "superblog internationalization")

### OpenGraph Image (Social Preview)

Whenever you share a link on social media (like twitter, facebook, linkedin etc), they tend to show a preview to users. You can control how your blog's URL is shown as a preview.

Select an image as shown below and it will be displayed as the preview image whenever your blog is shared on social media sites.

![Image](./../../static/img/settings-advanced-og.png "change superblog social preview")

Recommended dimensions: 1200 x 630 (width x height)(px)

#### How to refresh social media preview image

Social media sites will cache your preview image from time to time. You need to manually update the preview whenever you change the image. Here is a [clear guide](https://superblog.ai/blog/how-to-update-a-website-link-preview-on-social-media-cksptmtol00121zlep5hlxa6z).

## Expert Settings

You can add control all the power features for your Superblog in this section. They include canonical and sitemap urls (trailing slash), google analytics, google adsense, custom javascript, etc.

![Image](./../../static/img/settings-expert.png "superblog expert settings")

### Google Analytics Id

There is an inbuilt analytics module in Superblog. You can view pageviews, visitors info, top pages etc from Superblog dashboard itself. (Only available in PRO and higher plans)

However, if you want to use Google Analytics to track your blog's pageviews and visitors then you can paste your Google Analytics tracking code here.

If you want to use Gtag, GTM or any other analytics code then you can paste it in the `Custom JS` section.

![Image](./../../static/img/settings-expert-ga.png "superblog add google analytics")

### Google Adsense (Auto Ads)

If running Google Adsense is your revenue model then you can paste your Google Adsense Publisher code to display `Auto Ads`.

You can not use custom ad units in superblog. Only Auto-ads are possible.

![Image](./../../static/img/settings-expert-adsense.png "superblog add google adsense code")

### Meta Title

You can add custom meta title for your superblog's homepage.
If this is not entered then "{name}| {short description} is used as the meta title.

### Meta Description

You can add custom meta description for your superblog's homepage.
If this is not entered then the excerpt of "description" is used as the meta title.

### Hide Post Authors and Dates

You can hide Author names and dates for all posts in this section.

![Image](./../../static/img/settings-expert-hide.png "superblog hide author name and post dates")

### Hide menu items in footer

You can hide default menu items in footer by visiting `settings>expert` section.

![Image](./../../static/img/settings-expert-footer.png "superblog hide footer menu items")

### Use blog as root Url

When you connect `blog.example.com` or `example.com/blog` to your Superblog, you can find this option in `settings > expert` section.

By default, clicking on your blog's logo will take you to `example.com`. However, if you want to send users to your blog's home page (`blog.example.com` or `example.com/blog`) when clicking on the logo, then you need to tick this checkbox.

![Image](./../../static/img/settings-expert-blog-root.png "superblog use blog home as root page")

### Send Email on Deploy

You can choose to receive email notifications when your superblog is deployed. If you wish to not receive email notification for deploying your superblog, you can disable this setting.

### Home Page Content
You can choose what to display on the home ("/") of your superblog.

There are three options available:-

1. Posts (your blog posts will be displayed)
1. Static Page (you can choose a page from your superblog dashboard>pages section to displayed on the homepage)
1. Custom HTML (you can upload a zip file containing your custom html pages)

![Image](./../../static/img/settings-expert-homepage.png "superblog home page content")

**Note**<br/>
1. If you choose a static page or custom html as your home page then your blog posts will be available on "/posts/1" URL. See the example below.
1. This is generally used when you want to build a whole website with superblog. You can simply design a page and choose it to display on homepage instead of list of posts.

**Example**<br/>
yourwebsite.com => your custom designed page<br/>
yourwebsite.com/posts/1 => your blog posts

### Miscellaneous scripts (Custom JS)

You can add custom javascript to your Superblog by visiting `settings>expert` section. It can be your own javascript or thrid-party widget code. For example: help chat widget, analytics tracking code, popup-scripts etc.

![Image](./../../static/img/superblog-settings-expert-misc-scripts.png "add custom misc scripts to superblog")

#### Example

```js
<script>
    alert("hello");
</script>
```

#### Note

1. All the code entered here will be present in `<body/>` section of your Superblog.
1. Adding unoptimized scripts or too many scripts might reduce the performance score of your Superblog.

### Head scripts (Custom JS)

You can add custom javascript to `<head/>` section of your Superblog by visiting `settings>expert` section. It can be your own javascript or thrid-party widget code. For example: help chat widget, analytics tracking code, popup-scripts etc.

#### Example

```js
<script>
    alert("hello");
</script>
```

#### Note

Adding unoptimized scripts or too many scripts might reduce the performance score of your Superblog.

### Custom CSS

You can add custom CSS to your Superblog by visiting `settings>expert` section. This feature will allow you to modify your Superblog with fine changes.

![Image](./../../static/img/superblog-settings-expert-custom-css.png "add custom misc scripts to superblog")

#### Example

```css
/* this will make the post's title align to the center of the page */

.post-title {
    text-align: center;
}
```

#### Live Superblogs

Superblog's customers are very creative. They add beautiful CSS and JS to modify the look and feel of their Superblogs to match their needs.

[View custom superblogs](https://superblog.ai/blog/customize-superblog)

### Custom Robots.txt

You can use custom Robots.txt file. Just copy-paste a valid robots.txt file contents into the text area and click deploy.

It will be available in

**subdirectory:** yourwebsite.com/blog/robots.txt

**subdomain:** blog.yourwebsite.com/robots.txt

### Generate LLMs.txt

The world is moving towards AI. Many companies like ChatGPT, Claude, Grok, Google Gemini, etc., need to have their datasets trained on content. So, your content should be in a format that can be easily discoverable, indexable, and understandable by AI engines (LLMs technically).

If you enable this option, superblog will automatically convert all your existing blog posts into a format that is easily understood by AI engines and store it in a file called `LLMs.txt`.

It will be available in

**subdirectory:** yourwebsite.com/blog/LLMs.txt

**subdomain:** blog.yourwebsite.com/LLMs.txt

#### Note
1. Depending on the number of blog posts you have, this process can take some time. Your deployment time will be increased. Please be patient. This is the trade-off you make.
1. You can disable this option if you don't want to use LLMs.txt.


### Disqus Comments System

You can use Disqus as your comments sytem instead of Superblog's native comments.
Once you enter your Disqus shortname, Disqus comment system will be shown in place of Sueprblog's native comments.

### Redirects

You can use redirects to redirect from old post url to new url. (301 redirect)<br/>


For example:

```
yourwebsite.com/blog/old-post-url -> yourwebsite.com/blog/new-post-url
```

```
blog.yourwebsite.com/blog/old-post-url -> https://example.com/abc/123
```

![Image](./../../static/img/original/settings-expert-redirects.png "superblog redirects")
---
sidebar_position: 3
---
import useBaseUrl from '@docusaurus/useBaseUrl';

# Tags

```View Dashboard > Tags```

You can add multiple tags to each post. All the tags added to different posts are showed in `Tags` section. You can edit or delete a tag by clicking the respective icon.

<!-- <img alt="superblog team member roles" src={useBaseUrl("img/team-roles.png")} /> -->
![Image](./../../static/img/tags.png "superblog post tags")

## Note
1. A common bad practice followed by beginners is to add too many tags to a post. Do NOT add too many tags to a post.  

For example, consider a post with title **"Best software to check grammar misatkes in paragraphs"**.  
You can add tags like "software" , "writing tools". That's it! Do not stuff so many keywords. It won't help in SEO.

2. If a post has no category assigned then the first tag of the post is displayed below the post title on the homepage.---
sidebar_position: 3
---
import useBaseUrl from '@docusaurus/useBaseUrl';

# Team

```View Dashboard > Team```

Superblog has excellent team module to make managing your blog easier. You can assign different role to different members of your team. The total number of members you can have in your team depends on the [plan](https://superblog.ai/pricing) you are on. 

<!-- <img alt="superblog team member roles" src={useBaseUrl("img/team-roles.png")} /> -->
![Image](./../../static/img/team-roles.png "superblog team member roles")

## Roles

There are 4 roles available in Superblog.
1. Writer
1. Editor
1. Admin
1. Owner

### Writer

A team member who has given the role of **Writer** can ONLY create new posts, view and edit their own posts. They cannot change the settings of your Superblog or access the payment plan. There can be multiple writers in a team.

### Editor

A team member who has given the role of **Editor** can create new posts, view and edit posts of all the members of your team. They cannot change the settings of your Superblog or access the payment plan. There can be multiple editors in a team.


### Admin

A team member who has given the role of **Admin** can create new posts, view and edit posts of all the members of your team. They CAN change the settings of your Superblog but CAN NOT access the payment plan. They can invite new team members, edit the role of existing team members, and also remove them. There can be multiple admins in a team.

### Owner 

The user who creates a Superblog is assigned the role of **OWNER** by the system. Owner can create new posts, view and edit posts of all the members of your team. They CAN change the settings of your Superblog and CAN access the payment plan. There can only be ONE owner in a team.


## Invite team member

```View Dashboard > Team > Invite Team Member (button)```

<!-- <img alt="superblog team members" src={useBaseUrl("img/team-invite.png")} /> -->
![Image](./../../static/img/team-invite.png "superblog team members")

<!-- <img alt="superblog team member invite" src={useBaseUrl("img/team-add.png")} /> -->
![Image](./../../static/img/team-add.png "superblog invite team member")

<br/>
<br/>

Admin or Owner can add a new team member by sending them an email invitation. 
Click on the **Invite New Member** button to see a popup.

1. Enter their email address
1. Select a role
1. Click the **Send Invitation** button

Superblog will send them an email invitation with a link to confirm. The intended user has to click on the link that they received in the email and login to Superblog with the same email address. That's it! They become a part of your team.

## Cancel a sent invitation

If you want to cancel an invitation to an email address then click on **"Pending Invitations"** button to find the invitation and delete it.
<!-- <img alt="superblog team member cancel invite" src={useBaseUrl("img/team-cancel.png")} /> -->
![Image](./../../static/img/team-cancel.png "superblog cancel invitation")


## Edit the Role of a team member

Admin or Owner can edit the role of a team member by visiting the **Team** section and clicking the **Edit** button. 

## Remove a team member

Admin or Owner can remove a team member by visiting the **Team** section and clicking the **Remove** button. 

If a user is removed, all their posts are assigned to the owner.
---
sidebar_position: 2
---

# Embed Posts
You can embed your most recent posts from superblog in any webpage or app. 
<b>This is available on ALL plans. </b>

## How to

1. You can fetch the posts data by sending a simple `GET` request to your superblog's RSS feed xml or json.
2. Once the data is retrieved from fetch request, then you can render the posts to match your UI.

## RSS Feed URL
If `example.com/blog` is your superblog’s URL then your RSS feed is: https://example.com/blog/rss.xml 

If `blog.example.com` is your superblog’s URL then your RSS feed is: https://blog.example.com/rss.xml 



## RSS Feed JSON API
If `example.com/blog` is your superblog’s URL then your RSS feed JSON is: https://example.com/blog/rss.json 

If `blog.example.com` is your superblog’s URL then your RSS feed JSON is: https://blog.example.com/rss.json 

You can do a GET request and render the response data (most recent posts) on mobile or website.
It is RSS 2.0 spec-compliant and hence can be used with any other software too. for example zapier or zoho workflow.



## API Example



### NodeJS Code

```js
// replace it with your superblog rss json
const url = "https://superblog.ai/blog/rss.json"; 

const res = await fetch(url);
const data = await res.json();
```

### Python Code

```py
import requests

// replace it with your superblog rss json
url = "https://superblog.ai/blog/rss.json"

res = requests.get(url)
data = res.json()
```


### Response Data Sample


```json
{
"status": "ok",
"feed": {
"title": "blog name",
"link": "https://example.com",
"image": "https://example.com/image.jpg"
},
"items": [
    {
"title": "Example title",
"pubDate": "2022-05-23 17:25:29",
"link": "https://example.com/blog/example-post",
"guid": "abcd123",
"thumbnail": "https://example.com/thumbnail.jpg",
"description":"Hello World!"
    }
]
}
```

Live example: https://superblog.ai/blog/rss.json---
sidebar_position: 4
---

# FAQ

These are some of the common and frequently asked questions that might come up when using superblog.

## Can we track outbound links?

Tracking outbound links is a common requirement for bloggers. It lets you know how often an external URL was clicked, which page the clicks occured on, etc.

Superblog provides this feature out-of-the-box. External link clicks will be tracked as events on your analytics dashboard. They will be displayed as <b>Outbound Link Click</b>, but you can expand the event to reveal the external links that have been clicked by your visitors.

![Image](./../static/img/faq-outbound-links.png "track Outbound links in superblog")

## Why are many pages of my superblog not indexed on Google?

You might be seeing that certain pages of your superblog are not indexed on Google. This can be observed from your Google Search Console or other SEO tools like Ahrefs or SEMRush.

This is 100% intentional.

They are all tag/category/navigation/comments pages (Not blog posts). They are good with no index tag. We are not blocking Google to read it, we are only asking not to index those pages to avoid competition among your own pages.

That's the whole point of superblog. You don't need to worry about these SEO best practices. They come with the platform.

## Why is the content pasted from google docs and other sources badly formatted?

This is a common issue for text editors. Pasting content from outside sources will cause formatting issues.

### How to avoid this issue

You can export your content from Google Docs or Notion or other sources into .docx, or .html, or .md (markdown) files and then import that files into Superblog for seamless experience.

Read more: https://superblog.ai/docs/dashboard/posts#import-post

## Can we add author info/bio below the blog posts?

No. Superblog is specifically designed to bring traffic from your blog to your website. That's why there is a 'Site Description' box below each blog post (which acts as a CTA to your landing page) instead of a common Author/Bio section.

However, you can manually add about the author in the post itself if you need.

## Why the pagespeed score is low for my Superblog?

Superblog targets for 90+ score in Google's Lighthouse Audit on an average (combination of all the scores). If your superblog has less than 90, then the below could be possible reasons:

1. You might have added large Javascript to your superblog.
1. You might have added large embeds in your blog post. (ex: twitter threads, apple podcasts, etc).
1. You might have embedded Youtube player directly using embed code. Instead, embed it by clicking "Video" icon in the post editor's toolbar.
1. You have added Google Analytics or Gtag scripts (there is an inbuilt tracking module for superblog which is lightweight) or maybe you are using custom tracking scripts that could be causing an issue.
1. If you configured your superblog on a subdirectory (for example: yourwebsite.com/blog), then the request will hit your server first to handle the reverse proxy. So please check if it is causing delays in response and rewrites (proxy) which will reduce the pagescores.
1. You might be auditing the home page of your superblog. You should audtiting the post URL to get the accurate scores.

## Why the lighthouse (core web vitals) assessment failed for blog URLs?

This will happen only when you are using superblog on a subdirectory due to the below reasons. Just click on the <code>i</code> icon as shown in the below image.

![Image](./../static/img/faq-cwv-failed.jpeg "core web vitals assessment failed in superblog")

1. If you click on the <code>i</code> icon as shown in the above image, you will understand that the real world data is not available for this particular URL and hence Google is showing the aggregate data for the entire website (including ALL your pages, not just blog). So, this is not a problem from superblog's side. You need to fix your website's performance.

1. Since you are using superblog on a subdirectory (for example: yourwebsite.com/blog), then the request will hit your server first to handle the reverse proxy. So please check if it is causing delays in response and rewrites (proxy).

## Why do I see my blog post URLs twice in Google Search Console or other Analytics solutions?

If you haven't configured redirect of URLs ending with and without forward slash (/), then you will see 2 urls of same post in your analytics solution (could be search console or google analytics, etc.) as the users could end up on different versions of the URL. (but google will only index one URL, i.e, your preffered URL because superblog sets canonical URL by default).

Example:

https://mywebsite.com/blog/my-post-abc

https://mywebsite.com/blog/my-post-abc/

You might need to set a redirect one URL to other (your preferred URL) on your server.
This only happens if you configured superblog on your subdirectory.

## What is the sitemap URL for my superblog?

Your superblog's sitemap.xml is always at the root.

For example:

https://blog.yourwebsite.com/sitemap.xml (subdomain)

https://yourwebsite.com/blog/sitemap.xml (subdirectory)

## Why are my latest posts not getting indexed on Google?

Make sure your site's configuration is correct.
Your website's robots.txt should contain your [superblog's sitemap](#what-is-the-sitemap-url-for-my-superblog).

Here's a example of correct config:
https://superblog.ai/robots.txt

### Note

1. If you list your blog post URLs manually in your sitemap.xml then you can skip mentioning your superblog's sitemap in the robots.txt. However, just do it no matter what.
2. If the problem remains even after the above, try to manually index the URLs in Google Search Console.
3. If the problem remains even after the above, your content is of low quality.

## How to automatically approve comments from a specific user?

Generally, users need to approve their comments before they are published on your blog by verifying their email address every time they post a comment.

But if you want to approve comments from a specific user automatically, then you can do it by following the below steps.

1. Open the specific post in your dashboard and click on the "Advanced Options" button.
1. You will see a button called "View Comments", click on it.
1. Then click on "Approve Email" next to the email address of the comment you want to approve.

From now on, all the comments from that user email will be automatically approved and published on your blog. You can disapprove the email anytime by clicking the "Disapprove Email" button.
---
sidebar_position: 2
---
import useBaseUrl from '@docusaurus/useBaseUrl';

# Create an account

To use Superblog, you need to have a valid email address. To explore the product, we offer you a free 14-day trial. No credit card is required to sign up for the trial.

There are no restrictions during trial-period. You can connect your domain to your Superblog and start publishing posts. However, there are few sensible limitations to prevent abuse of the platform.

## Signup / Login

Superblog uses passwordless login. You don't need to signup with a username/password for Superblog. You can simply login with your Google account or use any email address to receive a magic link to login. Your account is created automatically.

<!-- <img alt="Login to Superblog dashboard" src={useBaseUrl('img/login.png')} /> -->
![Image](./../../static/img/login.png "Login to Superblog dashboard")

## Magic Link

If you enter your email address to login to Superblog then you will receive an email with login link. Click on the "Login to dashboard" button. 

<!-- <img alt="Login to Superblog with magic link" src={useBaseUrl('img/magic-link.png')} /> -->
![Image](./../../static/img/magic-link.png "Login to Superblog with magic link")

### Note 
1. This link is valid for 24 hours only. You can request 3 magic links in a 24 hours window. If you try to request more links then you will be shown an error: `Exceeded logins attempt`.
1. If you use Office 365 or Outlook, or potentially other Email systems, you may notice that your Email invitation Links are not working. This is because the invitation Email your User is receiving is being scanned by the Email provider. In the specific case of Outlook and their "SafeLink" feature. You will get the error: "Unable to sign in - this link is no longer valid".

You need to add superblog.ai to your safelinks feature via office365 or other email providers.
---
sidebar_position: 3
---
import useBaseUrl from '@docusaurus/useBaseUrl';

# Create your Superblog

When you login to Superblog for the first time, you can see a green button that says **"Create New Superblog"**. Click on it to start creating your new blog.

<!-- <img alt="Empty Superblog dashboard" src={useBaseUrl('img/superblog-dashboard-empty.png')} /> -->
![Image](./../../static/img/superblog-dashboard-empty.png "Empty Superblog dashboard")

## Enter the details

Fill the details as asked in the form to create your new Superblog.

<!-- <img alt="Create New Superblog" src={useBaseUrl('img/create-superblog.png')} /> -->
![Image](./../../static/img/create-superblog.png "Create New Superblog")

### Note 
You can create only 5 Superblogs in each account. You can contact us to increase the limit.

## Finish

Once you create your Superblog, you will be redirected to home page. You can see your Superblog's details like Name and Blog address.

Click on the "View Dashboard" button to write posts, change settings and manage your team members.

<!-- <img alt="Superblog dashboard" src={useBaseUrl('img/new-superblog.png')} /> -->
![Image](./../../static/img/new-superblog.png "Superblog dashboard")

---
slug: /
sidebar_position: 1
---

# Welcome

[Superblog](https://superblog.ai) is a blazing fast, beautiful, and SEO-focused blogging platform. You can focus on writing content instead of spending time on setup, maintenance, and optimization. Superblog automatically optimizes your blog for SEO and speed. All the best practices for a great reading experience and converting your blog readers into your customers are built into the platform. No more managing servers, software, and security for your blog!

You can find in-detailed configuration, tutorials, and answers in this documentation. If you need any info about Superblog, chances are you will find it here. Please use the search box in the top-right to find what you are looking for.

In case you are not able to find what you are looking for, please write to `hello@superblog.ai`.