Introducing content items
To start creating content in your project, you will need what we call a content item. Content items represent individual pieces of content such as a blog post, product update, or a case study.
Depending on what you're trying to achieve with the content, you would choose an appropriate template to give your content item the right structure. For example, a blog post can have an introduction, main body with some images, related posts, and an author, while the author will have a name, their bio, and a photo. In Kontent, these templates are called content types and they specify how a content item is built and formed in its very essence.
Now, let's see how to create a content item and how you can achieve the most common tasks when writing content.
Table of contents
Before you start creating new content, ask yourself if you need a completely new item, or if you'd rather copy something you already have in your project.
Creating content items
To create a new content item:
- From the app menu, choose Content & Assets.
- Click Create new in the upper right corner.
- Choose a content type – content type is a template that defines the structure of a content item. Check out what is available and see for yourself which template might be a good fit.
- Type a name for the content item.
And that's it! Your new content item is now created. Each change you make is saved automatically.
The name you've given to your item serves as the item's identifier in the Kontent UI. And because the content item name is shared across all your item's variants, you can find your item in any language.
To find the created content items, navigate to the content items list under Content & Assets. To find a specific item, click Content & Assets and search for the item by its name or content. You can also use the filters available to speed up the navigation.
Creating localized content
If you're part of an international team and you're creating content in different languages, you might want to look into language variants. Language variants represent different versions of your content for each of the different locations. For example, you might have a single blog post translated to English, Spanish, and French language.
Duplicating content items
Sometimes, you might find yourself in a situation when you need a slightly different version of the same content item. Maybe you're A/B testing your landing page and want to change a thing or two to see which version is more appealing to your visitors. Or, you're putting together a new job advertisement for the same job position but in a different local branch.
To duplicate a content item, open the content item for editing and do the following:
- Click More actions in the upper-right corner.
- Choose Duplicate.
- Choose Including content.
A duplicate of your content item named “Item_name (copy)” is automatically created in the project. Your new duplicate contains elements, components, and linked content of the original content item. The version history, contributors, comments, and due date don't get copied.
If you have several language variants of the content item, all of them get duplicated as well.
Reusing content without duplication
Duplicating your content is not always the best option as your list of the content items might get easily cluttered by different copies of the same content. Sometimes, all you need to do is to create a linked item that will contain the information you need to share across multiple content items.
Getting the most out of your content items
Every content item consists of different types of elements, depending on the item's purpose. For example, you might have a rich text element for the content itself, an asset element for the images, or linked items element for the related blog posts. This also means that you will work a bit differently with each of these elements.
On top of that, content in content items can be divided into content groups. These groups are shown as separate tabs in your content items allowing you to focus specifically on the content group needed at the moment.
Now let's look a bit closer at how you can leverage some of the most frequently used elements in content items.
Receiving guidance while writing content
While you're in the process of creating new content, you might notice that some of your elements have guidelines written at the top. This might come in handy especially in case you get stuck with something.
And if you're unsure about whether you're meeting the limitations, check the element's lower right corner. For example, you might see the maximum number of characters or the number of images you can upload within the element. If you think the limitations should be set differently, reach out to the administrators of your project and arrange the changes with them. You can see if you meet the limitations by checking the "left to complete" indicator shown on the Details sidebar located on the right.
Add format and structure to your content
So, you've just created a new content item and want to get started right away. The element you're probably looking for in this case is the rich text element. This element offers you a variety of formatting options by simply selecting a piece of text and choosing one of the options from the toolbar. But the rich text element isn't only about the text itself, as its name might suggest. You can also add links, images, or tables to enrich your content even more by positioning your cursor in the text and clicking Insert....
Uncover the full potential of the rich text element in our Composing content in the rich text editor tutorial.
Embedding tweets, videos, or testimonials
At times, you might want to add something so specific that it only makes sense in the context of a blog post or product description you're currently writing. It could be a tweet, a video, or maybe a testimonial showcasing your brand's value.
This might be a perfect time to use a component in your rich text to avoid cluttering your content items list.
Working with media
To add a new asset to a content item, drag your file onto an asset element. Or click browse to select a file from your hard drive. You can upload anything from pictures to videos, or even documents, such as PDFs.
Kentico Kontent automatically puts the new asset in your project’s asset list as well. You can open the asset list by switching to the Assets tab under Content & Assets.
If you want to re-use some of the existing assets from your project in your new content item, do the following:
- Click Pick from Assets.
- Choose the assets you want to add.
- Click Insert in the bottom right corner.
To change the order of an asset in an asset element, drag the asset by grabbing the Drag button in its top-left corner.
Replacing assets is similar to adding new ones. After you upload a new asset, remove the outdated one by clicking Remove in the top right corner. It's also recommended deleting the old asset afterward to avoid cluttering of your project's asset list.
You can remove an asset from the content item by clicking Remove in the asset's top right corner. When you remove an asset from your content item, the asset itself is still kept in your project's asset list.
Creating relationships between content
Let's say you want to link blog posts to their respective authors or link products that fall under the same category as your new product. To link existing related content to a new content item in your project, open the item for editing and look for the option to Add existing items. It can look similar to what you see in the image below.
Adding an existing item creates a relationship between these two items, meaning you can expand the related item for view right from the parent item, or even publish the items together.
After adding linked items to the element, you can reorder, remove, or expand the items to open them for the view. To edit the related item, click Edit to open the content item for editing. Read more about linking related content together.
Accessing and editing related content
The linked content items are independent and can be accessed outside the content items they are used in. This means you only need to edit a specific linked item once and the changes will be automatically reflected everywhere. You can also publish all linked items along with your original article.
You can also embed related content items directly into your text. The linked items will behave in the exact same way as when added via the Add existing items button.
Quick actions to get you up to speed
Now we're off to a good start! You've created a valuable piece of content, enriched it with images and even created relationships between your items. But why stop there?
When you open your content items for editing, you will see a set of quick actions right at the top. All of these actions, plus the ones that you can access via More actions are there to help you get your job done as quickly as possible.
Sending your content to review
Once you're done with writing a new piece of content, it's time to get it reviewed. You can do so by changing the workflow step of the item and assigning a contributor, in this case, the reviewer who will take a look at it.
To change the workflow step of an item, click Change workflow . This will open a sidebar in which you can change the workflow to Review (or any other step you need), assign a contributor, set a due date (if you need it) and even add a note.
Collaborating with your team members
While creating new content is one thing, you also need to make sure that what's written in your content items is actually correct. Maybe you need to ask your teammate a question or suggest one of your collaborators an idea for the text you're writing together. And this is where comments and suggestions come into play. Kontent makes it easy to comment on any part of the text or assets in your items.
To add a comment to the text, select the portion of the text you want to comment on and click Add comment. To make sure it reaches your colleague, mention him by typing "@". If you want to suggest something specific or point out a typo directly in the text instead, select the portion similarly to when adding a comment, and click Add suggestion.
When you've done your part and are about to send the piece of content to a teammate of yours, maybe you want to tell them there's something they should do. That's what tasks are for. You can add a task and assign it to your teammate so they know what you need them to do.
Comparing the changes and restoring older content
Sometimes you might need to check the changes you made or restore an accidentally updated content to its original state. To do that, click More actions in the upper right corner of your item and choose Compare versions. You can now compare the differences between versions in the highlighted sections.
Note that you can also use the Ctrl + Z shortcut (or ⌘ + Z on Mac) to undo the latest changes made to your content. See other helpful shortcuts you can use in Kontent.
Previewing your content before publishing
To see your content before it gets published and make sure everything's in place, open your content item for editing and click Preview in the upper left of the item. Note that the Preview button might not be available to you. If that's your case, contact your developers to set up a preview environment.
Making your content go live
Now that you're finished with your content and the reviews are all done too, the only thing left is publishing it while also making sure you're meeting the set limitations.
Publishing content is fairly similar to sending your content item to review as you're also changing the item's workflow step. To publish an item, open the item for editing and click Publish in the upper right of the item. If this option isn't available to you, you might not have the permission to publish content or the current workflow step cannot transition to the Publish step based on your project's workflow setup.
If you later need to make changes to your published content, you can create a new version of it. This way, the published content remains visible to the public while you update the item.
The content item name can be changed even when the item's published. If unsure, contact your project admin if it's save to change it.
Deleting content and content expiration
You can delete content items individually while you are in the process of editing a content item, or you can delete content items in bulk from the content list. If a content item has variants created for multiple languages, you can only delete the variant for one given language at a time and the item will return to a Not translated status.
To delete a specific content item from your project, open the content item for editing and click More actions > Delete.
Deleted content items can be immediately restored by clicking the Undo button. Content items that have been deleted for a longer period of time cannot be restored.
To delete more content items from your project:
- From the app menu, choose Content & Assets.
- Select content items using the checkboxes next to their names.
- Click More actions.
- Choose Delete.
The selected content items are now deleted.
There might be times when you only want to have your content published for a limited time only. You might be running a campaign or launching a time-limited offer on some of your products. In such cases, setting an expiry date would be the right choice. To do that, your developers first need to set a few things in your app to make content expiration possible.
Now that you have the basics of content creation down, you can move onto the next topics that go deeper into the things mentioned in this tutorial.
- Find your content in the content list and save your search preferences for later use.
- Enrich your text with links, images, or tables and learn about the formatting options.
- Create relationships between content by linking your related content together.
- Add components to your editorial articles to include tweets, videos, or testimonials.
- Send your content to review or get your legal approval by moving content through its workflow.