Create pages, menus, sliders and galleries in MuseDock CMS

This guide is for anyone managing a website with MuseDock CMS who wants to get it ready with the minimum steps. Every example uses the domain example.com: replace it with yours. The admin panel is at https://example.com/admin/ (the panel path may differ on your installation).

The right order: pages first, then the menu

  1. Create the pages (Home, Biography, Contact…).
  2. Choose which one is the homepage (the one shown at https://example.com/).
  3. Build the menu by adding those pages.
  4. Add your social links, and if you want, sliders, galleries and your own header image (sections 5 and 6).
  5. Check the result in a private browser window.

A menu cannot link to a page that does not exist yet, which is why pages always come first.

1. Create a page

  1. Go to Pages → Create Page.
  2. Type the title. The Slug (the address) is filled in automatically: Biography becomes https://example.com/biography.
  3. Write the content in the editor.
  4. In Status choose Published to show it right away, or Draft to keep working without anyone seeing it.
  5. Leave the «Publish on» field empty (see below for why).
  6. Click Create Page.

Repeat for every page: Home, Biography, Concerts, Contact, and so on.

2. Choose the homepage

There are two ways; one is enough:

  • When editing the page, switch on Set as homepage and save.
  • Or go to Settings → Reading (/admin/settings/reading), under Your homepage displays choose the static page and select the Homepage.

The homepage must be published and public. Otherwise your site will show a 404 error at https://example.com/.

3. Create the menu

  1. Go to Menus → Create.
  2. Enter a menu title (for example "Main") and choose the Location: the place on the site where it will appear (header navigation, footer…). Also choose the Language.
  3. On the menu editing screen, in the pages panel, tick the pages you want and click Add Pages to Menu.
  4. For a link that is not a page (for example, "Home" pointing to the homepage), use Custom link: Link text = Home, Custom URL = /, then click Add Link.
  5. Drag the items to order them. Dragging one slightly to the right of another makes it a submenu.
  6. Click «Save menu». Until you do, changes are not applied.

To change an item's text or address use the pencil icon; to remove it, the bin icon. Removing an item from the menu does not delete the page.

4. Social links

  1. Go to Settings → SEO and Social (/admin/settings/seo), Social Networks section.
  2. Paste the full address of each profile, for example https://www.instagram.com/your-username. Only the networks you fill in are shown.
  3. Save. The icons appear wherever the theme displays them (usually the footer).

If you fill in none, no icon is shown: that is not a bug, it simply means there are no links.

5. Sliders and galleries: shortcodes

A slider (slides) or a gallery (photo grid) is not created inside the page: it is created separately and, when you create it, the CMS gives it a shortcode, a code in square brackets. That code is what you paste into the page where you want it to appear.

Slider

  1. Go to Sliders (/admin/sliders), click Create New Slider and add your slides. The slider needs at least one active slide to show.
  2. In the sliders list you will see its shortcode, for example [slider id=3]. Click the clipboard icon to copy it.

Gallery

Galleries are a module: if you do not see Galleries in the side menu, your site does not have it enabled.

  1. Go to Galleries (/admin/image-gallery), click Create Gallery, fill it in and upload its images. The gallery must be marked active.
  2. A gallery has two equivalent shortcode forms: by number, [gallery id=1], or by name, [gallery slug="my-gallery"]. You can see them when editing the gallery.
  3. You can optionally change the look from the shortcode itself: [gallery id=1 columns=4 layout="masonry"]. Available layouts are grid, masonry and carousel; if you set nothing, the gallery's own settings are used.

Put it on the page

  1. Open the page under Pages → Edit.
  2. Paste the complete shortcode, brackets included, into the content, on its own line, exactly where you want it to appear.
  3. Save the page and check it in a private window.

You can use the same shortcode on as many pages as you like; if you later change the slides or photos, every page updates. While the gallery or slider is inactive, or has no images, nothing shows on the page (it does not cause an error).

Important: do not type the shortcode by hand if you are unsure of the number. Copy it from the list, and do not move anything inside the brackets ([ ]) or add spaces within.

6. Header image for each page

Many pages start with a large band with an image and a title. If you choose nothing, the default theme uses a default image (rotated among several, so it may change on reload; other themes may behave differently). To set your own:

  1. Edit the page (Pages → Edit) and scroll to the Header Options block.
  2. Make sure Show header with image is on.
  3. Under Background image, click Select image and pick or upload your photo. If your installation has the AI module, you can also generate one.
  4. Optional: type a Header title (if empty, the page title is used) and a Subtitle.
  5. Save the page.
  • Recommended size: 1920×400 px for pages (1920×600 px for blog posts). A landscape, not-too-heavy image works best.
  • Remove your image and go back to the default one: Remove image button.
  • No band at all: turn off Show header with image.
  • If the header already shows the title, keep Hide H1 title in the main content ticked so it is not repeated.
  • Each page has its own header. For a consistent site, use the same image (or a series in the same style) on all of them.

Rules to avoid breaking your site

Do thisAvoid thisWhy
Leave «Publish on» empty to publish right away.Typing a date by hand when you don't need to.The server time is UTC (in Spain, one hour behind your clock in winter). A "now" date typed in your local time may end up in the future and the page will not show until then (404 error).
Create another homepage before removing the current one.Deleting, drafting or making the homepage private.Without a homepage, https://example.com/ returns a 404 error. Recent CMS versions block this and warn you.
Use the Trash if in doubt.Deleting permanently.Trashed pages can be restored. Permanent deletion cannot be undone.
Keep the Slug once published.Changing the address of an already linked page.Old links and Google will no longer find it. If you change it, review the menu.
Use Draft while you work.Publishing half-finished pages.Visitors see whatever you publish instantly.
Click Save menu when finished.Leaving the menu screen without saving.Menu changes are not applied until saved.

How to check everything is fine

  1. Open https://example.com/ in a private window (not logged in): that is what any visitor sees.
  2. Click every menu item.
  3. If you don't see a recent change, reload with Ctrl+F5. The site keeps copies of pages to be faster and they may take a moment to refresh.

FAQ and troubleshooting

My homepage shows "Page not found"

The page chosen as the homepage cannot be displayed. While you are logged in as an administrator, the site itself shows a yellow notice with the reason. The usual causes are: it is in the Trash, it is a Draft, it is Private, or it has a future publish date. Fix the relevant one under Pages (restore it from the trash, publish it and leave «Publish on» empty) and check it is still set as the homepage.

I added a page but it is not in the menu

Creating a page does not add it to the menu: add it under Menus and click Save menu. Also check that the menu has a Location assigned.

I still see the old menu

Reload with Ctrl+F5 or open a private window. If it is still the same, wait a couple of minutes.

I pasted a slider or gallery shortcode and it does not show

Check, in order: that you saved the page; that the shortcode is complete, with both brackets and no added spaces; that the slider or gallery is active and has images; and that the number matches the list. If you pasted it inside oddly formatted text, delete it and paste it again on an empty line.

The header image changes every time I reload

That is the theme's default image, rotated among several. Choose yours under Header Options → Select image and it will stop changing.

Can I make a page only I can see?

Yes: under Visibility choose Private - Administrators only. Do not use it on the homepage.

How do I recover a page I deleted?

Go to Pages → Trash and restore it. It comes back as a Draft: review it, publish it and, if it was the homepage, set it as the homepage again.