Skip to main content

Getting Started with your Journal on PubPub

This article is intended to help you set up your journal on PubPub.
Published onAug 26, 2020
Getting Started with your Journal on PubPub

Hello! Thank you for your interest in starting a new journal or moving your existing journal to PubPub. PubPub is an open source publishing platform for open access content. Anyone or group of people can create a community, or publishing space, on PubPub at any time and at no cost.1

This article is intended to walk you through the steps of setting up your journal. If you need help or have questions or ideas, please email [email protected].

Creating your Community

Most journal creators choose to set up the journal as a PubPub Community with its own branding. (In some instances the parent level entity may be a society or association, so you may want to create the community at that level, using that branding, then create the journal itself using a sub-page as the landing page for the journal. If you aren’t sure, we’re always happy to advise you about your options.)

Navigate to

Click “Create Community.” If you don’t have a PubPub account, you’ll be prompted to create one.

What you need to input to create your community.

A URL and title are required for your community, and are changeable later after the community has been established.

Optional details to input at this stage are:

  • a brief community description

  • a logo

  • accent colors (light and dark)

If you chose not to add these details in at this time, you’ll have the chance to do so, and to change them, later.

2. Setting the Settings

Upon the creation of your community, you’ll find yourself on a homepage with some instructional copy and your community title. From here, click on “Dashboard” at the top right of your screen. A small dropdown will appear that includes the name of your community. Click on your community name.

This will take you to a dashboard, from which you can set your higher-level community-wide settings, as well as create new pages.

Community Dashboard

On the left hand sidebar, there are several options:

  • Overview shows you collections, pubs, discussions, and reviews. You can search for a Pub (our word for what you might call a chapter, article, report, etc. based on what you’re publishing. As a brand new community with no content, this list won’t be relevant just yet.) in the bar marked “Filter Pubs & Collections.” You can scroll to see a complete list of Pubs, including discussions and reviews. You can create a Pub by using the button at the upper right. Collections is where you can add tags to content to better organize it on your site. Some collection tags, like books or journals, also have associated metadata. Collections will be more relevant later on when you have content in your community.

  • Pages shows a list of all pages within the community. Pages are for static content (like an about page) and displaying your Pubs (like an issue page). From this view, you can edit, access, and see the visibility status of all your pages.

  • Reviews are the way that authors (or anyone) who doesn’t have permission to publish directly to the community can add their content. They could be submissions, peer reviews, or more. Other community members can then discuss the reviews and decide whether to publish them.

  • Members is where you can add members for your site. This list is determined by you and those who need to be involved in your project.(Members will need to create these accounts before you can add them using their name.)

Members View

Each member can have specific permissions as to what they can view, edit, and manage. Admins have wider permissions across the community.

Options for member permissions

Most journals will need only one or two admins at the community level. These are the folks who will create the pub releases, assign DOIs, and make important decisions about what might need to be deleted. Manage level permissions are for team members who create and organize pubs into issues (collections), and manage settings at that level. View permissions are important because they enable folks to see pubs and discussions for things that are not yet released to the public.

  • Settings will take you to your site’s master list of… settings!

Navigate to Settings.

Settings is where you can determine site-wide options, such as accent colors, your navigation bar, footer, and logo(s). It is also where you establish your homepage banner.

For freely-usable, high-quality images, we recommend Please credit photo authors when using their work.

The favicon image is used on the browser tab. The preview image is for social sharing cards.

If you do not want visitors to your community to be able to create their own pubs, please toggle off “Public New Pub Button.”

You have the option to show a navigation bar or not. If you’d like one, you can add and organize internal pages and links to external ones here. Many journals will organize back issues via a dropdown on the navigation bar. Please note: you must first create pages to organize them here on the navigation bar.

You have the option of showing a homepage banner or not. If you’d like one (most communities have a banner), this is where you can design it. We recommend playing around with all of the banner options and using the preview tool below them to see what they look like in practice.

There are countless combinations of ways you can design your banner. One feature, for instance, is the ability to include up to two buttons in your banner. If your journal is connected to a society or association, you may want to add a button to link to that website. You could also add a button for signing up for updates or a newsletter.

