OpenScholar FAQ

Adding an iframe to an Openscholar Site

You can embed an iframe into your OpenScholar site (like a Google Map, or a YourTube video). To do that, please follow these steps:

  1. Create the new content (Blog post, Page, etc)
  2. Click on the Body textbox to activate the WYSIWYG editor
  3. Click on the Media button. (to the right of the block quote button)
  4. In the upload window, click on the middle tab at the top labeled Embed from the Web
  5. Paste the iframe code into the box.
  6. Click Submit.

**Please note, depending where the iframe was generated from (Twiiter, YouTube, Google Maps, etc.) the link may or may not work. We have only approved to allow iframe, embeds from certain providers. They are listed at the bottom of the file upload window (the window you use to enter the iframe code).

Layouts for Responsive Design Themes and Rotating Banners

For best practices when choosing a responsive theme and using a rotating banner, we recommend you place your rotating banner widget in the box below the primary navigation menu, not inside the same box. Below we have a screenshot of a 3 column layout with a rotating banner and a 2 column layout with a rotating banner with a responsive theme selected. 

Three Column Layout example:

Two Column Layout example:

Replacement File Not Updating

** Updated: This issue should be resolved with our August 2016 update. If you are still having issues, please read the suggestions below. When replacing a file, do not rename it with a different name. This can cause the system to keep on older file and not over write it.

In the 3.0 branch of OpenScholar, we discovered that if you try to replace an old PDF file with a new, updated version of the same file with the same file name, the old one will still appear, even if you deleted it.

There are a couple of ways you can troubleshoot this issue:

  1. Wait 30 minutes for the varnish cache to clear and then click SHIFT + refresh in your browser. Or you can immediately click SHIFT+ Refresh in the pdf window and you will see the updated file. 

  2. Make sure you replaced the file by going into Content > Find > Files. Click on the Edit link to the right of the file you want to replace. At the bottom of the window, there's an option to replace the file. Click the Browse button and find the replacement file (click Open to upload the file). Click Save when you upload the replacement file (with the same file name). Now open the file in the browser by clicking on the link. If you see the old file, hold down SHIFT + Refresh at the same time in the browser. You should now see the new file displayed in the browser. 

  3. You can delete the old file, and re-upload the replacement file, wait 30 minutes for varnish cache to clear and then click SHIFT + refresh in your browser (this may require a few refreshes).

  4. You can make your PDF a read only Word doc. When you go to Content > Find > Files, you will notice there's a an edit button next to the file. Click on edit. At the bottom of the window, there's an option to replace the file. You can keep replacing it with updated read-only Word docs.

Adding a New Publication, the Textbox is not Editable

A design feature with OpenScholar version 3.15 is that text boxes may be compressed to save space on a page. In some cases, like when adding a new publication, the textbox will appear as a small thin line. To expand the textbox so you can add content you can do the following:

  • Click inside the textbox
  • The textbox will expand displaying a WYSIWYG editor
  • Add text

Turning Off Breadcrumbs

OpenScholar's 3.0 branch added the feature of Breadcrumbs to pages. You may see a line of links at the top of the page content that look like this Home/ Media Gallery/ Gallery 1. Some users think that the breadcrumbs don't work in their site design if they already have a navigation menu and would like to remove it. You can easily remove the breadcrumbs by following these steps:

  1. Go to Settings in the Admin Bar

  2. Scroll down to the Breadcrumbs section

  3. Check the checkbox next to Hide breadcrumbs from displaying on my site

  4. Click the Save button

After I Log Out My Edits to My Page Don't Appear

OpenScholar's 3.0 branch has the option for users to clear their site cache. When a site administrator makes a change, they will see it automatically when logged in but if they log out right away, it may appear that none of their changes were saved. To see the edit right away when logged out, follow these steps:

  1. Log into your site
  2. Go to Settings in your Admin Bar
  3. Under Maintenance click the Clear Site Cache button.
  4. Click the Save button at the bottom of the Settings page

*You can alternatively wait 30 minutes for your site cache to clear automatically to see the changes when you're logged out.

