Guide to Calendars

This content is exclusive to the guild

Calendars can convey a wealth of lore about the priorities, customs, and history of your setting. They are where culture intersects the cycles of nature. Have you ever wondered why the length of the Gregorian Calendar is 7 days long? Have you ever wondered the origins of each weekday's and month's names? These were not features made in a sitting, they evolved and were injected into iterations of the calendar going back for 100 years.

Making Your Calendar

Order of Operations

  1. Create a blank calendar
  2. Initialize Weekdays and Months
  3. Add Celestials
  4. Add Events
  5. Embed and share

1: Create a Blank Calendar

Navigate to the Timelines and Calendars page from the "Timelines and Calendars" button on the navigation sidebar of the site. Navigate to the calendars tab once you open the page.

On the righthand side of the page (the bottom, if you're on mobile), is an option to create a new calendar. Title and create your calendar, and you will automatically be rerouted to its editor.

You may also choose to set the Day Offset and Year Offset at this time, though both can be edited later.

Calendar Page

2: Initialize Weekdays and Months

First, expand the "Weekdays" section and click "Add Weekday" for as many weekdays as you intend to add, then label them all accordingly. This is a required part of the calendar, as it specifies the length of a week. You can edit these later.

If you wish to hide weekdays from view, toggle Hide the names of the days of the week in presentation to hide them from the Presentation.

Next, expand the "Months" section and click "Add Month" for as many months as you intend to add. For now, I recommend adding all of them before filling them out, as adding a new one wipes out the old. Once you've added the correct number of months, fill out their length and duration. You can edit these later.

Once you have done, scroll towards the top and click the Save button.

You will now see your calendar preview rendered to your specs.

3: Add Celestials

Celestial Objects are any object important to the calendar which moves in repeating cycles. This might be moons, meteors, or other satellites, but you can get creative and treat this field however you wish.

You are given several fields to fill out. Next to each is a which you may hover for more information as to what that field is for. The important ones are the cycle, which determines how long a celestial takes to go between 'new moon' phases, and shift, which shifts the initial phase of the celestial forward (or backwards with negative numbers) so you can adjust it to your preference.

  Icon: They can be any icon from Fontawsome or RPG-Awesome.
Color: Use HTML Colors to change the secondary color of the background.
Classes: Custom css classes can be used for a special layout for each celestial object.
Description: This description will appear in a modal when clicking on the celestial object on the embedded calendar.  

4: Add Events

Events are nonstatic recurring occurences within a calendar. This may be holidays, or leap days, or anything else you can concoct. Add them by hovering the date you wish to add an event to and clicking the button which appears. This will open a dialog full of event creation options. If you are confused by an option, click the floating symbol for help. If that doesn't help, ask below and I will answer within a day or two!

5: Embed and Share

Others can only see your Calendar if you embed it into an article to share first. You can embed your calendar by clicking the Copy Calendar BBCode button towards the top of the editor, and pasting the result into an article.

To set a year, add it as an argument. So if, for example, the BBCode is [calendar:50126] you can set it to [calendar:50126|2020] to have it render as the year 2020.

This not a timeline!

Calendars are not timelines! They are not intended for use as a timeline, but later will be combined with them.

Instead, they are a template of events to be combined with your timeline! A calendar represents a cycle, a timeline represents a line!


I have a request!

To follow the progress and plans, check out the Trello!

There will always a card for leaving comments in the In Progress column/list, so if you have a Trello account feel free to leave a note.

I check it regularly.

I found a bug!

Comment it on Trello or in the comments below!

CSS Editing

For Journeymen+

The calendar is chock-full of unique selectors you can use for styling it with CSS. I've put calendar- at the front of all the selectors you should be using for this, so if you see an element we missed and would like us to add it, comment below!

Custom Date CSS

The tags you apply to an event are applied to the date on the presentation side. So if for example you add holiday as a tag to a note, then you can select the css of the presentation side and give it a unique styling!

 .user-css {
   box-shadow: inset 0px 0px 5px green;



Cover image: Calendar by Monica Sauro


Please Login in order to comment!
Ariel Webster
20 Nov, 2019 02:09

Is there a way to, or future plans to make celestial objects rotate the opposite way? I can seem to make my moon cycle line up with the one on Fantasy Calendar and i think that might be the reason. (The days the full moons land is important for plot reasons)

20 Nov, 2019 21:27

Not a bad idea, I'll look into adding that! Production on the calendars will continue in december!

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
21 Dec, 2019 15:38

Hey team. Overall, I am a big fan of the calendar feature. However, I think that it would also be a great feature to add to the Campain sphere of World Anvil. Forgive me if someone has already asked about this, or if it is already a feature, but I would like to use the calendar that I have set up to keep track of campaign events and track where the characters are in the year. Is there a plan to set this up/a way to do this?

21 Dec, 2019 15:40

Also, small thing, I chose icons for some holidays in the calendar that I set up, but I am not seeing the icons on the calendar. Is there a setting that I can choose to give individual days more space to show all the icons?

23 Dec, 2019 16:32

There is no auto-tracker currently because that would be a very tricky thing to implement. It has to accommodate for worlds which have multiple calendars, which means there's quite a bit of work I would need to do first (such as setting a main calendar, setting a way to calculate what one date on one calendar is to another, etc).   It's on my possible list, but it's not very high currently.   What you can do currently is to embed it into an article and add that article to the campaign and have them refer to it often. And you can set up the current day like you would any other event and each day update it and delete the old one.   For your other issue, I'd need a link to the article the calendar is embedded in to see and help with the issue.

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
11 Jan, 2020 13:39

Thank you for informing me on the hurdles there, I understand you putting other features before that. However, if you all eventually have time and it is feasible, it would be awesome!   As for my issue, I was able to sort it out. Turns out I didn't understand the format I needed to have other icon identifiers in, but I have since figured it out. Sorry for the trouble!

14 Jan, 2020 16:32

All good! Glad you were able to get it!

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
20 Jan, 2020 16:36

Perhaps having a default event called 'Current Day' that we could add to the calendars would work, with some functionality to click a 'next day' button to move the event? I'm not a coder so no idea how complicated that would be!   A way to have the calendar automatically open on a certain month would be useful enough :)

Uht Ceara
23 Dec, 2019 08:40

Hi, apologies if this is just an oversight on my part, but i can't seem to locate or identify what icons are available for the celestial bodies. a) can someone please direct me to where i can find this information. b) can i suggest a drop down list for this feature such as the one available on the mapping feature?

23 Dec, 2019 16:28

1: There's a bit of info in that section of the event creator, but you can find all the possible icons here. Find one you want and click it to go to its page, then copy the text from its class into that field on WA. For example, mountain would be fas fa-mountain.   2: Given the number of options I likely won't implement a dropdown, but perhaps I can find an elegant way to have some defaults, sure. :)

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
Uht Ceara
23 Dec, 2019 18:44

Thanks so much!

5 Jan, 2020 02:24

When looking at a holiday, when custom celestial object names are applied, every phase appears as if it were the first phase, or "new" (for me, "Dead")

10 Jan, 2020 22:17

I'll look into it!

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
2 Feb, 2020 14:39

I have this issue, as well. Three moons with different colors, but use the standard object phases/aliases. When I imbed the calendar in an article and click on an event, the pop-up shows the correct event title and lunar phase icons, but the text by each moon image is "is New" not Young or Waxing, etc.   Also, is there a way to see lunar phases on the calendar (or by clicking on a moon) on days that have no events, or do I need to create an event for each day I want to be able to look at the moons' phases for that day?

2 Feb, 2020 15:00

UPDATE: I figured out how to change the font icon for the moons to fas fa-circle, and can now see the lunar phases on the main calendar without needing to open an event.

2 Feb, 2020 20:02

Oooh I better make sure I'm setting that as the default. That makes a lot of sense—thank you for the input!

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
Master rodgerbee
Rodger Ball
22 Feb, 2020 22:53

Feature Request: Have the ability to turn off the display of Day of the Month.   Combined with the "Week Names" feature this make it so you calendar is by Week-Name, Day-Name vs Day of Month.

7 Mar, 2020 17:06

There used to be a short toolbox where you could input the current/active day in your world's calendar. That feature seems to now be gone, or has moved. How do I, now, set my current day for my campaign?

8 Mar, 2020 19:45

You could add it as an event and update it as necessary, as holidays can style their holiday if you add some of the premade options.

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
17 Mar, 2020 03:30

When I Save Information, no preview appears. If I embed the calendar in an article I can look at it, but I can't see it in the editor.

4 Apr, 2020 07:08

Have you added weeks and days? If so, I'll have to see the article you've embedded it in.

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
9 Apr, 2020 19:27

Having same issue here too. Days and weeks added. No preview.

7 Jul, 2020 00:42

Same problem, no changes are saved when I click save information. My long description just disappears. No previews either.

7 Jul, 2020 03:45

Are you on the discord? I can fix it up pretty quick from there.

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
8 Jul, 2020 09:36

I am also having this issue. This error appears in the console: Uncaught TypeError: Cannot read property 'split' of undefined at Object.<anonymous> (calendar?v=09742:22)   The line it's breaking on is: if(typeof val.month=='undefined'"-")[0];"-")[1];}   Seems to break at the first split, when it's setting the month.

10 Jul, 2020 20:08

I have checked in a fix. Try now.

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
7 Apr, 2020 08:20

Hi there, there seems to be a missing screenshot at the beginning. At least, the first sentence indicates there should be one. It seems it would have some important & useful info.

First of all, you want to fill out all the values in the screenshot above.

10 Apr, 2020 14:04

Hi. Just wanted to say that the calendar updates are AWESOME!!! Thanks so much Team WA!!!!

Grandmaster Foyiwae
Foyiwae Andrews
15 Apr, 2020 08:28

I'm having difficulty importing the JSON data from another calendar that I have.

6 May, 2020 20:54

Spaceflows is a fellow user and cannot help you, and even if they could that would give them no information to work with.   If the JSON is from another site it's not going to work. If it's from another WA calendar please contact me through the discord and we can investigate together. :)

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
6 May, 2020 19:10

