Help Center

The Manual

While Pika is designed to be simple and easy to use, not everything can be discovered just by playing with it. If you’re the sort of person who likes to dig into the manual for your new toys, this is the place for you. And if you still find some things about Pika confusing after reading this, get in touch and we’ll get you moving in the right direction!

Table of Contents


The Editor

Pika’s editor is a simple, intuitive, and powerful way to create posts and pages for your Pika site. For most people, blogging will be as easy as typing in the editor and occasionally using the toolbar to make some formatting adjustments. If you want to learn more about the editor’s power features, read on.

Keyboard Shortcuts

If you hover over the toolbar items, you will learn that there are some keyboard shortcuts to speed up formatting your writing. For instance cmd+b/control+b for bolding text and cmd+k/control+k for inserting a link URL for the currently-highlighted text. Another example is hitting the TAB key to indent a bullet in your lists. You can see all of the available keyboard shortcuts in this documentation for the Pika editor’s underlying code library, TipTap.

Markdown

Markdown is a writing syntax that enables you to define formatting of your text without requiring a toolbar or other rich text controls. Pika’s editor does not require you to learn Markdown, but if you are familiar with Markdown already Pika will recognize most Markdown formatting rules. For instance, if you type “_edit_” in the Pika editor, it will be replaced with the italicized word “edit”.

Post Excerpt

If you have set up your blog layout to stream view, you may wish to only show an excerpt of your post in a stream of posts. This can be done by clicking the Create Excerpt button in the toolbar. We also support these handy Pika variables that you can type directly in your editor:

  • {{ more }}
  • {{ excerpt }}

Draft Posts

Drafts are a way to save your writing in progress. When writing a new post, you will notice a Save as Draft button on the top of the page. Clicking this assures that you will not lose your post. Draft posts appear at the top of your posts dashboard.

Autosave to Browser

Pika does not yet have an autosave draft feature. However, Pika will autosave your text in your browser. If you ever find that your machine or browser crashed in the middle of writing a post or page, don’t panic! Reopen the same browser and navigate to the post or page you were editing and your text should still be there. Phew! If you were creating a new post or page, just go back to the Write post/Create page screens to recover your writing.

Note: this browser-based autosave feature does not save any image attachments.

Embedding Content

If you paste a YouTube link it will auto-embed the video for you. At this time Pika does not yet allow any other embedding of JavaScript or iframes in the editor.

Aliases

Pika allows you to create an alias for a post or page. Aliases first need to be enabled in Settings > Labs. From there you can create an alias when working on a post or page by clicking the ••• > Add alias menu item.

Aliases are a way to tell Pika about a URL that should be redirected to the given post or page. These aliases are particularly handy if you are moving your blog from a different blogging platform to Pika as they allow you to make sure all of the existing links to your posts and pages still work. For instance, if your prior blog post was at the URL “https://example.com/2024/01/01/my-post”, you can add the URL as an alias when you copy the post to Pika. This way “https://example.com/2024/01/01/my-post” will redirect to Pika’s version of the post, which will exist at “https://example.com/posts/my-post”.

By default Pika redirects a few of the most common RSS feed URLs to your Pika RSS feed address. So if you are coming from another service and your RSS feed URL was one of the following, your feed will continue to Just Work™:

  • https://example.com/feed
  • https://example.com/feed.xml
  • https://example.com/rss
  • https://example.com/rss.xml
  • https://example.com/blog/feed
  • https://example.com/blog/feed.xml

Pika Variables

You can use special variables in your posts and pages to do things like add some recent blog posts to a custom home page.

  • {{ posts }} – Outputs a list of your blog posts. This can optionally take a limit and/or tag parameter, like {{ posts limit: 10 tag: "Bill Murray" }}.
  • {{ posts_by_year }} – Outputs a list of your blog posts, grouped by year if there are multiple. This can also optionally take a limit and/or tag parameter, like {{ posts_by_year limit: 10 tag: "Bill Murray" }}.
  • {{ tags }} – Outputs an alphabetical, comma-separated list of your blog tags. This can optionally take a separator parameter, like {{ tags separator: " | "}}.
  • {{ tag_list }} – Outputs an alphabetical HTML list of your blog tags.
  • {{ letterbird_form user: yourusername }} – Outputs your Letterbird contact form, another product we created to make it fast and easy for anyone to get a well-designed email form. This can optionally show your Letterbird’s form header with {{ letterbird_form user: yourusername showheader }}. (Note: This Pika variable can also be used in your site footer.)

