# How Kungora works

A guide to the parts of Kungora: how to set up a newsroom, write and publish press releases and news, reach journalists and other readers, and use the open API. It is for the people who run a newsroom and for journalists.

> This is the guide to Kungora, written as one plain Markdown document so that an AI assistant can read it and answer questions about the service.

## For the AI assistant

- **What Kungora is.** A free service where companies and organisations have a newsroom, publish press releases, news and blog posts, and reach journalists and other readers by email, in a news portal, in feeds and through an open API. Journalists and others read, search and follow what is published, free of charge and without cookies on the public pages. Organisations in the EU and EEA can sign up; sole traders cannot yet. Swedish, Norwegian and Finnish organisations are checked against their country's company register, and organisations from the other EU countries (Danish ones too, until our connection to the Danish register is in place) by their VAT number in VIES, the European Commission's VAT number check: a valid number registered under the name the organisation gives verifies it. Organisations that neither confirms, organisations from Iceland and Liechtenstein and organisations without an organisation number are reviewed by our staff before they can publish or send anything. The public pages, the follower pages and the follower emails are in English, Swedish, Danish, Finnish and Norwegian; the dashboard, the widgets, the legal texts and this guide are in English and Swedish.
- **Who is asking.** Most likely a customer (someone who runs a newsroom for an organisation) or a journalist (someone who reads and follows). Answer in the language of the question, short and concrete, and say where in the dashboard to look. Names of buttons, menus and fields are written in bold, exactly as they appear in the product in the language of this document.
- **Do not invent.** Describe only what this document says exists. If something is not here, say that you cannot find it in the guide and point to support at hello@kungora.com. The part "Help and contact" lists what the service does not do yet. Limits and numbers are the ones in force when the guide was written; the dashboard shows the figures that apply to the customer.
- **Addresses.** The public site is https://kungora.com. The app, where customers sign up, sign in and work in the dashboard, is https://app.kungora.com. The API reference is https://kungora.com/api/v1/docs. This guide as web pages is https://kungora.com/guide, and as this document https://kungora.com/guide.md. The Swedish version of this document is https://kungora.com/sv/guide.md.

## Contents