Previously it was said that this feature would be available soon: "Is there a way to link directly to a specific month in the calendar when embedded? aka calendar:20011|2019|1" Specifying a year works, but I can't get it to default to a month/day. Is this feature still being worked on?

6 May, 2020 20:52

It is, sorry. It got pushed down the list a bit.

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
9 May, 2020 01:51

Happy to know it's on the list :-)

19 May, 2020 02:57

Hello! I seem to be having an issue where when making holidays and setting them to Annually, they are still showing up monthly. Am I doing something wrong?

8 Jun, 2020 23:02

What do the presentation tags "Inset" and "Outset" mean?

14 Jun, 2020 17:50

They're not currently functional (bug) but they are meant to make the day look inset (like these comment boxes) or outset (like a button).

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
14 Jun, 2020 17:36

How does one get the lunar phases to show as the phase names (waxing, waning, new, old) and not the celestial body name?

14 Jun, 2020 17:52

Where at? When you click the celestial? That's not yet implemented but will be in time!

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
14 Jun, 2020 17:53

Oh okay. Thank you ^^ Just wanted to make sure that I wasn't doing something wrong.

17 Jun, 2020 09:47

Anyone know how to solve this? When embedded in an article the numbers are white and impossible to read against the white background of the calendar and I haven't found a way to solve it. ;-;