I'm Getting Email Spammed via the OpenScholar Contact Page. How Do I Turn It Off?

If you are receiving large amounts of spam in your email box saying the message was from OpenScholar, you can turn off Anonymous Contact in your Settings. This will help reduce spam coming from the Contact form in OpenScholar. To turn this settings off, follow these steps:

  • Log in to OpenScholar and click on the Site Info widget (the widget with your name)
  • Choose Edit
  • at the bottom of this window uncheck Enable contact form for Logged Out users.
  • Click the Save button to save the changes to your Settings

If this solution doesn't work, you can set up an email filter to filter out the spam. You can follow these steps (In Outlook/ Outlook Web App) to filter these OpenScholar specific spam emails.

  • Log in to email and click on Options (right side if using Web App, if using Outlook Client, click on File tab and choose Options).

  • Choose Create an Inbox rule

  • Click on New. For the drop down that says When my Message arrives, choose "It includes these words in the subject or body...". 

  • Type this phrase into the text box "This message was sent to you from "OpenScholar @ Princeton" on behalf of"

  • Click Ok

  • In the Do the Following drop down choose "Delete the message"

  • Click Save.

Now all the OpenScholar Spam will be filtered to your Deleted folder. You can then delete the message permanently in this folder.

How do I add another Publication page titled "Working Papers" to include all my Working Papers publications?

First you will want to add all your working papers to the main Publications page. Then add a tag titled “Working Papers” to your working paper publications. To do this when you add or edit a working paper publication, on the right hand side you will see a box that says vocabularies. Here for your working papers, enter in the tags text box: Working Papers.

Second, you would want to hide them from the main Publications page so they only appear on the new Working Papers link. To hide the working papers publications from showing up in the main Publications do the following:

•    Go to the Control Panel, and under Site Building, click on Features
•    Click the gear next to Publications that says Customize
•    Find the Show Only Publications of type setting (bottom right)
•    Uncheck Working Papers
•    Click Save

If you click to the Publications page, you will see under Tags “Working Papers”, click that link. You will now only see a listing of your working papers. Copy the URL for this page.

Go back into your Control Panel and choose Site Building--> Menus

•    Click on Add a New Link button.
•    In the Menu Title type Working Papers
•    Paste the URL you copied, the default region should be Primary menu
•    Click the Save Settings button.

You will now see Working Papers in your menu and when you click on it, you will only see the Publications that were tagged with “Working Papers”.

Can I Use Google Analytics for My Site?

Yes, you can also use Google Analytics with your OpenScholar site. If you have an account, you can create a New Property in Google Analytics and copy and paste your new ID into the Settings section in the Control Panel of your site. You can also create a new account if you do not have one and copy and paste the Google Analytics ID under Settings in the Admin Bar of your site.

A more detailed walk through on how to use Google Analytics with OpenScholar can be found here:

Can I Use StatCounter on My OpenScholar Site?

Yes, you can install StatCounter on your OpenScholar site. Here are the steps:

1.    Sign up for a StatCounter account on (they have a free account)
2.    Add a new project 
3.    Enter your OpenScholar homepage (Front page) url -the project name can be the same as the url
4.    Use the StatCounter Code for Default Guide to generate the Snippet to put into your OpenScholar page
5.    Copy that code snippet and go to your OpenScholar Layout in the Control Panel
6.    Click on Add New Widget and choose Embed Media, give the widget a name
7.    Click on Choose File button, click on the Embed from Web tab, and paste in the StatCounter code snippet
8.    Click Save and drag and drop the widget into a sidebar
9.    Save the Front page layout and reload your front page, you should now see a counter

Now you can go back to and view your project (the verification may or may not work, if you get an error just skip the verification/test setup step). Click on the project name to see how many people visited your site and who is visiting your site. To see where your visitors are coming from, click on the Country/State/City/ISP link on the left or Recent Visitor Map.

*Note: You might have to place the widget with the StatCounter code in your sidebar of your page for StatCounter to register the hits to the page. 

*Note: If you want the counter to be invisible, please see StatCounter's FAQ on the topic: