Engagement Project Content Type
Overview
Projects are used to share information, timelines, updates, engagement opportunities, and project resources with your community. This guide walks you through creating and publishing a new project on your CiviKit engagement platform.
Before You Begin
Ensure you are logged into your engagement platform and have:
- Appropriate permissions to create projects
- Project information ready (title, description, timeline, images, etc.)
- Any related forms, contacts, or media already created (if applicable)
Step 1: Create a New Project
- Hover over Content in the administration menu.
- Select Add Content.
- Choose Project.
The Project editing screen will open.
Step 2: Enter Basic Project Information
Add a Project Title
Enter a clear and descriptive title for your project.
Example: New Community Playground Project
Configure Project Settings
Select:
- Featured on Homepage (if applicable)
- Project Category
- Project State
Step 3: Add a Main Image
- Select Add Media.
- Choose an image from the Media Library or upload a new image.
Image Best Practices
- Upload the highest resolution image available within your site’s maximum upload size.
- Always provide Alternative Text (Alt Text) for accessibility.
- Uploaded images are automatically added to the Media Library.
Step 4: Add a Project Location
Use the interactive map to identify where the project is taking place.
Available location tools include:
| Tool | Purpose |
|---|---|
| Pin | Mark a single location |
| Line | Ideal for roads, trails, or linear projects |
| Rectangle | Define square or rectangular project areas |
| Polygon | Define irregular project boundaries |
Remove a Location Marker
- Select the Erase
- Click the marker or shape you want to remove.
When finished, collapse the location section if desired.
Step 5: Create a Project Timeline
The timeline displays in the project sidebar and helps users track project progress.
Add a Timeline Item
- Select Add Timeline Item.
- Complete the following fields:
Required Fields
- Title
- Percentage Complete
- A value is required.
- Enter 0 if work has not yet started.
- Date
- Description
Timeline Status Options
You can indicate whether the timeline item is:
- Complete
- Current Project Status
A completed phase may also remain identified as the current status when appropriate.
Timeline Best Practice
Use a consistent date format across all projects on your platform.
Step 6: Add Project Content
Select Add Content to build the main body of the project page.
Examples of content include:
- Project Overview
- Project Goals
- Background Information
- Impact Statements
- Construction Details
Accessibility Requirements
Use proper heading structure:
- H2
- H3
- H2
- H3
Avoid skipping heading levels, as assistive technology users rely on heading structure for navigation.
Step 7: Add Content Components
Accordions (Frequently Asked Questions)
Accordions are commonly used for FAQs.
- Add an Accordion Group Title.
- Add one or more Accordion Items.
- Enter:
- Question (Title)
- Answer (Content)
Example questions:
- When will the playground open?
- Will the park remain open during construction?
Cards
Cards are often used as calls to action.
Each card can include:
- Title
- Content
- Image (optional)
- Link URL
Examples:
- Learn More
- View Construction Schedule
- Register for Updates
Single Images
Use this option to display one image within the page content.
You may also add:
- Image caption
Media Galleries
Use Media Galleries to display multiple images.
- Select Add Media Gallery.
- Choose an existing gallery from the dropdown list.
Users can browse through gallery images directly on the project page.
Tiles
Tiles are icon-based links or calls to action.
Add a Tile
- Enter the URL.
- Enter link text.
- Add a Font Awesome icon.
Finding an Icon
- Visit Font Awesome.
- Select an icon.
- Choose the Classic Light
- Copy the HTML code.
- Paste it into the Icon field.
- Keep only the icon class value found within the quotation marks.
Webforms
Web Forms can be embedded directly within the project content.
- Select Add Web Form.
- Choose a form from the dropdown list.
Examples:
- Feedback Forms
- Registration Forms
- Public Input Forms
Step 8: Add Project Contacts
Project contacts allow users to connect with project representatives.
Examples:
- City Planner
- Project Manager
- Contractor
To add a contact:
- Search for the contact name.
- Select the desired contact.
- Repeat as needed.
Multiple contacts can be assigned to a project.
Step 9: Add Related Links
Related Links appear in the project sidebar.
Use them to direct users to:
- Related projects
- External websites
- Supporting resources
- Additional documentation
Step 10: Add Third-Party Embeds
Embeds allow you to display external content such as videos.
Examples:
- YouTube videos
- Promotional videos
- Interviews
Add a YouTube Embed
- Open the YouTube video.
- Select Share.
- Select Embed.
- Copy the embed code.
- Paste the code into the Iframe or Script
- Add a title.
Note: Additional permissions may be required to use embeds.
Step 11: Configure Engagement Opportunities
Projects support several engagement tools.
Surveys
Choose one of the following options:
Webform
Select an existing web form.
Embedded Survey
Embed a survey from another platform.
External Survey Link
Link users to a survey hosted elsewhere.
Participate Section
The Participate section can be used for community engagement activities such as:
- Photo contests
- Idea collection
- Public submissions
- Community feedback
Participation options are connected to web forms.
Project Discussions
To enable comments:
- Open Comment Settings.
- Turn discussions on.
Important Notes
- Comments require moderation.
- Comments are not published immediately.
- Authorized users can:
- Approve comments
- Edit comments
- Delete comments
Step 12: Enable Project Update Notifications
Allow users to subscribe to project updates.
Enable Subscriptions
- Open the Notifications
- Enable Show Email Subscription Form.
Users can now subscribe for project updates.
Send an Update
When updating the project:
- Enable Send Mail Out to Project Update Subscribers Now.
- Enter details about the update.
- Save the project.
Subscribers will receive an email notification.
Step 13: Choose a Moderation State
Create New Draft
Use when work is in progress.
- Visible only to logged-in users with access.
Needs Review
Use when content requires approval before publication.
- Not visible to public users.
Publish
Makes the project publicly available.
- Includes the latest project updates.
Unpublish
Removes the project from public view.
- Hidden from anonymous users.
Step 14: Publish the Project
Once all content has been reviewed:
- Select Publish.
- Save the project.