17 Jun, 2020 17:21

Add this to your CSS for now, I need to sweep through all the styles and fix the Calendar CSS to work better with them.

.user-css-calendar .calendar-day {
  background: #7d7d7d8c;

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
17 Jun, 2020 21:50

Thank youuuu <3

14 Jul, 2020 20:52

Is there a way to have timeline events show up on the calendar and vice-versa? Or do you need to create them separately?   Or am I misunderstanding the calendar and it's really just there to track recurring things (lunar changes, holidays, etc...)

15 Jul, 2020 16:51

For now it's just to track recurring events. With the next update of the Timeline the goal is to be able to show a timeline as a calendar and so see that calendar as its holidays and timeline events.

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
Grandmaster jerry247
richard fraser
30 Sep, 2020 08:02


19 Jul, 2020 22:03

Hey so maybe i'm doing something wrong but my calendar looks nothing like the one in the screenshot and i can't add holidays. Do i have to upgrade to get this?

20 Jul, 2020 00:48

No you have the guild level to do everything. How are you trying to add holidays and what happens when you do?

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
25 Jul, 2020 06:32

Well my screen doesn't look like the one up above. There's no calendar chart to edit. I can change the weekdays, months and celestial objects and that is pretty much it.

25 Jul, 2020 18:21

Hmm. I can help you faster through the discord on this one but will try. Have you added weekdays?

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
25 Jul, 2020 21:54

Oh yea i can add the months and weekdays to the calendar. Ok ill go to discord

2 Aug, 2020 23:23

Forgive me if this has been answered, but when I embed my calendar with a year offset, the celestial bodies don't adjust for the offset. What am I doing wrong? example: I embed

and the moon phases are the same as when I embed
even though I set different cycle values. Thank!

3 Aug, 2020 05:09

If you get me an ID or a link to a public page I can have a look. Sounds like a bug!

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
7 Aug, 2020 17:22

Oh thank you! Here is a link to the public article.

7 Aug, 2020 17:24

And here is a link to the edit page

11 Aug, 2020 23:04

I also have this issue - I've been looking at the settings for a little while trying to figure out what I'm doing wrong. Any feedback or advice would be amazing!

12 Aug, 2020 02:39

It's a bug on my end—working on it! I'll reply here once I've got it. Work has been hectic, so my apologies ^ ^;

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
12 Aug, 2020 03:19

Don't apologize! You guys work so hard and are always generating new content. You rock!

12 Aug, 2020 14:18

Like DMGraham said it's not a problem at all :)

16 Aug, 2020 21:53

Just started making my first world(s) and noticed something with the calendars. It may be a known bug, but when I add the moon cycles and click on the moon phase image in the calendar it just gives the basic definition of the moon, not its current phase. However if I have added a holiday to the date and click on the holiday it gives the phases of each moon. Not sure if it supposed to work that way, but it would be useful to see the written phase of the moon when you click on the phase image as it is hard for players to remember which images mean what phase.

17 Aug, 2020 03:34

I'm planning to make the full description universal in upcoming updates!

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
22 Aug, 2020 18:16

Some calendars (The Harptos of Faerun and Tolkien's Shire Reckoning, off the top of my head) have High Holidays that are "between" months, and have no weekday or calendar day number attached to them.   eg: The summer solstice might be celebrated between June and July, and be neither Tuesday June 30th nor Wednesday July 1st. There's a "leap-day", kind of, for such holidays. You get Tuesday, Solstice, Wednesday.   I tried adding the high days in the Harptosian calendar as separate months, but they get assigned a weekday. Will there be a way to flag high days as having no week-day attached to them, or some such means/method?   Thanks!!

22 Aug, 2020 18:26

Also, leap-years... Thanks!!

24 Aug, 2020 22:32

Those both use the same logic under the covers and are a part of the current WIP update!

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
26 Aug, 2020 20:03

Thank you Ademal! That's great!   Also, for lunar cycles: will it be possible to specify the length of days in hours, and that lunar cycles are a combination of days and hours? Again using Faerûn, Selûne has a period 30 days and 10 hours, so every 12 lunar cycles moves the new moon forward 5 calendar days. Thanks!

23 Aug, 2020 02:27

Is there a way to get the descriptions for individual months to actually display? I can't seem to get them to work no matter what I try.

24 Aug, 2020 22:31

What's your calendar ID? I'll have a look.

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
24 Aug, 2020 23:46

I have been have this problem for weeks...thought it was weird or something I should live with didn't realize it was a bit bugged. calendar:49177 []   ALSO a little off topic but I can't get the Celestial Objects descriptions to pop up without an event...even you calendar does it. If you click on a day without an event all it says is Luna2 or Kera Phases [For mine]. it doesn't say waxing or winning at all UNLESS you put an event on it.   Thanks for all your work on this it is awesome!!!

25 Aug, 2020 13:22

calendar:49549 is the calendar I first noticed the issue, but I'm having the same problem with all of my calendars at the moment. Thanks for the help.

7 Oct, 2020 07:37

Haven't figured it out yet but it's my next primary focus so should be fixed within the next week or two, sorry for the delay.

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
12 Sep, 2020 06:16

2 things, first, I am having the same problem as Venerable Grandmaster Arkandy. I made my calendar, put in all the months and when I put in a holiday and set it to occur annually, it shows up no matter the month that I click on in the month list on for the calendar at the bottom of the page. Don't know if this will help but I did try embedding it in an article and when I did so I would click on other months, but the 1st one remained highlighted as though I could not see the other ones.   Next is a question. Is there any likelihood that the calendar will be attached to the tab that lets us set our world's current date. You can currently set this for the World (World>SETTINGS & TOOLS>Configuration>Date & Time). That way people know when we are at in the settings history when the log into the world. I would love to have these synced up so that I can continue to advance the time. Which would be important for my players and for me as the GM to help keep track of when we are.

13 Sep, 2020 21:54

Make sure the event is set to annual, not yearly. I'll investigate more on my side.   It will be synced with timelines for sure. Not sure yet about current date. I would like to do that, yes, but it has to be a robust implementation that keeps a current date regardless of which calendar system that's being used.

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
Journeyman Irish.Bastard
Franco Guglielmoni
13 Sep, 2020 21:32

How I add leap years? My calendar are the real one (my world is our world)!

13 Sep, 2020 21:47

This feature is about complete! It's been slow but I am nearing completion on it.

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
Journeyman Irish.Bastard
Franco Guglielmoni
21 Sep, 2020 19:55

Ok, tnx! :)

28 Sep, 2020 18:15

Can i print my calendar? if so, how?

29 Sep, 2020 01:06

There isn't a particular method for this, no. Your best bet would be to print screenshots.

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
8 Oct, 2020 21:11

Houston we have a problem! When I added an incorrectly formatted icon text change o the 30th day of the first month of my calendar, the calendar disappeared from the editor's view. Orignal icon text: fas fa-book-open Changed icon text to: fas skull - incorrect format Correct format: fas fa-skull Additional bugs: 1. Prior to the above icon text change calendar was not visible in my article view 2. Events entered using the +calendar icon were not appearing on the calendar.

Thanks!   MrGunn [email protected]
12 Oct, 2020 19:56

Is there a place with the import code needed for the Gregorian Calendar? I am having an issue finding it

12 Oct, 2020 22:28

It's not 1:1 to our calendar yet as I'm still adding leap year functionality, but you can find it here!

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
13 Oct, 2020 19:59

You are amazing! thank you so much!

14 Oct, 2020 22:36

Admael, hope you are well. I am still seeing a lot of odd behavior with the calendars. I cannot seem to add or modify Annual events anymore. My calendar crashed again this time when I was modifying an existing entry using the base tools. Calendar would not upate when using new Font Awesome code, fas fa-certificate,, string was was correct this time, just would not display.

Thanks!   MrGunn [email protected]
15 Oct, 2020 22:21

I seem unable to add Annual events to my calendar. Monthly events seem to be working.

Thanks!   MrGunn [email protected]
16 Oct, 2020 22:12

Ademal, oofdah, I am finding a lot of issues with the display of the calendar when you click on the entries. Especially with the celestial parts. For example, when I click on an entry my calendar will pop of a message with the correct display but the moon will say moon is in 0.   Also seeing an issue when I click on a moon it shows the last calendar entry I clicked on no matter which moon I clicked on.

Thanks!   MrGunn [email protected]
19 Oct, 2020 03:24

Thank you for reporting, I'll be focusing on a lot of yours and another primary issue tomorrow!

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
20 Oct, 2020 03:52

Moon in 0: You'll have to set the name of the phase and save it in the editor. This is because I have no placeholder value for new celestials, but it has phantom placeholder text that makes it look like it does. I'll be fixing that.   Last moon clicked: On my list to fix!   Annual Events: I think I fixed it. Dimi should deploy within the next few hours (It's currently 9pm PST)   I also fixed a lot of weirdness caused by having a space in one of your month names, and I think that was causing a lot of your other issues so that should help a lot!

Admin of the World Anvil Codex & Discord | Director of Ethnis | My Ko-Fi | My Twitter
21 Oct, 2020 00:04

Thanks brov!

Thanks!   MrGunn [email protected]
23 Oct, 2020 13:32

Things seem to be getting more stable. I do wish there was was a skip a particular note on the calendar when it is superseded. For example, lets say you have a Low Mass every Sunday, but once a year, you have a High Mass that super cedes the Low mass. Currently one has to manually add events for each day or group 1-7, X, 9-12

Thanks!   MrGunn [email protected]
23 Oct, 2020 13:44

Feature request, are we planning the ability to add our own icons. If we had size parameters and a way to add images that would be very cool.

Thanks!   MrGunn [email protected]