Step 1 — Log in

Open your Birkly address in the browser. It usually looks like:

• https://your-domain.com/admin

or

• http://localhost:8080/admin (if you’re running Birkly locally).

Enter your email and password. If you don’t have an account yet, an administrator must create one for you or send you an invite (you’ll receive a link to set your password).

Example: If your CMS is at https://cms.mycompany.com, you go to https://cms.mycompany.com/admin and sign in. After login you’ll see the Dashboard (overview) and the sidebar with Content, Media, Settings, etc.

---

Step 2 — Set the project name (first time only)

The first time you (or anyone) use the installation, you may see a short onboarding wizard. It will ask for a Project name.

• This name is only for the admin panel (e.g. the label in the sidebar or the browser tab). It does not set your website’s title or URL.
• Example: You might enter “Acme Blog” or “Company Website.” Visitors to your actual site never see this—only people who log in to the admin do.

You can usually skip or complete the wizard in a few clicks. After that, the Dashboard and sidebar are your starting point.

---

Step 3 — Create a collection

Collections are the types of content you manage (e.g. “Blog posts,” “Products,” “Team members”). You create each type once and then add as many entries as you need.

1. In the sidebar, click Content.
2. Click Create collection (or New collection).
3. Give it a name that editors will see (e.g. “Blog posts,” “Services”).
4. Add fields—the pieces of information each entry will have. For each field you choose a label (what appears in the form) and a type (what kind of data).

Example — A “Blog posts” collection:

| Field label | Type | Purpose | |----------------|---------|----------------------------------| | Title | Text | Post title | | Content | Editor | Main body (rich text) | | Excerpt | Textarea| Short summary | | Publication date | Date | When the post was published | | Featured image | Media | One image for the post | | Tags | Tags | Optional tags |

1. In the collection’s Settings (or Configuration) tab, leave Entry method as “Admin only” unless you want to accept submissions from your website (e.g. a contact form).
2. Save the collection.

After saving, you’ll see the new collection in the Content list. Click it to open it and add entries.

---

Step 4 — Add entries

An entry is one item in a collection (one blog post, one product, one team member).

1. Open the collection (e.g. “Blog posts”) from the Content area.
2. Click New entry (or Add entry).
3. Fill in each field:

- Title — Type the post title. - Content — Use the editor to write the body (bold, lists, links, images as needed). - Publication date — Pick the date (and time if the field allows). - Featured image — Click to open the Media Library, pick or upload an image. - Any other fields you added (e.g. Excerpt, Tags).

1. Slug — This becomes the URL-friendly part (e.g. my-first-post). It’s often filled in automatically from the title; you can change it if you want a different URL.
2. Status — Choose Draft (saved but not visible on the site) or Published (visible). Use Save or Save & Publish.
3. Click Save.

Example: You create an entry with title “Welcome to our blog,” content “This is our first post…,” date “2025-02-05,” and slug welcome-to-our-blog. You set status to Published and save. That entry is now stored and will appear when your website loads blog posts from Birkly (once the site is connected).

Repeat for more entries. You can edit or delete entries anytime from the collection’s entry list.

---

Step 5 — Connect your website

So far the content lives only in the admin. To show it on your actual website:

1. Add the Birkly client script to your HTML. One script tag is enough; it should point to your Birkly address.
2. In your HTML, use placeholders where you want content (e.g. “show the title here,” “list all blog posts”). The client script loads the content from Birkly and fills those placeholders when someone visits the page.

Example (minimal):

In your page’s HTML you might have something like:

• A placeholder for a single post’s title and body (e.g. on a “post” page that shows one article).
• A placeholder that means “list the latest 5 blog posts” (e.g. on your homepage).

Your developer or host can add the exact script tag and placeholder syntax (Birkly uses a simple templating language). Once that’s in place, when you publish or edit an entry in the admin, the live site will show the updated content (either immediately when the page loads or after a refresh, depending on how the site is built).

From here you can add more collections (e.g. “Products,” “Team”), upload more media, invite other users, or explore Settings and Help in the admin.