- [Getting started](https://kungora.com/guide/getting-started): Create an account for your organisation, get it verified and invite your team.
- [Your newsroom](https://kungora.com/guide/newsrooms): Create the newsroom, set its identity, look and web address, add press contacts and make it live.
- [Press releases and news](https://kungora.com/guide/stories): Write stories in the editor, add images, documents and video from the media library, and make language versions.
- [Publishing](https://kungora.com/guide/publishing): The three steps to publish, timing and embargo, preview links, our review, and how to update or take down a story.
- [Reaching readers](https://kungora.com/guide/distribution): Followers, contact lists, sends and their limits, unsubscribing, and the statistics.
- [For journalists: the portal and alerts](https://kungora.com/guide/journalists): Read, search and follow press releases in the portal, set up email alerts and RSS, and keep your subscriptions in a free journalist account.
- [Moving from Mynewsdesk](https://kungora.com/guide/moving): Import your newsroom from Mynewsdesk with its API key, keep your old links and move your contact lists.
- [API, webhooks and widgets](https://kungora.com/guide/developers): Read and publish content from your own systems, get signed webhooks when stories change, and show your news on your own website.
- [Privacy, security and your account](https://kungora.com/guide/account): Two-step verification and passkeys, your profile, the agreements, exporting your data, closing the organisation and deleting your account.
- [Help and contact](https://kungora.com/guide/help): Where to get help, answers to common questions and what the service does not do yet.

## Getting started

Create an account for your organisation, get it verified and invite your team.

### The short way to your first press release

1. [Create an account](https://app.kungora.com/signup) for your organisation and confirm your email address.
2. Sign in, open **Newsrooms** and choose **Create a newsroom**.
3. Describe the company and choose **Make the newsroom live**. If our staff review your organisation, you can do this once it is approved ([below](https://kungora.com/guide/getting-started#manual)).
4. Write a story and publish it ([Press releases and news](https://kungora.com/guide/stories)).
5. Add your company's domain under **Domains**. Once it is verified and its website shows your organisation number (or our staff have checked it), you can email your followers and your own contact lists, and show the newsroom on your own domain.

The rest of this part explains the account, signing in, verification and the team.

### Create an account

Kungora is free. Organisations in the EU and EEA can sign up. Swedish, Norwegian and Finnish organisations are checked against their country's company register. Organisations from the other EU countries are checked by their VAT number in VIES, the European Commission's VAT number check, and so are Danish ones until our connection to the Danish register is in place. Organisations that neither a register nor VIES can confirm, organisations from Iceland and Liechtenstein and organisations without an organisation number are reviewed by our staff before they can publish, send email, invite colleagues or share preview links.

You sign up on the [sign-up page](https://app.kungora.com/signup), in one form:

- **Your account**: your full name, your email address and a password of at least 12 characters. Use your work address: if it is on your company's domain, that domain is verified automatically.
- **Your organisation**: first the **Country** where it is registered (on the Swedish pages Sweden is already chosen), then its number in that country's format: for Sweden the **Organisation number**, 10 digits like 556012-5790; for Norway the **Organisation number (organisasjonsnummer)**, 9 digits like 923 609 016; for Finland the **Business ID (Y-tunnus)**, like 0112038-9; for Denmark the **CVR number**, 8 digits like 24256790. Choose **Look up** to fetch the name, address and status from Bolagsverket, Brønnøysundregistrene or the Finnish Patent and Registration Office (PRH). For the other EU countries you give the **VAT number**, which starts with the country's code (DE for Germany, EL for Greece). **Look up** checks it in VIES and shows the name and address the country's tax authority has registered for it, if it shares them. Give the organisation's name as VIES shows it (capital letters may differ): if the number is valid and the name matches, the organisation is verified at once, unless an organisation that already has an account has that name or gave that number. If VIES shows no name (Germany, for example, never does) or another name, or cannot answer, our staff review the organisation. VIES cannot tell whether a VAT number belongs to a sole trader, so you also tick **The organisation is not a sole trader**. A number VIES does not know as valid cannot be used: check it, or tick **We have no VAT number, or VIES cannot confirm it**. Until our connection to the Danish register is in place, a Danish CVR number is checked in VIES in the same way, and one VIES does not know goes to our staff. For Iceland and Liechtenstein you can give the **Registration or VAT number**; nothing checks it automatically, and our staff review the organisation. If the organisation has no number, or the registry cannot find it, tick **We have no organisation number, or the registry cannot find us**. When the registry does not give the name, type the organisation's full name as it is on its registration document. The company's website is optional and can be added later.
- **Terms**: you accept the customer terms, the privacy policy and the data processing agreement, and confirm that you are authorised to act for the organisation.

We then email you a link that works for 24 hours. Open it, press **Confirm my email address** and sign in. Your account is then active and the organisation is set up, with you as its owner. If our staff review the organisation, it starts under review: upload a registration document under **Verification** ([If we cannot check your organisation in a registry](https://kungora.com/guide/getting-started#manual)).

Some cases to know about:

- A company in reconstruction can sign up; we note it on the account. A company that the registry shows as deregistered, bankrupt or in liquidation cannot. If the registry knows the organisation but cannot confirm its status, our staff review it.
- VIES says only whether a VAT number is valid, not whether the company is bankrupt or in liquidation. We check the number in VIES again regularly. If VIES no longer confirms it, in two checks at least 20 hours apart, the same applies as when a register shows that a company has been deregistered, and sending stays paused until our staff have reviewed it.
- Sole traders cannot sign up yet, in any country.
- If the organisation already has an account, the form says so. Choose **Ask for access**: we email the account's owner and admins with your name and email address, and they can invite you. You can also ask them to invite you directly.
- If someone invited you, open the link in the invitation. Sign in, or create an account if you have none (there is no organisation form then), and choose **Accept and join**. You get the role you were invited to.

### Sign in

You sign in on the [app](https://app.kungora.com/login) in one of three ways:

- With your email address and password.
- With a passkey (your fingerprint, face or device PIN): choose **Sign in with a passkey**.
- With an email link: choose **Email me a sign-in link instead**. The link works for 10 minutes. It is not available if your account has two-step verification, which then needs the password.

If you forget your password, choose **Forgot your password?**. The reset link works for one hour, and a new password signs you out on your other devices.

With two-step verification you also enter the six-digit code from your authenticator app, or one of your backup codes. You set it up under **Security** in the menu ([Privacy, security and your account](https://kungora.com/guide/account#security)).

After you sign in you land in your organisation. If you belong to more than one, you see the list of organisations first. **Your account** at the bottom of the menu holds your profile, security and notifications, and **My subscriptions** is the area for the newsrooms and searches you follow yourself ([For journalists](https://kungora.com/guide/journalists)).

### Verification and what it unlocks

Kungora checks who is behind a newsroom. The check has levels, called tiers. The **Overview** of your organisation shows your tier, your status, what the registry or VIES says and a list of next steps, each marked done, to do, waiting or needs attention.

| | Tier 0 | Tier 1 |
|---|---|---|
| What has been checked | Your email address is confirmed, and the organisation is active in its country's company register, confirmed in VIES with its VAT number and name, or approved by our staff | Tier 0, and a verified domain whose website shows the organisation number, or that our staff have checked |
| Newsroom | Create it and publish in it | The same, with the marks "Verified company" and "Verified domain" |
| Stories published a day | 5 | 50 |
| Email | Test emails to your own team | Emails to your followers and your own contact lists, within the sending limits |
| Your own domain for the newsroom | No | Yes |
| Media storage | 1 GB | 10 GB |

These are the limits today. The **Overview** shows the ones that apply to your organisation, including how many recipients you may reach per send and per day.

The status next to the tier says how much we trust the organisation yet. A new organisation has its first three press releases reviewed by our staff before they are emailed ([Publishing](https://kungora.com/guide/publishing#review)). An organisation can also be under review, restricted or suspended; the **Overview** says so, and what to do next. An organisation under review can set up its newsroom and send tests to its own members, but until our staff have approved it, it cannot make a newsroom live, publish, send email to anyone else, invite colleagues, create preview links, share statistics links, add webhooks or custom domains, start a Mynewsdesk import or confirm an address for email replies. We email you when the review is done.

### Verify your domain

1. Open **Domains** under **Settings** and add your company's own domain, for example example.com. Email providers such as Gmail and Kungora's own domains are refused.
2. If your email address is on that domain, it is verified at once. Otherwise publish the code we show, in one of three ways: as a DNS TXT record, as a text file at a given address on your website, or as a meta tag in the head of the page we name. We check automatically for 72 hours, and you can choose **Check now**.
3. When the domain is verified we look for your organisation number on the website, for example in the footer or on the contact page. If we cannot find it, our staff review it by hand. For now the automatic search recognises only Swedish organisation numbers, so for an organisation from another country, or one without a number, our staff always check the website.
4. Keep the proof in place. We check the domain again once a month. If the code is gone and nobody in the organisation has a confirmed email address on the domain, the verification and the "Verified domain" mark are removed.

### If we cannot check your organisation in a registry

Our staff review an organisation before it can publish when its registry does not know it or cannot confirm its status, when VIES confirms its VAT number but not its name or cannot answer, when it is Danish and VIES does not confirm it (until our connection to the Danish register is in place), when it is from Iceland or Liechtenstein, and when it signed up without an organisation or VAT number. Open **Verification** and upload a registration document: a PDF, JPEG or PNG, for example an extract from the company register or an official certificate from a tax, statistics or other public authority. Our staff review it, usually within one working day, and we email you when the review is done. Meanwhile you can prepare the newsroom and send tests to your own members. Once the organisation is approved, the newsroom can go live and you can publish, invite colleagues and share preview links.

### Organisation details

**Organisation details** shows the organisation's name and number and what its company register says: for a Swedish organisation the legal name, legal form, address and industry codes from Bolagsverket, for a Norwegian, Finnish or Danish one the name and the registration status; for one verified in VIES the VAT number, the name VIES returned and whether the number is valid. They cannot be edited here; **Check the registry again** fetches them anew (for organisations with a number in Sweden, Norway, Finland or Denmark; for Denmark once our connection to the Danish register is in place). We check a VAT number in VIES again by ourselves, regularly. An organisation our staff approved without a registry shows the name it gave. Admins can add data protection contacts (a data protection officer and a privacy contact email), which are shown to people who contact you about personal data.

### Your team and roles

Every account has three roles, set per organisation. There is always exactly one owner.

| What | Who can do it |
|---|---|
| Write, edit, schedule and publish stories; upload media; work with contacts and lists; send exclusively and send tests; see the newsrooms, the followers and the statistics | Every member, admin and owner |
| Create newsrooms and change their settings, press contacts and boilerplates; make a newsroom live; manage domains, verification, users, security, webhooks, API keys (members can read the list), import and data export | Admins and the owner |
| Change roles and remove admins, hand over ownership, close the account, unpublish or delete a newsroom | The owner only |

There is no approval step: any member can publish a story.

Under **Users** an admin or the owner invites people as members: we email a link that works for 48 hours, and you can withdraw it before it is used. An organisation that our staff are still reviewing cannot invite anyone until it is approved. Only the owner invites someone as an admin, changes roles or removes an admin; an admin removes members. **Requests for access** lists people who tried to register your organisation and asked to join. We have not checked who they are, so invite only someone you recognise. **Transfer ownership** makes another member the owner and you an admin.

Under **Security** an admin or the owner can require two-step verification for every member. A member who has not set it up must do so before opening the organisation.

## Your newsroom

Create the newsroom, set its identity, look and web address, add press contacts and make it live.

### What a newsroom is

A newsroom is your organisation's page on Kungora: its press releases, news and blog posts, images, videos and documents, its press contacts and a button to follow it. Everything you publish there is also found in the portal's stream, search and subject and region pages, and in the RSS feeds, once our staff have approved your first stories ([Publishing](https://kungora.com/guide/publishing#review)). Stories from companies in the Swedish company register are also on the industry pages, by the company's NACE/SNI codes. An organisation can have up to five newsrooms.

A newsroom has a status: **Being set up** (hidden), **Live**, **Suspended** (stopped by our staff), **Unpublished**, **Closed** or **Deleted**.

### Create a newsroom

Admins and the owner create a newsroom under **Newsrooms**, with **Create a newsroom**. The form asks for the newsroom's identity (see below) and its web address, and is filled in with your organisation's name and, for a Swedish company, its address and description from the company register. The newsroom stays hidden until you make it live.

The web address is 3 to 63 lower-case letters, digits and hyphens, and it cannot look like a language code or be a reserved word. It becomes two addresses, for example kungora.com/your-address and your-address.kungora.com. The form tells you at once if the address is taken.

### Make the newsroom live

The newsroom's **Overview** has a checklist: describe the company (**Identity**), choose brand colours (**Branding**), choose default topics and regions, add a pinned press contact and write the boilerplate. It shows how far you have come, in percent. You do not have to finish it: you can go live at any time with **Make the newsroom live**, and from then on every story you publish appears on it at once.

An admin or the owner makes the newsroom live. It cannot go live while the organisation is under review, restricted or suspended. Our staff review an organisation before it can go live when we cannot check it in a company register: the register does not find it or cannot confirm it, its country has no register we read (we read those of Sweden, Norway and Finland, and Denmark's once our connection to it is in place), or you signed up without an organisation number. Until we have approved it you can prepare the newsroom, but you cannot make it live, invite colleagues, create preview links or confirm an address for email replies ([Getting started](https://kungora.com/guide/getting-started#manual)). A newsroom is not indexed by search engines until our staff have approved your organisation's first story ([Publishing](https://kungora.com/guide/publishing#review)).

### Identity

Under **Identity** you set what readers see about the company:

- the newsroom's name, usually the company's name as readers know it;
- a headline and a description of a few sentences, shown on the home page;
- the website, the address and up to 10 footer links, for example to the company's site or social media;
- the language of the newsroom's pages (menus and labels): English, Swedish, Danish, Finnish or Norwegian, and the default language of new stories.

### Change the web address

Under **Identity**, **Change the web address** changes the newsroom's address. The address can change at most three times in 30 days. When the newsroom is live, anyone who opens a page at the old address is sent on to the same page at the new one (also on the subdomain), and no other newsroom can take the old address. While the newsroom is being set up nothing is kept, and another newsroom can take the old address at once. Domains you have connected to the newsroom are not affected. If you need more changes, write to hello@kungora.com.

### Branding: colours, typeface, logo and icon

Under **Branding**:

- **Main colour** is used for buttons, lines and links, and **Second colour** for details. A colour that is too light to read gets a darker link colour automatically, so every link keeps a contrast of at least 4.5:1.
- **Typeface**: **Classic** (headlines in Newsreader, text in Instrument Sans), **Sans-serif** or **Serif**. The typefaces are served from our own server, so no reader contacts anyone else.
- **Background colour**: a light colour behind the content. It must be light enough for the text to stay readable.
- **Media layout**: **Grid**, **Large pictures** or **List**, for the newsroom's lists of images, documents and videos.
- **Logo and icon**: choose images from the media library or upload new ones. The logo is shown at the top of the newsroom and in search results; a PNG or WebP with a transparent background works best, at least 64 pixels wide. The icon is the small square image in the browser tab, at least 64 by 64 pixels, and shows on the newsroom's own subdomain and your own domains. Before an image can be chosen you must confirm on its page in the media library that you have the right to publish it. A change shows on the newsroom within a few seconds.

### Press contacts

Under **Press contacts** admins add the people journalists can call. For each contact you give the name, title, area of expertise, email, phone, a photo (it needs a photographer or credit and confirmed rights) and links such as a LinkedIn profile. You choose per contact whether the email address and the phone number are shown on the public pages, and whether they are also given out in the open API; only a detail that is public can be in the API.

**Pin this contact** shows the contact on the newsroom's home page and adds it to new stories. A press release needs at least one press contact ([Press releases and news](https://kungora.com/guide/stories#writing)).

### Boilerplates

A boilerplate is the short text about the company at the end of a press release. Under **Boilerplates** admins write one or several and mark one as the default, which is added to every new press release. In the editor you can choose another one or none. Changing a boilerplate later does not change stories that already use it.

### Topics, regions and licence

- **Topics and regions**: the default topics and regions of new stories, up to 10 of each. They help journalists and followers find your stories, and they place the stories in the portal's subject and region pages. Regions cover every EU and EEA country: your own country is open first, down to its municipalities; open another country to choose among its regions, or type to filter. A story without a region is on no region page.
- **Licence**: the default licence of your images and documents, which tells journalists how they may use them. The choices are free editorial use with the photographer credited, Creative Commons Attribution 4.0 (CC BY 4.0), the public domain dedication CC0 and all rights reserved (no download). You can choose another licence for a single file in the media library.

### Templates

A template is a story to start from: headline, lead, topics, regions, categories, links, boilerplate and text. In the editor, under **More for this story** below the text, you choose **Save as template**. Under **Templates** you rename, describe and delete templates and preselect one for new stories of a type. A template can be available in one newsroom or in all the organisation's newsrooms.

### Email replies

Email from the newsroom is sent from Kungora's address. Under **Email replies** you choose where replies go: an address of yours that has confirmed it may receive them. We send a link to that address, and it is used once someone has opened the link (it works for seven days). Without a confirmed address, replies to your sends go to your pinned press contact, and replies to the digests your followers get reach nobody. Admins and the owner choose the address, and only once we have approved your organisation: while it is under review, restricted or suspended, no confirmation link can be sent.

### Your own domain

Under **Custom domain** the newsroom can be shown on your own address, for example press.yourcompany.com, with the same pages and links as on Kungora. This needs tier 1 ([Getting started](https://kungora.com/guide/getting-started#verification)), and a newsroom can have up to five custom domains.

1. Enter the domain. A subdomain such as press.yourcompany.com with a CNAME record is recommended. The bare domain, for example yourcompany.com, works with A and AAAA records, but then all of it shows the newsroom instead of your website.
2. Create the DNS records the page shows, at the company that manages your domain's DNS. The page has copy buttons and a text to send to your IT department. If you use Cloudflare, set the record to DNS only. If the domain has CAA records they must allow letsencrypt.org and sectigo.com.
3. We check the records automatically, and you can choose **Check press.yourcompany.com now**. When they are right, the domain is verified and you can preview it.
4. Choose **Activate press.yourcompany.com**. We get an HTTPS certificate, which usually takes less than a minute, and the newsroom opens on the domain.
5. You can make the domain the canonical address, the one search engines index, and choose whether the links in your emails and shared posts lead to your own address or to Kungora.

We check the records every day. If they stop pointing here you keep a period of grace, and then the domain stops showing the newsroom until it is verified again. If you move from Mynewsdesk, the same page guides the change ([Moving from Mynewsdesk](https://kungora.com/guide/moving)).

### Unpublish or delete a newsroom

Only the owner can unpublish or delete a newsroom, under **Unpublish or delete**. It can be unpublished, which sends visitors to a website of your choice and takes the images and files off the web (the drafts stay, and you can publish it again later), or deleted, where the pages say the content has been removed. What you choose takes effect 7 days after you confirm, and you can cancel until then. Make a data export first ([Privacy, security and your account](https://kungora.com/guide/account#export)). Drafts and files of a deleted newsroom are deleted for good 30 days after it takes effect. The web address of a newsroom that was live stays held after it is removed, until our staff release it, and the newsroom counts toward the limit of five for 90 days. A newsroom that was never live gives up its address at once and does not count.

## Press releases and news

Write stories in the editor, add images, documents and video from the media library, and make language versions.

### The kinds of story

A newsroom publishes four kinds of story. The editor writes three of them:

- **Press release**: formal news such as launches, hires, results and awards. It gets the boilerplate and needs at least one press contact.
- **News**: shorter updates for a broader audience.
- **Blog post**: more personal posts.
- **Event**: shown in the newsroom under Events, but not yet written in the editor. Events arrive with a Mynewsdesk import ([Moving from Mynewsdesk](https://kungora.com/guide/moving)).

Under **Stories** in the newsroom you see all stories with their type, status and language, and you can filter by type and status. The statuses are **Draft**, **In review**, **Scheduled**, **Published**, **Unpublished**, **Archived** and **Could not be published**.

A story is not meant for inside information. Inside information (MAR article 17) and regulated information must go through a regulatory news distributor, not Kungora. Before a story can be published, you confirm in the editor, under **Inside information**, that it contains neither. If your company is listed on a stock exchange, the editor also reminds you of this.

### Write a story

Choose **Write a story** under **Stories**. You choose the type, the language the story is written in and, if you have one, a template, and then **Start writing**. A draft is saved automatically as you type; the editor shows when the last save was made, and **Save now** keeps a revision at once.

The editor has these fields:

- **Headline** (also the subject of the email to followers) and **Lead**, one or two sentences that are also used in search results and on social media.
- **Text**, with a toolbar for headings, bold, italic, lists, links, quotes (also with the name and title of the person quoted), fact boxes, tables, images from the media library and video or audio from YouTube, Vimeo, Dailymotion or SoundCloud. Press Alt+F10 to reach the toolbar with the keyboard. Every image in the text needs an alternative text.
- **Information type**: what kind of information the story contains.
- **Topics** and **Regions**, as defaults from the newsroom ([Your newsroom](https://kungora.com/guide/newsrooms#topics)).
- **Press contacts** (a press release needs at least one), a **Boilerplate**, **Categories**, **Links** and **Related stories**.
- **Header image**, **Related media** and **Documents for download**, all from the media library. The header image must be at least 1000 pixels wide, and 1280 by 720 pixels or larger in landscape works best. Documents for download are never attached to emails.
- Under **Advanced settings**, **The original is at**: if the text first appeared on another website, give its address and search engines show that page as the original.
- If the text was written with the help of AI, tick it and confirm that a person has reviewed it.

**Save as template**, under **More for this story** below the text, turns a draft into a template for later stories ([Your newsroom](https://kungora.com/guide/newsrooms#templates)). A story also keeps its revisions ([Publishing](https://kungora.com/guide/publishing#revisions)).

### Language versions

A story can exist in several languages. Under **More for this story** below the text in the editor you pick the language under **New language version** and choose **Create language version**, and then write the same story in the other language; the versions are then listed beside the text under **Language versions**. Versions that are published together are one story: each follower gets one email, in their own language if the story has a version in it, otherwise usually in the newsroom's default language of new stories. The language of a story cannot change once it is published.

### The media library

The newsroom's **Media** page holds the images, documents and videos you use in stories and in the public media archive. Files are private until you publish them in a story or to the archive.

- **Upload files**: drag files into the page or choose files. You can upload up to 50 files at a time, each at most 100 MB. Images are JPG, PNG, GIF, TIFF or WebP and at least 64 pixels wide. Documents are PDF, Word, Excel or PowerPoint. Documents with macros, password-protected documents and PDFs with scripts are not accepted. Every file is checked for viruses, and a file that is blocked cannot be used.
- **Video**: choose **Add a video** and paste a link to a video on YouTube, Vimeo or Dailymotion. The video plays at the video service, never from Kungora; we fetch its title and a preview image.
- **Storage**: the page shows how much of your organisation's storage is used. It is 1 GB at tier 0 and 10 GB at tier 1 ([Getting started](https://kungora.com/guide/getting-started#verification)).

Open a file to describe it and set its rights:

- **Title** and **Description**, shown on the public media page.
- **Alternative text** for an image, which is required unless you say the image is decorative.
- **Photographer or credit**, which is required for images, and **Copyright holder**.
- **Licence**: the newsroom's default or another one; it decides whether journalists see a download button.
- A tick that confirms that you have the right to publish the file, and that people who can be identified in it have agreed. A file cannot be published without it.
- **Publish to the newsroom's media archive** gives the file a public page of its own. A file used in a story is public through the story either way.

Images can be cropped (16:9, square or free) without touching the original. **Replace the file** uploads a new version that keeps the title, description and rights; links to the old version keep working for 30 days, or you can remove the old version at once. You can delete a file; if it is used in stories you must confirm, and published stories keep showing it until they are updated.

The library lists where each file is used and shows whether it is published, in use or private.

### What readers see

A story gets a page of its own with the sender clearly named together with the organisation number and the verification marks, the press contacts, the images with their licence and credit, and ways to share it. It also appears in the newsroom's lists, in the portal's stream and search, and in the RSS, Atom and JSON feeds ([For journalists](https://kungora.com/guide/journalists), [API, webhooks and widgets](https://kungora.com/guide/developers)).

## Publishing

The three steps to publish, timing and embargo, preview links, our review, and how to update or take down a story.

### The three steps

You publish a story in three steps, shown at the top of each page: **Write**, **Distribution** and **Summary**. Choose **Continue to publishing** in the editor to start.

1. **Write**: the text, the images and the rest of the story ([Press releases and news](https://kungora.com/guide/stories#writing)).
2. **Distribution**: who should receive the story, and when it is published.
3. **Summary**: what will happen. Here you confirm with **Publish now**, **Schedule the story** or, for a story that is already published, **Publish the changes**.

Any member of the organisation can publish. There is no approval step.

### Before you can publish

The page lists **Before you can publish**: what blocks publishing, and what is worth checking. You find these, among others:

- a headline, a lead and a text, and an information type;
- at least one press contact on a press release;
- an alternative text for every image, a photographer or credit, and the confirmation of the right to publish each image and file in the media library;
- a header image that is at least 1000 pixels wide;
- the confirmation that the story holds neither inside information nor regulated information;
- a confirmation that a person has reviewed text written with the help of AI;
- that the newsroom is live, and that the organisation is not restricted and has not reached its daily limit of published stories ([Getting started](https://kungora.com/guide/getting-started#verification)).

A company that the registry shows as deregistered, bankrupt or in liquidation cannot publish. Each problem links to the place where you fix it. What an image or file lacks (alternative text, photographer or credit, the confirmation of the right to publish it) you fill in on the same page, in the form under the list, with its thumbnail and name; **Open in the media library** is there for everything else. When everything is in place the page says so.

### Who receives the story

Under **Distribution** you choose **Who should receive the story?**:

- **Publish in the newsroom and email the newsroom's followers**, or
- **Publish in the newsroom only, without emailing followers**.

At tier 0 stories can only be published in the newsroom. At tier 1 you can also choose among **Your contact lists**, your own lists, which get the whole story by email: one email per person, even if the person is on several lists or also follows the newsroom. The page estimates how many get the story, in which languages, and how many are left out because they unsubscribed, bounced or marked email as spam. It also shows your sending limits and what is left today ([Reaching readers](https://kungora.com/guide/distribution#limits)).

An update to a story that is already published never sends email. A language version is not emailed if another version of the same story has already been sent.

### When the story is published

- **Now**: as soon as you confirm, or when the embargo ends.
- **At a chosen time**: the story stays editable until then, and the latest version that passes the checks is published. The time is Swedish time (Europe/Stockholm) and must be within a year. The story shows as **Scheduled**; choose **Unschedule** to change the time. If it no longer passes the checks when the time comes, it is not published, and the page shows what to correct.
- **Backdated**: published now with an earlier date. More than 48 hours back, no email is sent. A backdated story cannot have an embargo.

An **Embargo** keeps the story and its files private until the time you give. Nothing is public before then, and the story page shows the embargo to anyone with a preview link.

In the distribution step, and for a story that is already published beside the text in the editor, you can also **Mark as top news** (a newsroom can have at most five, shown first on its front page) or **Hide from the front page** (the story stays in the archive and the lists).

### Preview links

A preview link shows a story before it is public, for example to journalists under embargo. Under **Preview links**, a link beside the text in the editor, you give the link a name, optionally note the recipient's email address (nothing is sent to it), and set how long it is valid, in Swedish time. Unless you choose otherwise, a link is valid until 24 hours after the embargo ends, or for 7 days if the story has no embargo, and never more than 14 days. Copy the link at once: it is shown only once. Every view is logged, with time, network and browser, and you can **Revoke** a link at any time. Preview links can only be made once we have approved your organisation: not while it is under review, restricted or suspended.

### Our review of the first releases

Kungora reviews the first stories of a new organisation by hand, until three releases have been reviewed. Meanwhile:

- the story gets its own page at once, but search engines do not index it, and it is not in the portal, its search or the feeds until our staff have approved it. Once your newsroom has an approved story, a story under review is also left out of the newsroom's lists until it is approved;
- the email to followers and lists waits until our staff have reviewed the story, and goes out if they approve it;
- the distribution step says that your first stories are reviewed, and the story list marks the story **first-release review**.

We also run content rules over every story. A rule can **block** a story, for example because of a link through a URL shortener: it cannot be published until you remove the problem, or until our staff have reviewed the block. If you think a rule was wrong, choose **Request a review**; a person on our staff reads this version and decides, and you and the organisation's owners and admins get the decision by email. A rule can also **hold** a story for review, for example election campaign material: it is published without search-engine indexing, and the email waits.

If we remove a story because it breaks the rules or the law, you get an email with the reasons and a link to appeal. The Digital Services Act rules for reports and appeals are on the [DSA page](https://kungora.com/dsa).

### Update, correct or take down a story

- **Update**: open a published story, change it and choose **Publish the changes**. The newsroom shows the change within a few seconds. No email is sent for an update.
- **Unpublish**: choose **Unpublish…** under **More for this story** below the text in the editor. It is removed from the newsroom, and its address answers that the story has been removed. You can tick that every language version is unpublished. You can publish the story again later; no email is sent then.
- A story that could not be published, with the status **Could not be published**, says why: something required was missing when it was about to go out, the organisation had reached its daily limit, or a technical fault stopped it. Correct it and publish again.

Under **Report** for a story you see its views and emails ([Reaching readers](https://kungora.com/guide/distribution#statistics)).

### Revisions

A story keeps its revisions. One is kept when you choose **Save now**, every five minutes of editing, when the story is scheduled or published, and when you restore an older one. Under **Revisions**, a link beside the text in the editor, you compare a revision with the current text and restore it. Restoring makes it the newest revision, and nothing is lost.

## Reaching readers

Followers, contact lists, sends and their limits, unsubscribing, and the statistics.

### Three ways to reach people

- **Followers**: people who chose to follow your newsroom. They get your published stories by email.
- **Your own contact lists**: journalists and others you have added yourself. They get stories you publish to a list, or stories you send exclusively.
- **The portal and the feeds**: everything you publish is also found in the portal's stream and search, in the RSS, Atom and JSON feeds and in the open API, whether or not anyone follows you.

Emailing followers and lists needs tier 1 ([Getting started](https://kungora.com/guide/getting-started#verification)).

### Followers

A reader follows a newsroom with the follow form on its pages: they give their email address, tick that they accept the terms of use and have read the privacy policy, and can say that they are a journalist. We send a link to confirm, and it works for 24 hours; nothing is sent to them until they confirm. A reader with a journalist account follows with the account and needs no confirmation email ([For journalists](https://kungora.com/guide/journalists)).

The newsroom's **Followers** page shows how many follow the newsroom and lists the confirmed followers, newest first; under **Contacts**, **Followers** lists the followers of all your newsrooms. You see their email addresses, their name if they have given one, and whether they are journalists, because they were told so when they followed. You cannot remove or export followers: they stop following with the link in every email. Followers get a story in their own language when the story has a version in it, otherwise usually in the newsroom's default language of new stories.

Every Monday you can get an email with the number of new followers per newsroom, if you want it. Turn it on or off under **Notifications** in your account menu.

### Contacts and lists

**Contacts** holds your own press contacts and lists. Only the members of your organisation see them, and they are used for nothing but your own mailings.

- **Add contact** adds one person: name, email, title, company or outlet, phone, language, tags and the lists the contact is on. You choose the **lawful basis** of the mailing, which is why your organisation may send press material to this person: **Legitimate interest** (a journalist or someone who works with your topics, at a work address), **Consent** (the person asked for your news) or **Existing customer relationship**. A private address, such as Gmail, needs consent or an existing customer relationship. You confirm that your organisation may send to the person and will stop as soon as the person asks.
- **Import** adds many at once from a spreadsheet (Excel XLSX or XLS, OpenDocument ODS, CSV or tab-separated text) or from pasted addresses, up to 100,000 rows. You check the columns before anything is imported. Exports of contacts from Mynewsdesk and Cision are recognised. You choose a list, the lawful basis and confirm your right to send. Rows without a valid email address, repeated rows and addresses that have unsubscribed from your organisation or from all email on the platform, or that bounce, are skipped, and you get a report of them to download. Columns with sensitive personal data, such as health, religion, political views or union membership, are blocked and never imported.
- **Lists**: group the contacts, for example trade press or local newspapers. A list is visible to everyone in the organisation or only to the person who made it. You choose the lists when you send a story. In the table you can select contacts and **Add to list**, **Remove from list**, **Edit lists…** or **Delete…**.
- **Search and filter**: by name, email, title or outlet, by list, tag and status. A contact is **Active**, **Unsubscribed**, **Bounced** or **Marked as spam**; only active contacts get email.
- **Export**: the contacts that match your filter as CSV or Excel. The file is kept for seven days.

A contact's page shows its details, the emails sent to it and, where it is recorded, whether they were opened or clicked. If a person asks you to stop emailing, open the contact and choose **Stop all email to this contact**: the address then stays blocked for your organisation, even if the contact is deleted or imported again. To delete contacts for good, including their addresses in the sending records when a person has asked you to erase their data, use **Delete…**.

### Send a story

When you publish a story you decide who gets it by email ([Publishing](https://kungora.com/guide/publishing#audience)). The email carries the whole story and a link to it, and every email has an unsubscribe link. The sender is the newsroom, and replies go where you set them ([Your newsroom](https://kungora.com/guide/newsrooms#email-replies)).

Under **Sends** in the organisation's menu you see every email the organisation has sent: publishing to followers and lists, exclusive sends and test sends, newest first, with their status: **Planned**, **Held for review**, **Preparing**, **Sending**, **Sent**, **Cancelled** or **Failed**.

- **Send exclusively** emails one or more stories to chosen lists and contacts without publishing them: for a pre-brief, for proofreading or to add recipients later. A story that is not published goes as a personal preview link for each recipient; a published one goes as a link to the story. You may add a subject, a personal message in plain text, and up to 50 new addresses at once, which are added to your contacts (you give the lawful basis and confirm that you may email them). You can send now or at a set time. It never counts as publishing and needs tier 1.
- **Send a test** emails the story to members of your organisation with a confirmed email address, so you see exactly what recipients get. A test is marked TEST, goes only to members and never counts against your limits. It is available at every tier.

Open a send to see its record: the stories, the subject, who it went to, the counts of recipients by type and status, and, within about ten minutes after the send, delivery and reading figures: delivered, opened, clicked, bounced, marked as spam and unsubscribed. Opens are counted in total only, and mail apps that load images automatically inflate them, so clicks are the better measure. Followers' and subscribers' figures are shown only in total and only for groups of a minimum size, so that nobody's behaviour is singled out. A send that has not started can be cancelled from its page with **Cancel the send**.

### Limits and holds

Sending is limited to protect readers and the deliverability of everyone's email. At tier 1 an organisation can reach up to 2,000 recipients per send and 10,000 per day. Your **Overview** and the distribution step show the limits that apply to you and what is left today. Some other rules:

- **Held for review.** A send is held, and nothing is sent until our staff have looked at it, when: it is one of the first stories of a new organisation ([Publishing](https://kungora.com/guide/publishing#review)); it has more recipients than one send may have; it would take the day's total over the limit; sending is paused for the organisation; a content rule asks for a review; or our staff stopped it. The whole email is held, never a part of it. The story is still published in the newsroom.
- **Spam complaints.** If many recipients mark your email as spam, your limits are halved for a time, and in a serious case sending is paused for the organisation.
- **The platform's own daily limit.** The number of emails Kungora can send in a day follows what our email provider allows. When the limit is reached, a send waits and continues the next day, and a large send can take more than one day; nobody gets an email twice.

### Unsubscribing and email settings

Every email from a newsroom has an unsubscribe link. It opens a page where one press of a button ends the emails from that sender, with a second choice to stop all email from Kungora. A person can also write to Kungora's opt-out address. An address that has unsubscribed gets no more email from that sender.

A reader can also open their [email settings](https://app.kungora.com/preferences), which sends a link to their address ([For journalists](https://kungora.com/guide/journalists#settings)): turn off single senders or all email, manage subscriptions, download a copy of their data or have it deleted. Email about someone's account and its security is still sent.

### Statistics

The newsroom's **Analytics** page shows how the newsroom is read and what its emails did. It is measured without cookies and without storing IP addresses; a visitor is recognised within one day only, so someone who returns on another day counts again. The figures are updated every ten minutes.

- **At a glance**: views in the last 7 and 30 days, the average visit and the followers.
- **Period**: last 7, 30, 90 or 365 days, since publication or your own dates (at most 366 days, from 1 January 2026).
- **The period in figures**: views, visitors, average visit, downloads of images and files, emails sent, email opens and clicks, and views by bots, which are never counted as views.
- **Views per day**, **Views per week** and **Views per month** as charts, always with a table of the numbers.
- **Traffic sources**, **Referring websites** (shown when visitors from at least three networks came from a site on the same day), **Devices**, **The 10 most viewed stories**, **Most downloaded media** and the countries of the latest visitors.
- **Export**: the period per day or per story as CSV.
- **Share without login**: an admin can create a read-only link to the web statistics, valid for 1, 7 or 30 days. It shows no followers and no email figures.

For one story, **Report** shows its views per channel and its emails.

## For journalists: the portal and alerts

Read, search and follow press releases in the portal, set up email alerts and RSS, and keep your subscriptions in a free journalist account.

### Read and search without signing in

The [portal](https://kungora.com/) on the public site shows the latest press releases, news and blog posts from every newsroom, newest first. Reading is free, needs no account and sets no cookies.

- **Browse** by subject, region, industry (NACE/SNI) or type of release, from the menu: **Subjects**, **Regions**, **Industries** and **Release types**.
- **Search** finds press releases, news, blog posts and events from every newsroom. Put an exact phrase in quotes ("new CEO"), write OR between alternatives (solar OR wind) and put a minus before a word to leave it out (energy -nuclear). You can sort by relevance or newest first.
- **Filter** a list by type, information type, date (today, the last 7 or 30 days or your own dates), language, and whether the release is regulatory information.
- Every release names its sender, with the organisation number where it has one. The mark **Verified company** means that the organisation has been checked against the company register of its country or by our staff, and that it has verified its web domain. Every image shows its licence and, where given, its photographer. The press contacts on a release are there for your questions about it.

### Follow by email, RSS or the open API

- **Follow a newsroom**: use the follow form on its pages. Give your email address, tick that you accept the terms of use and have read the privacy policy, and say if you are a journalist. We email a link to confirm; it works for 24 hours, and nothing is sent until you confirm. The newsroom sees your email address, your name if you gave one, your language and whether you said you are a journalist.
- **Get a selection by email**: on the search page use the form **Get new results for this search by email**, and on the page of a subject, a region, an industry or a type the form with the page's name, for example **Get Environment and energy by email**. Pick how often (straight away, once a day or once a week), choose **Subscribe** and confirm with the link in the email.
- **RSS**: every selection, hub and newsroom has an RSS feed, and the portal as a whole has one, and a JSON Feed too. Newsrooms also have Atom and JSON Feed.
- **The open API** gives developers the same content ([API, webhooks and widgets](https://kungora.com/guide/developers)).

Every email can be ended with one click.

### A free journalist account

You do not need an account to read, search or get alerts by email. A journalist account keeps your follows, alerts and saved searches in one place and lets you follow without a confirmation email. It cannot publish anything.

[Create a journalist account](https://app.kungora.com/signup/journalist): your name, email address and a password of at least 12 characters, optionally your outlet, its website, your job title, beats (the subjects you cover), regions and languages, and your acceptance of the terms of use. We email a link to confirm the address, and then you sign in. To publish press releases you create an account for your organisation instead ([Getting started](https://kungora.com/guide/getting-started#account)).

After you sign in, **My subscriptions** is your area:

- **Overview**: the newsrooms you follow, the topics, regions and keywords, the saved searches and your profile.
- **Newsrooms you follow**: set how often and what each email shows for every newsroom, stop following, or follow again. To follow another newsroom, open it on the portal and choose **Follow with your account**.
- **Searches and alerts**: search the portal, choose **Save in your account**, give the search a name and decide if you want an email when something new matches. You can also follow a **subject**, a **region** or a **keyword** directly, one of the three at a time; a keyword is searched in headlines, leads and texts. Each saved search has its own RSS feed.
- **Journalist profile**: your outlet, beats, regions and languages, the defaults of new subscriptions, and your privacy choices (not to be profiled, not to be suggested to organisations, not to have opens and clicks measured).

For each follow or alert you choose **how often** (straight away, once a day or once a week) and **what each email shows**: the headline only, the headline and lead, or the full text. Emails sent straight away show at most the headline and lead; the full text comes in the daily and weekly summaries.

You can sign in with a password, a passkey or an email link, and turn on two-step verification ([Privacy, security and your account](https://kungora.com/guide/account#security)).

### Email settings for anyone who gets email

Everyone who receives email through Kungora can manage it at the [email settings](https://app.kungora.com/preferences) without an account: enter your address and we send a link that works once, for 24 hours, and keeps you signed in for an hour. There you can:

- turn off email from a single sender under **Senders**, which also ends your following of its newsrooms;
- choose **Stop all email from Kungora** and turn it on again (email about an account and its security is still sent);
- change **Your subscriptions**: how often, what each email shows, or stop them;
- choose your settings under **Privacy**, including whether the newsrooms you follow see you as a journalist;
- choose **Prepare my data** to download a copy of everything Kungora holds about the address, as JSON or CSV, or **Delete my data** to have the data deleted. If you also have an account, deleting the account is done while signed in.

## Moving from Mynewsdesk

Import your newsroom from Mynewsdesk with its API key, keep your old links and move your contact lists.

### What can move

If your organisation has a newsroom at Mynewsdesk, its content can move to Kungora automatically with the **Import** from Mynewsdesk, if Mynewsdesk has activated its API for your account. Contact lists move from a file. The pages [Switch from Mynewsdesk](https://kungora.com/migrate/mynewsdesk) and [Change newsroom service](https://kungora.com/migrate) on the public site describe the same move for people who have not signed up yet.

| Content | How it moves |
|---|---|
| Press releases, news and blog posts | Automatically, with text, images, subjects, regions and the original dates |
| Events | Automatically, upcoming and past |
| Images and documents | Automatically, in full size, with photographer and licence |
| Videos | A page with the poster image and the text. The file is kept privately; playing videos in your newsroom is not available yet |
| Press contacts | Automatically, with name, title, phone, email, photo and links. They are public in your newsroom as on Mynewsdesk, but their email address and phone number are left out of our open API until you have allowed it for each contact |
| The newsroom's details | Headline, description, address, logo and footer links, where the newsroom has none yet and your items carry your organisation number. The name stays as it is |
| Distribution lists | Not automatically: export each list from Mynewsdesk as CSV or Excel and import it under **Contacts** |
| Followers | Not moved: they agreed to Mynewsdesk's emails, not ours. Invite them to follow your new newsroom |
| Statistics, drafts, comments and Audience Builder | Stay at Mynewsdesk, because its API does not give them out |

The import never sends an email to anyone: not to followers and not to contacts. Cision content is not moved automatically today; Cision contact lists move as Excel or CSV files like any others.

### How to do the import

1. [Create an account](https://app.kungora.com/signup) and an organisation, and create a newsroom to import into ([Getting started](https://kungora.com/guide/getting-started), [Your newsroom](https://kungora.com/guide/newsrooms#create)). The organisation must be verified and active: an import publishes the whole archive at once. Only an admin or the owner can start it.
2. Ask Mynewsdesk's support to activate the API for your account and to give you the API key (they call it the unique key). Not every Mynewsdesk plan includes the API, and they activate it by hand, so it can take a day or two. The **Import** page has a text you can copy to send them.
3. Open **Import** under **Settings**. Choose the newsroom to import into, paste the key and confirm that you are authorised to export the content from Mynewsdesk on behalf of the company and to publish it here, with the personal data in it. Then **Start the import**. The key is stored encrypted and is deleted as soon as the import has read your content. If your Mynewsdesk account has newsrooms in several countries you can name the country; one import brings one Mynewsdesk newsroom.
4. The import runs by itself, and you can leave the page. It shows its progress and can be cancelled; what has been imported stays. An import that does not finish within 72 hours is stopped, and you can start it again: nothing is imported twice.
5. Read the report: counts per type, the items to check, the items that were skipped or failed and why, and the addresses that changed. Subject and region codes that we do not know yet are mapped by our staff; once they have decided, run the import again to give the items their subjects and regions.

Imported items keep their Mynewsdesk ids in their addresses, so an address such as /pressreleases/our-new-ceo-3240001 keeps working once your own domain points here. If an id is taken here, the item gets a new one and the old address redirects to it. The report offers the list of imported items and the redirects to download.

### Point your own domain here

Old links keep working only if your Mynewsdesk newsroom is on your own domain, such as press.yourcompany.se, and you point that domain here yourself. Links to addresses on mynewsdesk.com do not lead here.

1. Add the domain under **Custom domain** in the newsroom and publish the TXT record the page shows. Your Mynewsdesk newsroom keeps working meanwhile ([Your newsroom](https://kungora.com/guide/newsrooms#domain)).
2. If you can, lower the TTL of the CNAME record to five minutes a day before the switch.
3. Change the CNAME record from Mynewsdesk's address to the one the page shows, and choose **Check press.yourcompany.se now**. When the domain is verified, choose **Activate press.yourcompany.se** and make it the canonical address. Search engines do not index the newsroom there until you have activated it.
4. Keep your Mynewsdesk subscription until the domain works here.

### Contacts, followers and your old contract

- **Contacts**: in Mynewsdesk, export each distribution list as a CSV or Excel file (the export of all contacts leaves out which lists they are on), then import the files under **Contacts**, **Import**. Mynewsdesk's columns are recognised ([Reaching readers](https://kungora.com/guide/distribution#contacts)).
- **Followers**: invite them to follow your new newsroom, for example in your last newsletter from Mynewsdesk or with a follow button on your website.
- **Your contract**: check the notice period of your Mynewsdesk contract in time. The page about the import has general information on the EU Data Act and switching provider; it is not legal advice.

### Other services

- **Cision**: content is not moved automatically yet. Export the contacts as Excel or CSV and import them under **Contacts**.
- **Other services**: upload a file in Excel (XLSX, XLS), OpenDocument (ODS), CSV or tab-separated text and check the columns before anything is imported.

Mynewsdesk and Cision are trademarks of their respective owners. Kungora is not affiliated with them.

## API, webhooks and widgets

Read and publish content from your own systems, get signed webhooks when stories change, and show your news on your own website.

### The open API

The public API v1 serves published content as JSON over HTTPS. The [API reference](https://kungora.com/api/v1/docs) lists every endpoint, field and webhook with examples (in English), and the [OpenAPI 3.1 document](https://kungora.com/api/v1/openapi.json) is for code generators and API clients. The [API for developers](https://kungora.com/developers) page on the public site summarises it.

What you can do without a key: read newsrooms, their stories, search and search suggestions, stories by organisation number and the taxonomies (subjects, regions, industries, release types). The answers use cursor paging and weak ETags for conditional requests, and CORS allows every origin. Without a key you may make 60 requests a minute per network.

With an API key you can also write, if the key has the write permission: create and change drafts, publish, upload media and sign up followers with double opt-in. Publishing through the API follows the same checks and email rules as the dashboard, including the first-release review ([Publishing](https://kungora.com/guide/publishing#review)).

### API keys

Admins and the owner create keys under **API keys** in the organisation's **Settings**; other members can read the list. For each key you give a name, choose what it may do (**Read published content**, and **Create drafts, publish, upload media and add followers**) and when it expires (30 days, 90 days, one year or never).

- The key is shown once, when you create it. Copy it at once and keep it among your system's secret settings.
- Send it with every request as the header `Authorization: Bearer` followed by the key, from your servers only. Never put it in a web page or an app that others can download.
- A key raises the limit to 600 requests a minute.
- A key acts for the whole organisation, in the name of the person who created it. If that person leaves the organisation, the key can no longer write.
- You see when each key was last used, and you can revoke it with the button that reads, for example, **Revoke the key Website**. Systems that use it stop working at once.

### Terms for content you fetch

What you fetch stays the publisher's. When you republish a story, name the newsroom and Kungora as the source, link to the story and follow each image's licence and credit. Press contacts' names and work details are there for press enquiries about the story only: never use them for marketing, mailing lists or profiling, and never build a register of them. When a story answers 410 or 404, delete your copy and the personal data in it. The [terms of use](https://kungora.com/legal/terms-of-use) apply.

### Webhooks

Webhooks tell your own systems when a story is published, updated, unpublished or deleted. Admins and the owner add endpoints under **Webhooks**, up to 10 per organisation, each with its own signing secret.

- An endpoint is an https address on the standard port that answers on the public internet. Choose which events it gets: story published, updated, unpublished or deleted. Imported stories are left out unless you choose them, so that an import does not send hundreds of messages.
- We send a signed JSON message. The format follows Standard Webhooks, so its libraries can check it: the headers webhook-id (the same on every attempt, so use it to ignore repeats), webhook-timestamp and webhook-signature, which is v1 followed by the Base64 HMAC-SHA256 of the id, the timestamp and the body, keyed with the secret. The body has the type, a timestamp and data with only ids and published facts, among them a link to the story's page while it is public and its api_url.
- Answer with a 2xx status within 10 seconds; anything else, redirects included, counts as a failure. A failed delivery is retried for about three days, and an endpoint where every delivery fails for days in a row is turned off. Refuse messages whose timestamp is more than five minutes off.
- The secret is shown once. **Make a new secret** signs from then on, while the old one keeps signing for 24 hours so that you can switch without losing messages.
- You can choose **Pause the endpoint** (events from while it is paused are not sent later), **Send a test message**, and read the delivery log of the last 30 days, with the outcome of each attempt, and send a message again.

### Widgets for your website

Under **Widgets** in the newsroom's settings you build a widget, check the preview and copy the code. There are three:

- **News feed**: the latest press releases, news, blog posts and events with links to the newsroom. You choose the types, the number of items, a list or cards with images, whether links open in the same tab, a new tab or a window on your page, the language (English or Swedish), the heading level and, if you like, one of the newsroom's categories. The feed follows your page's font and colours, which you can adjust with CSS custom properties.
- **Follow form**: readers follow the newsroom by email, with double opt-in.
- **Alerts form**: readers get new releases that match a selection (this newsroom or every newsroom, types, a subject, a region, an industry) by email, with double opt-in.

The code comes in the forms that fit your website: a **Web component (recommended)** ( add the script once per page and the element where the widget should appear; the integrity hash makes the browser run only our unchanged file), an **iframe**, **HTML from the server** for sites without JavaScript, a **JSON Feed** and a **Plain link**. The page also lists the sources to allow if your site has a Content Security Policy.

### Feeds

Every newsroom has feeds in RSS 2.0, Atom 1.0 and JSON Feed 1.1, at `https://kungora.com/feeds/your-newsroom.rss` and, with the endings `.atom` and `.json`, in the other two formats. The portal has `https://kungora.com/feeds/news.rss` and `https://kungora.com/feeds/news.json`, which accept the same filters as the portal's stream. A newsroom on its own domain has its feeds there, at `/rss` and `/feed.json`.

For AI assistants, [llms.txt](https://kungora.com/llms.txt) lists the portal and the newsrooms, and this guide is available as one Markdown document at https://kungora.com/guide.md.

## Privacy, security and your account

Two-step verification and passkeys, your profile, the agreements, exporting your data, closing the organisation and deleting your account.

### Two-step verification and passkeys

Under **Security** in your account menu ("Your account") you protect your sign-in:

- **Two-step verification**: confirm your password, scan the QR code (or type the setup key) with an authenticator app, save the backup codes and enter a code to turn it on. After that, signing in with a password also needs a six-digit code. Each backup code works once, and they are shown only when you make them. If you use or lose them, **Make new backup codes** makes ten new ones and the old ones stop working. You can turn it off again after confirming your password.
- **Passkeys**: **Add a passkey** to sign in with your fingerprint, face or device PIN instead of a password. You can add several, for example on a second device, and remove them.

Admins and the owner can require two-step verification for every member of the organisation under **Security** in the organisation's settings ([Getting started](https://kungora.com/guide/getting-started#team)).

Some steps ask you to have signed in within the last ten minutes: adding a domain to verify, connecting or changing a custom domain, creating an API key, making a new webhook secret, transferring ownership, exporting the organisation's data, closing the account, unpublishing or deleting a newsroom, deleting your own account, making new backup codes, turning off two-step verification, adding or removing a passkey and changing your email address (for that last one you can enter your password instead, unless two-step verification is on). If the sign-in is older, the page offers **Sign out and sign in again** and brings you back. Exporting data, closing the account and deleting a newsroom also need two-step verification to be on.

### Profile and notifications

Under **Profile** in your account menu you change your name, your email address and your password. They belong to you, not to an organisation.

- **Email address**: enter the new address and we send a confirmation link to it, valid for 24 hours. Until you confirm, you keep signing in with the old address. When you confirm, we send a notice of the change to the old address.
- **Password**: a new password signs you out on your other devices and in other browsers.
- **Notifications** is an item of its own in your account menu, shown to members of an organisation. There you turn the weekly email about new followers on or off.

### Agreements

Under **Agreements** in the organisation's settings every member sees the agreements that apply: the customer terms, the privacy policy and the data processing agreement, with the version the organisation accepted, when, how and by whom, and announced changes. The data processing agreement is also available as a PDF. When a new version has to be accepted again, the owner is asked. The texts are on the [legal pages](https://kungora.com/legal) of the public site, with their version history.

### Export your data

Under **Data export** in the organisation's settings, admins and the owner can download everything the organisation has as one ZIP file: to keep a copy, to move to another service or before closing the account. You need two-step verification and a recent sign-in. Choose **Create an export**; it usually takes a few minutes and the page updates itself.

The file holds:

- every press release, news item, blog post and event, as JSON with all its details, as HTML and as Markdown;
- every draft with its saved revisions;
- the original images, documents and videos, with licence, photographer and copyright holder;
- the contacts and lists you can see, as CSV;
- the organisation's and the newsrooms' settings, members, sends, daily statistics, the names and permissions of API keys and webhook endpoints (never the keys or secrets) and the agreements you accepted;
- a map of every public address of your content, for redirects to a new site.

Followers and subscribers are counted but not listed, because we are responsible for their personal data. The file is deleted 7 days after it is made, a new export replaces the earlier one, and only you can download your own export. One export holds up to 4 GB of original files; if your organisation has more, write to hello@kungora.com.

### Close the organisation's account

Only the owner can close the account, under **Close account** in the organisation's settings. You need two-step verification and a recent sign-in. Download an export first. Then:

1. Choose what happens to the published newsrooms: **Keep them public** (the archive stays online with a note that the newsrooms are no longer maintained, and nothing new is published or sent), **Unpublish them and send visitors to your website** (you give the address), or **Delete them**.
2. Confirm that you have downloaded an export, type the organisation's name and choose **Close the account**.

The account closes 7 days after you confirm. Until then you can **Cancel the closure** and everything works as before, except that no newsroom can go live and API keys are paused. After the account is closed nobody can sign in, publish or send, API keys stop working and webhooks are turned off. As owner you can still download and create exports for 30 days; then drafts, contacts and other private data are deleted for good. We keep what the law requires: the record of accepted agreements, the audit log and the list of stopped email addresses.

### Delete your own account

Under **Profile**, **See what happens and delete the account** shows exactly what is deleted and what is kept. Deleting is permanent and needs a recent sign-in. You type your email address to confirm.

- **What is deleted**: your name, password, passkeys, two-step verification and every sign-in; your memberships (what you created in an organisation, such as press releases and contacts, belongs to the organisation and stays); your journalist profile, follows and saved searches with the consents you gave for them, and the records of emails we sent you.
- **What is kept**: a coded fingerprint of your email address on our suppression list, so that no one adds or emails the address again by mistake; your acceptances of our terms, linked only to that fingerprint, for as long as claims can be made against us and at most ten years; the audit log's entries of what you did, for twelve months; if you authorised an import of content, the proof of it, for three years; and, if you added or imported contacts, your email address as the organisation's proof of who confirmed that it may send them press material. Organisations that have your address in their own contact lists are told that you deleted your account.
- If you own an organisation you must first **transfer the ownership** or **close the organisation's account**: an organisation always has an owner.
- If data of the account must be kept for a legal matter, the deletion waits and is done automatically when the matter is closed; you get an email then.
- You can create a new account with the same address later.

### How we handle personal data

The public pages set no cookies, and the statistics are measured without cookies and without storing IP addresses. The public site's [legal pages](https://kungora.com/legal) hold the privacy policy, the data processing agreement, the list of sub-processors, the privacy policy for contacts and journalists, the security policy and how to report a vulnerability, the cookie policy, the accessibility statement and the information under the Digital Services Act. Questions about personal data go to dpo@kungora.com; security weaknesses go to security@kungora.com; reports of content go through the [report form](https://kungora.com/report) or to dsa@kungora.com.

## Help and contact

Where to get help, answers to common questions and what the service does not do yet.

### Get help

- **This guide.** Each part describes one area of the service. You can also give an AI assistant the whole guide as one Markdown document: https://kungora.com/guide.md.
- **Questions about the service, your newsroom or your account**: write to hello@kungora.com.
- **Content that is illegal or breaks the terms**: use the [report form](https://kungora.com/report), or write to dsa@kungora.com. The address is also the point of contact for authorities and users under the Digital Services Act ([the DSA page](https://kungora.com/dsa)).
- **Questions about personal data and your rights**: write to dpo@kungora.com.
- **A security weakness you have found**: write to security@kungora.com and describe what you saw and how to reproduce it.

All four addresses are on the [contact page](https://kungora.com/contact).

### Common questions

**The newsroom cannot be made live.** Only an admin or the owner can make a newsroom live. It cannot go live while the organisation is under review, restricted or suspended, or while its account is closing: the **Overview** of the organisation says which, and what to do next ([Your newsroom](https://kungora.com/guide/newsrooms#go-live)). While our staff review an organisation (for example one from a country whose company register we cannot query, or one without an organisation number), it can set up its newsroom and send tests to its members, but it cannot publish, send, invite colleagues, share preview links or confirm an address for email replies. We email you when the review is done.

**A story is published but no email went out.** Emails to followers and lists need tier 1, and you must have chosen to email them in the distribution step. The first stories of a new organisation wait for our review; a send over the limits, a paused organisation and a content rule also hold it. **Sends** shows the status and the reason ([Reaching readers](https://kungora.com/guide/distribution#limits)).

**A story could not be published.** The story's status says why: something required was missing (for example an alternative text on an image, or the confirmation of rights), the daily limit was reached, or a technical fault stopped it. Open the story, correct it and publish again ([Publishing](https://kungora.com/guide/publishing#checklist)).

**A follower says the confirmation email never came.** The link works for 24 hours. Ask them to check the spam folder, or to send the form again.

**The domain stays unverified.** The code you publish can take a while to show in DNS, and we check automatically for 72 hours. Check that the record, the file or the meta tag is exactly as the page shows, that it is on the right domain, and choose **Check now** ([Getting started](https://kungora.com/guide/getting-started#domain)).

**I forgot my password.** Choose **Forgot your password?** on the sign-in page. If you also have a passkey, you can sign in with it ([Getting started](https://kungora.com/guide/getting-started#sign-in)).

**I want to move from Mynewsdesk.** See [Moving from Mynewsdesk](https://kungora.com/guide/moving).

### What does not exist yet

The guide describes only what exists. These are things people ask for that the service does not have today:

- Roles beyond owner, admin and member, and an approval step before a story is published. Any member can publish.
- Writing events in the editor. Events show in newsrooms and arrive with a Mynewsdesk import.
- A PDF of each press release, automatic posting to social media, media monitoring (where a release was picked up) and help from AI in writing. The editor only marks text written with the help of AI.
- A sender domain of your own for emails. Email is sent from Kungora's address.
- An import of content from Cision (contact lists can be imported from a file), and a read API that is compatible with Mynewsdesk's. The API is Kungora's own ([API, webhooks and widgets](https://kungora.com/guide/developers)).
- Management of categories (renaming, merging or deleting) and folders in the media library.
- Statistics emails per newsroom, and a connection to Google Analytics. The only scheduled email is the weekly one about new followers.
- A public status page, and a log in the dashboard of who changed what in the organisation (a story has its own revisions).
- Distribution of inside information and regulated information (a regulatory news distributor).
- Sign-up for sole traders, in any country.
- Automatic lookup in the Danish register (CVR) and in the registers of EEA countries other than Sweden, Norway and Finland, and a check of VAT numbers. Our staff review those organisations by hand.
- The dashboard, the widgets, the legal texts and this guide in Danish, Finnish and Norwegian. The public pages, the follower pages and the follower emails are in all five languages.
