Or search everything below. Type what you want to do; the list filters as you type. Press Ask and the desk answers from these notes and points at the exact control. Sign in and every link opens your own paper.
How do I write my first article by hand?
Four steps. On the desk, press + New piece, give it a headline, choose News or Blog, and press Create; it opens as a draft. Click the byline to pick the writer. Open the Corpus tab on the right, search the fact record, and press Cite on each fact you want the piece to stand on. Then open the Copilot tab, press Write from my sources, and Apply to the page. Edit, and publish when it is ready.
The desk →Why will my own article not publish? It says it stands on 0 sources.
A news piece must stand on sources you placed. If it is your own writing, an opinion or a company post, click the small chip next to the headline that says news and flip it to blog. A blog piece publishes without a source floor and carries the Opinion label.
The desk →How do I put my paper on my own domain?
On the Publisher plan and above. Open Your own domain and type the address under Your own address; the page shows the one record to add at your registrar. A subdomain such as news.example.org is one CNAME record pointing at connect.newsroomfloor.com, set to DNS only. A whole domain such as example.org is one A record pointing at 168.220.82.194 (and, for IPv6, one AAAA record pointing at 2a09:8280:1::19b:e7ac:0). Add that one record and nothing else on your side changes: you keep your own DNS and your own email. The certificate is issued on its own within a few minutes of the record pointing at us, the page reads serving, and one email confirms it is live. Your newsroomfloor.com address keeps working throughout.
Your own domain →How do I know my domain is pointed at Newsroom Floor?
Open Your own domain. Each domain you added shows its live state (waiting on your record, the record seen and the certificate on its way, serving, or stopped with the reason) and a Check now button; the floor re-reads every pending domain every five minutes on its own, so you never have to come back. Above that, every address shows what DNS says a moment ago and how many readers arrived on it today.
Your own domain →My paper is printing readings that have nothing to do with my beat. How do I choose them?
Desk settings, The data ticker. Two switches say where readings print: the scrolling bar across the top of the front, and 'The data' blocks under each section head. Under them, eleven kinds say what rides: NEWS (this paper's own latest headlines, in the reader's language), SCORES (finals and standings), then the instrument readings: economy, markets, odds, weather, quakes, the web, crypto, AI and world. Pick the ones that belong on your paper and nothing else appears. Over the API and MCP the same eleven ids go in set_config ticker.kinds (news, scores, econ, markets, odds, weather, quakes, web, crypto, ai, world). A new paper prints no readings at all until you pick some, so a local daily never carries AI model traffic by accident.
Desk settings →What happens to my newsroomfloor.com address once my own domain is live?
Once your own domain serves and you make it the primary address, every page of your newsroomfloor.com address forwards to the same page on your domain, with the rest of the link kept. A story link in an old email or a QR code lands on that story. The catalog, the papers API and the agent file name your domain from then on. Your API key still works on the old address, and nothing forwards while the domain is pending or has an error.
Your own domain →Is there a page I can read or send that explains putting my paper on my own domain?
Yes, the full walkthrough is one public page. It covers what you get, the one record you add at your registrar (a CNAME for a subdomain, an A record for a whole domain), and what happens on its own after that. Send the link to whoever manages your DNS.
How to wire your domain →I replaced my banner. Can I get the old one back?
Yes. Every time a banner is replaced or removed, the old one is kept. Open Brand, go to the Masthead banner card: Previous banners shows the last six, newest first, with the style each one wore. Press Restore to put one back; the banner it replaces is kept there too, so a restore can be undone. An agent reads the banner and its history with get_banner, paints with generate_banner, restores with restore_banner and removes with remove_banner; the mark has get_mark, paint_mark and remove_mark (the same doors at /banner and /mark on the API).
Brand →Why did two unrelated stories land in one draft, and what counts as the same story?
The newsroom folds reports into one story when they share three subject words, or when a meaning check reads two reports as one event told in different words. Not every word counts as a subject. Your paper's own place names count as one word between them however many are shared. A month, a weekday, a count or a span of time weighs nothing. The name of an institution, such as a university, a laboratory, an agency, a ministry or an acronym like NASA, weighs half a word and only beside a real subject word, so two stories that share nothing but a laboratory's name stay apart. If a draft still bundles two subjects, reject it from the approval queue with a reason; the reason is kept for tuning.
The desk →Where do the article pictures come from, what do they cost, and can I change them?
Every published story carries one picture, painted by the art director from the story's own headline, standfirst and subject: a wordless picture of what the story is about, never words laid on an image. The newsroom paints it when the line files the piece. On the desk you can Generate a fresh one, add a line under Guide the image to steer it, or upload your own. There is no per-day image cap - each paint is metered against your credits like any model call (a premium paint about 6 credits, the fallback painter free), so you paint as many as your credits fund; raise what you can paint by raising credits or your plan. Every picture is kept with its story and carries a receipt of how it was made, and the last few are held, so Previous images on the desk puts an earlier one back. 1 credit is 1 cent.
The desk →Can an AI agent run my paper? Claude Code, or any agent that speaks MCP?
Yes. Everything the console does, an agent can do through the same doors: set the voice and cadence, sections and the masthead, run the line, write and submit a piece under one of your writers, edit or correct and publish, read every story and its receipt, read your leads, and ask this help desk as data. Mint a key under Settings, then Developers (an admin key does everything; an agent key signs as one of your writers and is scoped to edit, manage or configure), connect with the one line the card shows, and have the agent run nrf_cockpit first to prove the key is live. By default an agent's publish lands as a draft for an admin to sign off, no agent key can hand the paper away, touch the money or mint another key, and every publish carries the same signed receipt. The guide at newsroomfloor.com/agents walks it end to end, and the skill at newsroomfloor.com/agents/skill.md is written for the agent to read.
Bring your own agent →Where is my paper's landing page?
Every public paper has one at /subscribe on its own address (yourpaper.newsroomfloor.com/subscribe, or your own domain). It says what the paper is and hands a reader every way to get it: the paper, the email briefing, the video edition, the podcast feed, RSS, the API, and the agent edition. /channel and /about lead there too.
The catalog →How do alerts work, and can they reach my own system?
An alert is a watch you set on a paper: every story as it runs (instant), a daily or weekly briefing, only the sections you name, and the video edition when it posts. It reaches you by email, and, if you give an https address, every alert is also POSTed there as JSON (paper, cadence, sections, the stories with their links, the video) with an HMAC-SHA256 of the body under X-NRF-Signature, keyed by a signing key that is yours: the subscribe API answers with it as webhook_secret, and your alert settings page shows it. Set it on the paper's channel page under Alerts, on your own alert settings page, or by API: POST /api/v1/subscribers with {email, cadence, sections, cast, webhook}; a desk key can add up to 20 readers at once at /api/v1/subscribers. Nobody is alerted until they confirm.
Help →Does my paper have its own API?
Yes, on its own address, with a front door built for it. /api is the gateway: what the API is, the base address, your first call in cURL, JavaScript and Python, every door grouped with a live try-it panel, four things to build, the three lanes, and the house rules. /api/v1 is the index that names every door as a link: stories with their cited facts, sections, the archive by day, search, the front as JSON, the video editions, subscribe, and an OpenAPI document at /api/v1/openapi.json. No key needed for a public paper. A desk key from Desk settings opens the private lane on the same address. If the paper publishes in Spanish, the whole gateway is in Spanish.
The API gateway →Can I put one of my stories on another website?
Yes. Open /api on your paper's own address and scroll to the embed section: pick a story, and it writes the code. Paste it into a blog post, a docs page or a client's site. The card shows the headline, the picture, the byline and your paper's name, and every part links back to you. It sets no cookies. If the other site strips scripts, use the first version, which is a single tag. And in WordPress, Ghost or Notion you can skip the code altogether: paste the story link and it becomes the card by itself.
The API gateway →Can I post my paper's stories to social media?
Your paper's address serves /api/v1/posts: every piece on air as a ready-to-post short form, sized for X, with the story link and picture. Point a scheduler or an automation at it, or copy from it. Nothing there is written by a model; it is the headline, the dek when it fits, and the link.
The API gateway →How do I post the day's news or the video to X automatically?
Open Desk settings and open the Post to X card. Link your X account to your login (one click; you come straight back), then tick Post the day's news, Post the video of the day, or both, and save. The paper posts once a day as you, when the edition and the video are up. Post today's news now and Test without posting are on the same card, and every post is listed with its link.
Post to X →What does my paper's About page say, and can I change it?
Every paper has an About page at /about. Left alone, it is built from your paper's own details: the name, the description you set under Settings, then Reach, the sections it covers, the languages it publishes and its publisher, and nothing else. It names your paper only, never any platform. It is a plain, crawlable page a search engine can rank for your paper's name, so a clear description is worth setting. To put the page in your own words, write the About page box on the Reach card under Settings, then Reach (there is a View the About page link beside it), or send the text as the about field through the config door or the set_config tool; leave it empty and the automatic page stands.
Open Settings →Can I see who is using my Signal Desk?
Yes. Analytics on your desk draws the desk's own shape: signed-in reads by day, the signals readers open most and how often they take a quick look, what they open (the front, Data, About, API, signal pages), the watch sections they pick, searches by day with the mean number of hits, the digests sent and to how many readers, what their DRM3 bells said, invites sent, the roster and seats, and readers active in the last 7 and 30 days, with each feed's records and signals. The sign-in wall is never counted, a reader is counted by a hash of their account id and never by name or address, and a search is counted by its length and its hits, never its words. An agent reads the same numbers with desk_analytics.
Analytics →What are the Data, About and API pages on my Signal Desk?
The desk's reader pages, linked in the rail under the header on every page. The front carries one line of facts (feeds, records, signals, coverage, Private) and the signals. Data is the provenance: one card per feed with the supplier, how it arrives, the dataset, its records and signals, the last delivery read, and the tag readers see on a card. About is what the desk is: jurisdictions, the bodies that met, the date range, the owner, the private clause, and how access works. API is what a reader can read by machine on the desk's own address, listing only the doors that answer. All three sit behind the same sign-in wall as the front, and the preview shows the same pages.
Signal Desk settings →My paper is about one law or one trade and it keeps printing the whole industry. How do I keep it on the beat?
A subject only ever pulls facts in, so a trade's own words (shipbuilding, tanker, port, dredging) claim every yard, ship and harbour on earth. Open Desk settings, Coverage, the Markers segment. List the words that can only mean your desk (for a paper on the Jones Act: Jones Act, cabotage, coastwise, Puerto Rico, Hawaii, Alaska, Matson, MARAD, the American yards and ports) and turn on Every fact must carry a marker. From then on a fact that names none of them never reaches the desk, whatever else it says, while shipbuilding and tankers still count when they are yours. Before you save, press Measure against today's record on the Subjects segment: every word shows how many facts it claims today and how many of those carry a marker, and the wide ones turn the warning colour with one button to remove them.
Markers →I interviewed a source, or witnessed something myself. How do I put it on the record?
Open your paper and choose File a first-party report (it is also linked from Settings, Build the corpus). Write what the source said as an utterance ("the cataloger said ..."), say who said it, where and when, and pick how you came to know it: you witnessed it, an expert told you, or an organization stated it. You stand behind it by name and the newsroom signs it, so it becomes a permanent, attributable part of the record. It is one witness, so a story written from it publishes labelled as a single source and reads "the source says X", never "X". A photo, recording or document stays private to your desk: only a fingerprint of the file and, if you add it, the place and time it was taken ride the record, so the evidence stands even though the picture does not. A filed report is append-only: to correct or withdraw it you flag it for retirement, it is never edited or deleted in place. An agent does the same with file_report, or POST /api/v1/papers/{paper}/folders/report.
Research →