Use the banner background option for an image that will fill up the header of your Community. The Knowledge Futures Group Notes community implements a banner background with centered text.

Use the banner image option for an image that will appear to the right of your banner. The book, Smart Enough City, implements this nicely.

Use the banner logo option for an image that will appear to the left of your banner. Goldsmiths Press implements this option well.

Social is where you can add links to any additional websites, social spaces, or ways to contact you. They are all optional.

Footer is where you can manage the content on the bottom of your community, from a logo or image to additional links.

3. Creating Pages

Pages on PubPub are spaces within which you can display text as well as pubs (chapters, articles, etc). Pages that journals may wish to include might be: about [the journal], information about the editorial board, directions regarding how to submit content, and/or backissues.

Your homepage is likely the first page people will see when they land on your site. At this stage, your homepage is already partially designed because of the work to the banner you conducted within Settings.

To add text and other content to your page, again click to the “Dashboard” button in the top right and select your community. Then select the Pages view on the left side. You will see your Home page.

We recommend including some introductory and/or contextualizing copy to your homepage to help situate new visitors.2 To do so, you can use the pre-existing text box that contains brief “getting started” directions. Simply delete that text and add your own.

Pages can be shared with members who do not have Admin access prior to their public release by clicking on the share link within the draft view of a page (see screenshot).

All pages on PubPub consist of different combinations of content blocks. It is on the manage dashboard for each page, your homepage included, that you can create and flow content into each kind of block. The content block types (examples below) are:

  • Pubs: flow in content that lives in pubs. Pubs blocks have different view options—large, medium, small, and minimal—that show cover images and publication information in different ways.

  • Banners: allow you to add images, text, or buttons with links within a page that is not your homepage.

  • Text: to add text directly into a page, as we recommended doing for your homepage above, use this block option.

  • HTML: to add some of your own design or formatting to your pages, you can use the html block option.

  • Pages: to link to other pages from a page, use this option. Pages in a pages block appear as tiles. If you page has a preview image uploaded to it, this image will appear as the cover image in this tile.

The best way to understand how content blocks work is to look at how other communities have used them.3 For example, the KFG Notes community homepage contents (below the nav bar) can be broken down like this:

  1. A text block, with centered text

  2. A pages block linking to other pages on the site

  3. A pubs block with the small view selected

  4. A banner block with a background image, text, and a button linking to another PubPub Community.

4. Adding Pubs

To add Pubs to your journal community click on the “Create Pub” button a the top of the site. This will take you to a new untitled pub.

You can ingest from a variety of different file formats, then add the Title, authors, etc. (Note: If you have many articles that you need to move, please contact us for assistance with bulk upload.)

If you are adding back content, it is now possible to change the publication date for the Pub, just select “custom publication date” in the Pub Settings.

5. Gathering Pubs into an Issue

Pubs can be organized into Collections by theme (also the way to “bind” content together into an issue, a book, or a conference.

From the Community Dashboard, select “Create Collection.”

Creating a Collection

This will open a pane where you indicate the type of collection you want to create.

Creating an issue.

Using Issue to organize your issue generates metadata appropriate for a journal issue. To do so, navigate to Settings in the left side panel, where you’ll see fields to set the issue-level DOI, the publication date, and the ISSN (article-level metadata is also possible and managed from the article-specific Settings panel).

6. A note on DOIs

PubPub works with Crossref to assign DOIs, but many journals may wish to have their own Crossref relationship for assigning DOIs with journal specific prefixes. Please contact us if you would like us to ensure that DOIs deposited under your PubPub community have your group’s prefix.

7. Setting up a Domain

Each PubPub community can designate a PubPub subdomain. As a paid service, we enable communities to use their own domain names. More information on setting this up can be found here.

8. Citations

Citation formats are set at the Pub level. Navigate to the Pub dashboard, bu clicking on Dashboard in the upper right then selecting the Pub name. Next, select Settings. We are working on enabling a template to be used across the journal that will enable a default citation style, so please stay tuned for more on that.

No comments here
Why not start the discussion?