Known Quirks

  • The indentation tools in the toolbar only effect bullet lists and ordered lists. For instance, if you would like the second bullet in your list to be indented, click the Increase indentation toolbar item.
  • The Attach Files toolbar item (a camera icon) is a misnomer. At this time only images can be attached to your posts and pages.
  • While Pika recognizes most Markdown formatting, it cannot currently process image syntax.
  • Pika does support footnotes via Markdown. Here’s how they work.
  • Pika variables are the one thing that do not look the same in the editor as they do on your Pika site. You will have to use your imagination to visualize what a Pika variable will look like.

Posts

The Posts section of your Pika dashboard is all about writing blog posts. It’s the first thing you see when logging in. Get writing!

Prompts

If you’re having trouble coming up with something to write, we got ya. Go to the ellipses menu in the upper right of the editor and click Get a writing prompt.

Tags

To add or edit tags for your post, click the ellipses menu in the upper right of the editor view and select Add tags.

Changing Published Date

To backdate your post, click the ellipses menu in the upper right of the editor view and select Change published date. At this time you cannot schedule a post to publish in the future.

Delete a Post

To delete your post, click the ellipses menu in the upper right of the editor view and select Delete post. You can also revert a post to draft state by clicking Unpublish.

Titleless Posts

Titles on posts are optional. If you choose not to include a title on your post, where links to your post are necessary on your site Pika will generate a link for you based on your post’s content.


Pages and Navigation

The Pages section of your Pika dashboard offers more than a way to edit pages. From here you can create a custom home page, add pages to your navigation bar, and even add external links to your navigation bar.

Default Home Page

The default Pika home page includes two things:

  • The text you entered in Settings > About this blog
  • A list of your blog posts, organized by year

Custom Home Page

Clicking the dropdown arrow next to the Create page button allows you to create a custom home page. Once you save this page, it will replace the default home page. A custom home page is the one type of page that does not require a title.

Pages in Navigation

Once you’ve created a page, you can add it to your site’s navigation bar by clicking Add to nav next to the page title. To remove the page from navigation, click the Un-nav link.

If you’d like to add a link to another website in your site’s navigation bar, click the dropdown arrow next to the Create page button and select Add a link to your navigation. On the resulting form, enter a label and URL for the link. To remove the link from your navigation bar, click the Delete link.

Reorder Navigation

To change the order of the links in your navigation bar, grab the handle to the left of your page/link titles and drag them up or down.

Delete a Page

To delete your page, click the ellipses menu in the upper right of the editor view and select Delete page.


Settings

The Settings area offers you many configuration and setup options.

Blog title

The title that appears on your home page and in the header of your blog.

Blog avatar

Upload an image to be used as your favicon and optionally in your site header.

Blog layout

Choose to have your blog posts display as a list of titles or in a stream format that includes the text of each post.

Subdomain

Set your blog’s subdomain (e.g. myverycoolblog.pika.page). Here you can also click through to configuring a custom domain.

Email address

The email you login with.

Change your password

Here’s where you update your password. Be careful!

Time zone

Set up your time zone so your posts are published on the correct day.

About this blog

Give an intro to your blog. (This is not available if you’ve created a custom home page.)

Provide a custom footer to display throughout your site.

Add your own analytics Pro

Bring your own analytics to Pika. We support:

  • Fathom
  • Google
  • Plausible
  • PostHog
  • Tinylytics
  • Umami

Provide links to verify ownership of your site on Mastodon. Learn more.

Google HTML tag site verification

When you’d like to submit your sitemap to Google, this will help you verify your site. Learn more.

Additional options

  • It’s OK for search engines to index my site: If this is turned off, we’ll set up your robots.txt file to tell search engines to stay away.
  • It’s OK to occasionally contact me with updates about Pika: We hardly ever send emails, but you’re welcome to opt out of these right here.
  • Hide Pika’s logo and branding on my site: For Pika Pros, you can hide the Pika branding from your site.

Password-protected Blog

Password-protected Pika blogs are available to all Pika customers. From your Dashboard, visit Settings > Labs to turn it on and enter a password. When password protection is enabled, your entire Pika site will require the password to be entered in order to see it.

If you ever regret giving your password to someone, you can always change the password. This will kick out anyone who had entered the old password in the past, requiring the new password for re-entry.


Import and Export

Import

At this time Pika does not offer any automated import tools. However, if you have an existing blog of any significant size and would like help migrating, please get in touch and we might be able to help!

Export

To receive a fully-navigable HTML export of your Pika site, please contact us and we will get it to you right away.


I’ve read the manual and I still have questions

We’re here to help! Reach out to our team and we’ll get your questions answered.