JournTech
System Administrator Guide
This guide was made from the help pages on 9 November 2026. The help centre has the latest version.
Help Press Ctrl+P to print it or save it as a PDF.
Role
System Administrator
Manages users, roles, settings, e-mail templates and system health.
The system administrator has access to every section. The system administrator cannot issue final decisions on submissions or approve ISBN requests. These tasks also require the Editor-in-chief or Publishing board role.
In the panel you see the Administration section and every other menu. You decide whether the help pages are open to visitors who have not signed in, with the Help pages open to everyone flag on the Site settings → Features tab.
Permissions of this role
- See unpublished catalogue records
- Create and edit publications, issues and files
- Publish and unpublish catalogue records
- Retract or correct published records
- Bulk import (CSV, XLSX, JSON)
- Create and edit persons and institutions
- Merge duplicate persons
- Manage taxonomies and categories
- Edit the profiles and issues of the journals in scope
- Upload, replace and archive files in the file library
- Edit pages, menus, banners, news, events and documents
- Publish institutional content
- Manage newsletter subscribers
- Handle contact messages and copyright reports
- Edit e-mail templates
- See the submissions in scope (editor queue)
- Screen submissions, request missing documents, send to review
- Assign editors to submissions
- Invite and manage reviewers
- Record a decision recommendation
- Message authors about their submission
- Start a submission for an author's account (the author submits it)
- See production jobs
- Manage production jobs and tasks
- Release accepted works to the catalogue
- See ISBN requests, printings and the legal deposit
- Prepare ISBN requests and record the Ministry steps, printings and the legal deposit
- See reports and indicators
- Export reports as CSV (personal data masked)
- Export reports with personal data
- See the audit log
- Export the audit log as CSV
- See user accounts
- Create, disable and verify user accounts
- Grant and revoke roles
- Manage site settings and feature flags
- Manage jobs, system health and the e-mail outbox
- Resolve KVKK data-subject requests
- See KVKK data-subject requests (read-only)
Screens and settings
Panel Search
Searching submissions, publications, people, users, pages and help topics at once with the search box in the panel's top bar.
The search box in the top bar searches many parts of the panel at once. When you type in the box and press Enter, the
Search screen opens and the results are grouped into sections. Turkish characters and upper and
lower case make no difference. For example, typing ışık also finds the title Işık Kirliliği.
The box appears for all roles other than Registered researcher and Reviewer. Which sections you see depends on your permissions.
Result sections
| Section | Permission needed to see it | Screen that opens all results |
|---|---|---|
| Submissions | See the submissions in scope (editor queue) | Editor queue |
| Publications | See unpublished catalogue records | Publications |
| People | Create and edit persons and institutions | People & institutions |
| Users | See user accounts | Users & roles |
| Pages | Edit pages, menus, banners, news, events and documents | Pages & policies |
| Help | No permission needed | The help centre's search |
Each section shows at most six results. If there are more, the See all link at the top of the section opens the search in that screen's list. Submission and publication results also show the type and the status.
When you press a help result, the topic opens in the help panel next to the screen, and you do not leave the screen you are working on.
When there are no results
Check the spelling or try a shorter phrase. If you are searching by submission number, type the whole number, for example JT-2026-00012.
Concept
Peer Review Types
What authors and reviewers see of each other in double-anonymous, single-anonymous and open review, and when the type is set.
The peer review type decides whether the author and the reviewer see each other's identity. The type is chosen in the Peer review field of the journal profile. Submissions not tied to a journal are reviewed double-anonymously.
| Type | What the reviewer sees | What the author sees |
|---|---|---|
| Double-anonymous | The identity of the authors is not shown | The identity of the reviewer is not shown |
| Single-anonymous | The authors and their institutions | The identity of the reviewer is not shown |
| Open review | The authors and their institutions | The name of the reviewer of a shared review |
Rules for every type
- Reviewers see only the anonymous files. The title page, the cover letter and the declaration documents are open only to editors.
- Editors always see the authors and the reviewers.
- The author sees only the comments-to-the-author section and the attachment of the reviews the editor shares.
- Confidential comments to the editor are never shown to the author.
- The invitation e-mail contains only the submission number and the journal name.
When the type is set
The peer review type of each submission is recorded when the author first submits it. If the journal changes the type later, the change applies only to new submissions. The editor sees the type of the submission in the header of the submission screen. The reviewer sees it in the note at the top of the invitation page.
The steps for changing the type are in Editing the Journal Profile.
Concept
Reviewer Deadlines and Reminders
The response and review periods of reviewer invitations, when reminders go out and how unanswered invitations close.
Each invitation has two deadlines. The reviewer responds to the invitation by the response deadline. If they accept, they submit the review by the review deadline. The exact dates are in the invitation and on the Deadlines card of the invitation page.
Default periods
If the editor does not set periods in the invitation, the periods from the site settings apply. By default these are 7 days for the response and 21 days for the review. A system administrator changes them on the Workflow tab of the Administration → Site settings screen.
In an invitation, the response period can be between 1 and 60 days and the review period between 1 and 180 days. Both periods count from the moment the invitation is sent. The review deadline cannot be earlier than the response deadline.
Reminders
- A reviewer who has not responded to the invitation yet is reminded once before the response deadline.
- For an accepted invitation, a reminder goes out before the review deadline.
- If the review is late, the reminders continue at the same interval. At most five review reminders are sent for one invitation.
- A site setting decides how many days before the deadline the reminder goes out. By default this is 3 days.
- Reminders go out only while the review round is open.
The editor sees the number of reminders sent in the row of the invitation.
Unanswered invitations
An invitation that is not answered by the response deadline closes automatically, and its status changes to Expired. The reviewer and the editors of the submission get a notification. An expired invitation can no longer be accepted. The editor can invite the same reviewer again.
Changing the deadlines
Only the editor changes the deadlines. The change is written to the audit log and the reminder counter is reset. The panel has no button for the reviewer to ask for more time. For more time, the reviewer contacts the inviting editor directly.
The editor's steps are in Tracking Invitations and Reviews. For a reviewer who cannot meet the deadline, see I cannot meet the deadline.
Feature
Editorial Work and Decisions
Following submissions in the queue, screening them, inviting reviewers, issuing decisions and corresponding with authors.
Editors follow submissions on the Editorial → Editor queue screen. A submission goes through screening, moves on to peer review and ends with a decision. The Next step card on the submission's page says what needs to be done at that moment.
The Section editor screens submissions, invites reviewers, corresponds with the author and records a decision recommendation. The Editor-in-chief also issues the final decision, assigns editors to submissions and manages the journal settings. The System administrator cannot issue final decisions. If a role was granted for one journal, only that journal's submissions are visible.
If the system administrator has made two-factor authentication mandatory for editorial roles, your editor permissions do not work until you set it up. The set-up is described in Using Two-Factor Authentication. Start by getting to know the Editor Queue screen.
Screens and settings
Editor Queue
The quick filters, filters, columns and sorting of the screen where editors follow submissions.
The Editorial → Editor queue screen lists the submissions within your scope. If your role was granted for one journal, you see only the submissions of that journal. Submissions you are an author of are not in the list. Drafts do not appear in the queue either. A submission enters the queue when the author submits it.

Quick filters
The boxes above the list, with their counts, are quick filters. Pressing a box narrows the list to those submissions.
| Box | Submissions it shows |
|---|---|
| Open | All submissions without a final outcome |
| New | Submissions that are submitted or in screening |
| Awaiting decision | Submissions under review and submissions with a submitted revision |
| Overdue | Submissions where the deadline for a reviewer response, a review or a requested revision has passed |
| Due soon | Submissions where one of these deadlines falls within 7 days |
| Assigned to me | Open submissions assigned to you |
| Unassigned | Open submissions without an assigned editor |
Filters
The Filters section has the following filters:
- The Submission no. or title box searches the submission number and the title.
- In the Journal list, editors authorised for the whole platform also see the Without a journal (books, chapters, theses …) option.
- The Status and Type lists narrow the submissions by status and by type.
- The Deadline list shows submissions whose deadline falls within 3, 7, 14 or 30 days. Overdue submissions are not in this list but in the Overdue box.
The filters stay in the address bar. If you share the link, the same list opens.
Sorting
The Sort list sorts by last activity, by submission date or by deadline. By default the list is sorted by last activity. The Deadline: nearest first option puts overdue submissions at the top and submissions without a deadline at the bottom.
Columns
| Column | What it shows |
|---|---|
| Submission | Submission number, title and the name of the submitter |
| Journal / type | The journal of the submission or Books and other submissions, and the publication type |
| Status | Status, the Overdue label if any, the review round or the revision deadline, and the nearest reviewer deadline |
| Reviewers | The number of reviews received and the number of invitations in the current round. Hovering over it shows how many reviewers are awaiting a response, reviewing or have declined |
| Editors | The assigned editors or Not assigned |
| Last activity | The time of the last activity on the submission |
Submitting on behalf of an author
Only people with the permission to start submissions on behalf of authors see the Start a submission for an author button. The screen it opens is described in Submitting on Behalf of an Author.
When you open a submission, the Next step card tells you what to do at that moment. The parts of the submission screen are described in Editor Submission Screen.
How-to
Screening a Submission
Checking the form of a new submission, asking the author for missing documents and sending the submission to peer review.
During screening you check whether a submission is ready to go to reviewers. A new submission arrives with the status Submitted. When you send it to peer review, its status changes to Under review.
Starting screening
- On the Editorial → Editor queue screen, open the submission.
- On the Next step card of the Overview tab, press Start screening.
- In the confirmation dialog, press the same button again.
The status of the submission changes to Screening. The author sees the new status on the page of their submission. This step is optional. You can also send a suitable submission straight to peer review.
Cards to check
Check the following cards on the Overview tab:
- The Metadata card shows the title, abstract, keywords and type-specific details. If the submission is written in two languages, you switch between them with the language tabs.
- The Authors card shows the authors in order with their institutions and ORCID iDs. The corresponding author is marked separately.
- The Declarations card shows the declarations the author confirmed and the answers they gave.
- On the Files card, the Anonymous files are the files the reviewers will see. A file whose metadata was removed carries the Metadata removed label. A file whose text contains an author's name, e-mail address or ORCID iD carries the The text of the file names an author label, with whose details appear where below it. Reviewers do not see this result. The Identified files are open only to editors.
Requesting missing documents
- On the Next step card, press Request missing documents.
- Optionally, fill in the Subject field.
- In the Message to the author field, state clearly what is missing. The text must be at least 10 characters long.
- Press Request missing documents in the dialog.
The status of the submission changes to Documents missing and an e-mail goes to the author. Your message also appears on the Messages tab of the submission. When the author completes the missing items and submits again, the status returns to Submitted and you get a notification.
Missing documents can be requested only for a submission whose status is Submitted or Screening.
Uploading an anonymous copy
If the anonymous manuscript still contains the name or institution of an author, you can upload a cleaned copy for the reviewers. The The text of the file names an author label appears when an author's name, e-mail address or ORCID iD is in the text. Institution names and self-citations such as "Author, 2024" are not searched for; look out for them as you read.
- Go to the Upload an editor file section at the bottom of the Files card.
- In the File type list, select Anonymous manuscript.
- Optionally, fill in the Description field.
- Drop the PDF, DOCX or ODT file on the upload area.
The new file replaces the author's anonymous manuscript. The old file stays in the list with the Replaced by a newer file label. The file you upload carries the Uploaded by an editor label and opens after the virus scan. Author details in the file properties are removed during the upload. The reviewers also see the files you upload as Supplementary file.
When the submission has the status Revision requested, the copy you upload goes to the new round the author is preparing and replaces the author's revised manuscript there. The text the reviewers of the previous round read stays as it was.
Sending to peer review
- On the Next step card, press Send to peer review.
- In the confirmation dialog, press the same button again.
The status of the submission changes to Under review and the author gets a notification. From this stage on, the author cannot change the files. You can now invite reviewers. The steps are in Inviting Reviewers.
To reject an out-of-scope or unsuitable submission without sending it to reviewers, see Desk-Rejecting a Submission.
How-to
Desk-Rejecting a Submission
Rejecting an out-of-scope or unsuitable submission without sending it to reviewers, or saving a rejection recommendation for it.
A desk rejection is a final decision. The submission is rejected without going to reviewers, a decision letter goes to the author and the process closes. Only an Editor-in-chief makes this decision. In the same situation a Section editor saves a rejection recommendation.
You can make this decision while the status of the submission is Submitted, Screening or Documents missing. For a submission in peer review, see Making a Decision.
Rejecting the submission
- On the Next step card of the Overview tab, press Desk reject.
- In the Rationale (editors only) field, write the rationale for the decision. The rationale must be at least 10 characters long and is not shown to the author.
- The Decision letter to the author field comes filled with a draft letter. Edit the letter. The letter must be at least 10 characters long.
- Press Desk reject in the dialog.
- Read the outcome in the confirmation dialog and confirm.
You can also make the same decision on the Decision tab by selecting Desk reject. On this tab the letter starts empty, and the Draft a letter button writes the draft. If you wrote or changed the letter yourself, the panel asks before it replaces the letter with the draft.
The status of the submission changes to Rejected. The decision is stored as a record that cannot be changed, and it is written to the audit log.
A section editor's rejection recommendation
For a submission in screening, a Section editor sees the Decision recommendation section on the Decision tab. Only Desk reject can be selected in this section.
- On the Decision tab, select Desk reject.
- Fill in the Rationale (editors only) field. The letter is optional for this recommendation.
- Press Save recommendation and confirm.
The recommendation does not change the status of the submission. A notification goes to the editors-in-chief assigned to the submission or, if none is assigned, to the editors with the permission to decide. The recommendation appears in the Decisions and recommendations section at the bottom of the tab.
How-to
Assigning Editors
Assigning a handling editor, section editor or editor-in-chief to a submission and removing an assignment.
When you assign editors to a submission, the notifications of the submission go only to the assigned editors. If no editor is assigned, the notifications go to all editors in scope. The permission to assign editors belongs to the Editor-in-chief role.
- On the Overview tab of the submission, find the Editor assignments card.
- Press Assign editor.
- Select the person in the Editor list. Editors who can decide carry the Can decide label. If a person is already assigned with another role, that role appears under their name.
- In the Role list, select Handling editor, Section editor or Editor-in-chief.
- Press Assign editor in the dialog.
The assigned editor gets a notification and sees the submission in the Assigned to me box of the queue. The assignment is written to the timeline and the audit log.
An editor whose account was closed counts as not assigned. The Account closed label appears next to the name, the notifications go to the other editors, and the submission is also listed in the Unassigned box of the queue. Assign another editor to the submission.
Editors you can assign
- The list includes only editors who may see this submission and whose e-mail address is verified.
- The authors of the submission and the reviewers who accepted an invitation for it do not appear in the list.
- The Editor-in-chief role can be given only to an editor with the permission to decide.
- You cannot assign the same person with the same role twice.
- Editors cannot be assigned to a withdrawn submission.
Removing an assignment
- On the Editor assignments card, press the cross button in the editor's row.
- In the confirmation dialog, press Unassign.
An editor you unassign keeps seeing the submission in the queue as long as it is within their scope. They are no longer among the assigned editors.
How-to
Inviting Reviewers
Inviting a reviewer to a submission under review, from the reviewer pool or by e-mail address.
You invite reviewers from the Reviewers tab of the submission. You can invite only while the status of the submission is Under review.
- On the Editorial → Editor queue screen, open the submission and go to the Reviewers tab.
- Press Invite reviewer.
- Choose the reviewer in one of two ways:
- On the From the reviewer pool tab, search by name, e-mail, institution or expertise. The candidates are ranked by the keywords of the submission. You can change the ranking with the Matching keywords field. Each candidate shows their number of ongoing, completed and declined invitations. A candidate whose expertise matches the submission carries the Matched label. Select the row of a suitable candidate.
- On the By e-mail tab, fill in the E-mail address, Full name and Invitation language fields. If an account with this address exists, the invitation goes to that account. For a person without an account, a reviewer account is created and a link for setting a password is sent. In this case the full name is required.
- Optionally, add a Personal message. If you leave Days to respond and Days to review empty, the periods from the site settings apply. By default these are 7 and 21 days.
- Press Send invitation.
The response period can be between 1 and 60 days, the review period between 1 and 180 days. The review deadline cannot be earlier than the response deadline. If you enter a review period shorter than the response period, both deadlines fall on the same day.
After the invitation
The invitation e-mail contains only the submission number and the journal name. The reviewer also gets a notification in the panel. Reminders go out automatically, and an invitation that is not answered in time closes. The periods are described in Reviewer Deadlines and Reminders.
You follow the status of the invitation, its deadlines and the incoming review on the same tab. Changing deadlines, cancelling an invitation and inviting the same person again are described in Tracking Invitations and Reviews.
Rules the system applies
- The authors of the submission and the people already invited in this round do not appear in the candidate list.
- The pool includes only active accounts with a verified e-mail address that have the reviewer role or joined the reviewer pool from their profile.
- You cannot invite yourself as a reviewer.
- If a person already has an open invitation in the same round, a second invitation is not sent to them.
- The Reviewer rules note at the top of the tab checks the number of reviewers and their institutions. These warnings do not block the action.
How-to
Tracking Invitations and Reviews
Following the status and deadlines of invitations on the Reviewers tab, reading reviews, changing deadlines, cancelling an invitation or inviting a reviewer again.
The Reviewers tab of a submission shows the reviewer invitations by round. The newest round is at the top and carries the Current round label. The card of a closed round shows the date it closed.
Invitation row
Each invitation row shows the reviewer's name, e-mail address, institution and the status of the invitation. The status is Awaiting response, Accepted, Declined, Expired or Cancelled.
| In the row | What it shows |
|---|---|
| Invited | The invitation date and the editor who sent the invitation |
| Respond by | For an invitation awaiting a response, the response deadline and the number of days left |
| Review due | For an open invitation, the review deadline and the number of days left |
| Responded | When the reviewer responded to the invitation |
| Account closed | Shown on an open invitation when the reviewer's account was closed. The reviewer gets no reminders; cancel the invitation and invite another reviewer. |
| Overdue | The label that appears when an open deadline has passed |
If the reviewer accepted the invitation, the row shows their conflict-of-interest declaration. If the reviewer disclosed a possible conflict, their explanation is here too. If they declined, the Reason for declining they wrote appears. The row also shows the number of reminders sent to the reviewer.
Reading the review
When the reviewer submits the review, a Show review link appears in the row. The review shows the reviewer's recommendation and scores, the Comments to the author and Confidential comments to the editor sections and, if there is one, the Review attachment file. Confidential comments to the editor are never shown to the author.
If the reviewer has started the review but not submitted it, the row says the review is a draft. The submitted reviews of the round also appear side by side on the Decision tab. Notes the reviewer sends after the review are listed as internal notes on the Messages tab.
Invitation actions
The Invitation actions menu of each invitation in the current round holds the actions that fit the status of the invitation:
- Change deadlines appears for open invitations. For an invitation awaiting a response, you change both dates. For an accepted invitation, you change only the review deadline. The date fields cannot be left empty. The new date must be in the future, and the review deadline cannot be earlier than the response deadline.
- Cancel invitation appears for open invitations. You need to write at least 5 characters in the Reason (not shown to the reviewer) field. The reviewer loses access to the files and is informed. An invitation whose review has been submitted cannot be cancelled.
- Invite again appears for declined, expired and cancelled invitations. A new invitation record opens for the same reviewer, and the earlier invitation stays closed. Once a decision is made, the round takes no more reviewers and this action no longer appears in the menu.
A deadline change is written to the audit log, and the reminder counter is reset. Editors with the permission to invite reviewers see the menu. An invitation with no action left has no menu, for example one whose review has been submitted.
Reviewer rules note
The Reviewer rules note at the top of the tab warns about the following cases, based on the criteria of TR Dizin (Türkiye's national citation index):
- The number of reviewers in the round is below the minimum the journal requires. If the journal has not set a number, at least two reviewers are expected.
- Two reviewers are from the same institution.
- A reviewer is from the same institution as an author.
- The reviews received include an accept or minor revision recommendation together with a reject recommendation, and there are fewer than three reviews. In this case you may want to invite a third reviewer.
Invitations awaiting a response, accepted invitations and invitations with a submitted review count towards the number of reviewers. The warnings do not block any action. The minimum number of reviewers the journal requires is the setting described in Setting the Reviewer Minimum and Reviewer List.
When reminders go out is described in Reviewer Deadlines and Reminders.
How-to
Making a Decision
Reading the reviews of a review round and making the final decision, or saving a decision recommendation as a section editor.
You make the decision on the Decision tab of the submission. An Editor-in-chief makes the final decision. A Section editor saves a decision recommendation on the same tab. The submitted reviews of the round appear side by side at the top of the tab.
A decision is made while the status of the submission is Under review or Revision submitted. To reject a submission that has not been sent to reviewers, see Desk-Rejecting a Submission.
Final decision
- In the Decision section of the Decision tab, select Accept, Minor revision, Major revision or Reject.
- For a revision decision, check the Revision period (days) field. The field comes filled with the period from the site settings and must be between 7 and 365 days.
- In the Rationale (editors only) field, write the academic rationale for the decision. The rationale must be at least 10 characters long and is not shown to the author.
- In the Reviewer comments to share with the author section, clear the tick of any review you do not want to share with the author. All submitted reviews come ticked.
- Fill in the Decision letter to the author field. The Draft a letter button writes a draft based on the decision you selected and the shared reviews. If the field holds text you wrote or changed, the panel asks before it replaces that text with the draft. The letter must be at least 10 characters long.
- Press Issue decision, then read the outcome in the confirmation dialog and confirm.
Unless the site settings were changed, the revision period is 30 days for a minor revision and 60 days for a major revision.
While you fill in the form, you can move to another tab to look at a file or at the details of the submission. The decision type, rationale and letter you entered stay in the form until you come back.
Effects of the decision
- The decision is stored as a record that cannot be changed, and it is written to the audit log.
- The round closes. The invitations of reviewers who have not submitted a review close, and these reviewers are informed.
- The decision letter goes to the author. Of the shared reviews, the author sees only the Comments to the author section and the attachment, if any. In open review the author also sees the name of the reviewer of a shared review.
- An accept decision opens a production job automatically.
- A revision decision gives the author a deadline. The author is reminded once before the deadline. Unless the setting was changed, the reminder goes out 3 days before the deadline.
Decision recommendation
A Section editor sees the Decision recommendation section on the same tab.
- In the Decision section, select the decision you recommend.
- Fill in the Rationale (editors only) field. Optionally, also write a draft letter for the editor-in-chief.
- Press Save recommendation and confirm.
The recommendation does not change the status of the submission. A notification goes to the editors-in-chief assigned to the submission or, if none is assigned, to the editors with the permission to decide.
Decision and recommendation history
All decisions and recommendations stay in the Decisions and recommendations section at the bottom of the tab. Each entry shows the decision type, whether it is a final decision or a recommendation, the round, the person who made it, the date and the rationale. You open the letter with the Show letter link.
If you cannot see the decision button, see The decision button is missing. The steps after a revision arrives are in Starting a New Round After a Revision.
How-to
Starting a New Round After a Revision
Making a decision directly after the author submits a revision, or sending the submission to a new review round.
When the author submits a revision, the status of the submission changes to Revision submitted and a new round starts. The editors of the submission get a notification. It is up to you whether you send the revision to reviewers again or make a decision directly.
Checking the revision
The card of the new round opens on the Reviewers tab. The card shows the Author’s response to reviewers text and the Files of this round list. The invitations and reviews of the earlier rounds stay on the tab.
Direct decision
If no new reviewer opinion is needed, an Editor-in-chief makes the decision right away on the Decision tab. The steps are in Making a Decision.
New review round
- On the Next step card of the Overview tab, press Send to peer review and confirm.
- On the Reviewers tab, press Invite reviewer.
- Select the reviewers of the previous round from the pool again. If a reviewer does not appear in the pool, enter their e-mail address on the By e-mail tab. If an account with this address exists, the invitation goes to that account.
- Press Send invitation.
You cannot use the Invite again action for an invitation from a previous round, because the action appears only on the invitations of the current round. The reviewer receives a new invitation for the new round. After accepting it, they see the author's response to the reviewers and the current anonymous files.
The steps of the invitation are in Inviting Reviewers.
How-to
Messaging the Author
Sending messages to the author from the Messages tab of a submission, writing internal notes between editors and following the correspondence.
All correspondence with the author runs on the Messages tab of the submission. On the same tab you also write internal notes that only editors see.
- Open the submission and go to the Messages tab.
- Select Message to the author or Internal note (editors only).
- Optionally, fill in the Subject field.
- Write your text in the Message field.
- Press Send.
When you send a message to the author, the author is informed by e-mail. The e-mail does not contain the text of the message and directs the author to the panel. Internal notes are never shown to the author and are marked with the Internal note label in the list.
If you move to another tab before you send the message, what you wrote stays in the box until you come back. If you try to leave the screen without sending it, the panel asks first.
Other entries on the tab
- Requests for missing documents sent during screening are listed as messages to the author.
- Notes that reviewers send after their reviews appear as internal notes.
- Messages the author writes to the editors are in the same list.
Messaging permission
Sending messages to the author requires the Message authors about their submission permission. If you do not have this permission, the tab says so in a note and you can only add internal notes.
Withdrawal reason
If the author withdraws the submission, the reason they wrote appears under the Submission withdrawn entry on the Timeline tab. The reason is not included in e-mails and is not shown to reviewers. A withdrawal also closes the open reviewer invitations.
How-to
Submitting on Behalf of an Author
Opening a submission draft for a registered author account, filling in the metadata, authors and files, and leaving the draft to the author.
If an author cannot prepare their submission themselves, you can open the draft for them. Only the author confirms the declarations, and only the author submits. The author needs a registered, active account with a verified e-mail address.
Starting the draft
- On the Editorial → Editor queue screen, press Start a submission for an author.
- In the Author account field, type at least 3 letters of the author's name or the full e-mail address.
- In the list, press Select in the author's row.
- Select the Publication type and the Main language of the submission. For an article, also select the Journal.
- Press Create the draft.
The list shows e-mail addresses masked. Only the account whose full address you typed shows its address in full. The journal list contains the journals in the scope of your role that accept submissions. Types not tied to a journal, such as books, chapters or theses, need a role granted for the whole platform.
The draft appears in the author's My submissions list, and the author gets a notification in the panel. This notification is not sent by e-mail.
Filling in the draft
- On the screen that opens, fill in the Metadata, Authors and Files tabs. Changes are saved automatically.
- On the Status tab, check what is left for the author.
- Press Leave it to the author.
When the author confirms the declarations and submits, the submission appears on the Editor queue screen. The submission does not enter the queue until the author submits it.
Rules
- Only the person who started the draft edits it. For that, the draft must not have been submitted yet and your permission for the journal must still be in place.
- You cannot open a draft in your own name this way. You start your own submissions from the My submissions screen.
- The action is written to the audit log. The Started by the editorial office on the author’s behalf entry appears on the author's timeline.
- Your drafts that have not been submitted yet stay in the Drafts I started for authors list.
The parts of the screens are described in On-Behalf Submission Screen and On-Behalf Draft Screen.
Screens and settings
Editor Submission Screen
The header, Next step card, tabs, cards and rules of the screen where an editor opens a submission.
This screen opens when you open a submission from the queue. Screening, reviewer invitations, the decision and the correspondence all run from this screen. The buttons on the screen depend on the status of the submission and on your permissions.

Header
The header shows the submission number and title. Below them are the status of the submission, the publication type, the journal, the review round and the submission date. The peer review type also appears here as Double-anonymous, Single-anonymous or Open review. For submissions not tied to a journal, Books and other submissions appears in place of the journal.
| Button | When it appears |
|---|---|
| Referee dossier (PDF) | If you have the permission to decide. It does not appear while the status of the submission is Submitted or Screening. Details are in Downloading the Referee Dossier |
| Open the production job | If a production job has been opened for the submission and you may see production jobs |
| Catalogue record | If the submission has a catalogue record and you may see draft records |
If you reviewed this submission as a reviewer, a separation-of-duties warning appears under the header. In that case you cannot make the final decision.
Tabs
| Tab | Contents |
|---|---|
| Overview | The Next step card, metadata, authors, declarations, files, editor assignments and the submitter |
| Reviewers | Reviewer invitations by round, deadlines, reviews and the reviewer rules note. The number on the tab is the count of open invitations in the current round |
| Decision | The reviews of the round, the final decision or decision recommendation form, and the history of decisions and recommendations. On a submission awaiting a decision the tab shows a dot |
| Messages | Messages with the author and the internal notes of the editors |
| Timeline | Every event of the submission. Events the author does not see carry the Editors only label |
The open tab stays in the address bar. If you share the link, the same tab opens.
Next step card
The card says what you need to do in the current status of the submission and shows the buttons for the actions available in that status.
| Status | Buttons |
|---|---|
| Submitted | Start screening, Send to peer review, Request missing documents, Desk reject |
| Screening | Send to peer review, Request missing documents, Desk reject |
| Documents missing | Desk reject |
| Under review | Invite reviewer, Final decision or Decision recommendation |
| Revision submitted | Send to peer review, Reviewers, Final decision or Decision recommendation |
Only editors with the permission to decide see the Desk reject button. For submissions awaiting a revision and for accepted, rejected and withdrawn submissions, the card only explains the status.
Overview cards
| Card | Contents |
|---|---|
| Metadata | Title, subtitle, abstract, keywords and type-specific details. Language tabs if the submission is in two languages |
| Authors | The authors in order with their institutions, e-mail addresses and ORCID iDs, the corresponding author and the contributor roles |
| Declarations | The declarations the author confirmed, with their versions, answers and dates |
| Files | Anonymous files, Identified files and the Upload an editor file section |
| Editor assignments | The assigned editors, their roles and the person who assigned them |
| Submitted by | The name, e-mail address and institution of the account that sent the submission |
Screen rules
- The screen opens only submissions within your scope that have been submitted. Drafts do not open here.
- A submission you are an author of does not open.
- If the status of the submission changed after you opened the screen, an action may be refused. Reload the page to see the current status.
- The decision type, rationale and letter you entered in the decision form stay when you move to another tab. The message you are writing stays too. If you try to leave the screen before you issue the decision or send the message, the panel asks first.
Related topics
Screens and settings
On-Behalf Submission Screen
The New draft card of the screen where editors open a draft for a registered author, and the list of the drafts they started.
The Submission on behalf of an author screen is where you open a submission draft for a registered author. You reach the screen with the Start a submission for an author button on the Editor queue screen.
New draft card
| Field | Description |
|---|---|
| Author account | Search with at least 3 letters of the author's name or with the full e-mail address. Only active accounts with a verified e-mail address are listed. You change the selected account with the Change button |
| Publication type | Article, Book, Book chapter, Proceedings paper, Thesis or Children's book. Types not tied to a journal appear only for roles granted for the whole platform |
| Main language of the submission | Turkish or English. The options come from the institution's metadata languages |
| Journal | Appears only for an article. Lists the journals in your scope that accept submissions through the panel |
The Create the draft button opens the draft in the author's account and takes you to the draft screen.
If there is no matching account, the author has to register first or a system administrator has to invite the account. If no journal in your scope accepts submissions, a warning saying so appears in place of the journal field.
Drafts I started for authors
The Drafts I started for authors list shows your drafts that the author has not submitted yet. Each row shows the title and type of the draft, the author's name, the journal and the time of the last activity. The Edit button opens the draft. When the author submits, the draft leaves the list and appears in the editor queue.
Screen rules
- Editors and system administrators with the permission to start submissions on behalf of authors see the screen.
- You cannot open a draft in your own name.
- The notification to the author is sent only inside the panel.
The steps are in Submitting on Behalf of an Author. The screen where you fill in the draft is described in On-Behalf Draft Screen.
Screens and settings
On-Behalf Draft Screen
The header, the Metadata, Authors, Files and Status tabs and the rules of the screen where you fill in a draft opened for an author.
On this screen you fill in the draft you opened for an author. The title of the screen is the title of the draft. If no title has been entered, it reads Untitled draft.
Header
The note under the title says for whom the draft is being prepared. The publication type, the journal and the author's name and e-mail address also appear here. The save status shows as Saving…, Unsaved changes or the time of the last save.
The Leave it to the author button in the header saves the changes and takes you back to the Submissions for authors screen.
Tabs
| Tab | Contents |
|---|---|
| Metadata | The metadata step of the submission wizard. Title, abstract, keywords and type-specific details |
| Authors | The authors, their order and institutions, and the corresponding author |
| Files | The anonymous manuscript and the other files |
| Status | The "What is left for the author" list. It says so when everything except the declarations is complete |
A tab with missing items shows a dot.
Screen rules
- Changes are saved automatically.
- If an author card has details but no name, the screen keeps you on the Authors tab and shows the error.
- The declarations are not on this screen. The author confirms the declarations and submits.
- Only the person who started the draft opens it. Once the author submits, the draft no longer opens on this screen and the submission enters the editor queue.
The steps are in Submitting on Behalf of an Author.
Concept
Separation of Duties
An editor who reviewed a submission cannot decide on it, authors take no role on their own submissions, and only the editor-in-chief makes final decisions.
Separation of duties means that one person does not take two roles on the same submission. A person who reviews a work does not decide on it. An author is not an editor or a reviewer on their own submission either. JournTech applies these rules automatically.
Editors who review
If you accepted a reviewer invitation for a submission, you cannot make the final decision on that submission. The rule applies even if you have an editor role, and it covers every round of the submission. A warning appears on the submission screen and the decision buttons are hidden. You cannot be assigned to such a submission as an editor either. Another editor-in-chief makes the decision.
Your own submissions
Submissions you are an author of do not appear in your queue and do not open. The system recognises you as an author if you own the submission or if your e-mail address or ORCID iD is in the author list. The authors of a submission cannot be assigned to it as reviewers or editors. You cannot invite yourself as a reviewer either.
Permission to make final decisions
Only an Editor-in-chief makes final decisions. A Section editor saves a decision recommendation, and the recommendation does not change the status of the submission. A System administrator can open every screen but cannot make final decisions. An administrator who needs to make decisions is also given the editor-in-chief role.
Whether reviewers and authors see each other's identity is explained in Peer Review Types.
Troubleshooting
The decision button is missing
Causes and fixes when the Decision tab of a submission has no Issue decision button or only lets you save a recommendation.
The Issue decision button depends on your role, the status of the submission and your part in the submission. Check the causes below in order.
You are a section editor
A Section editor does not make final decisions. They see the Decision recommendation section on the tab and save a recommendation with the Save recommendation button. An Editor-in-chief makes the decision.
Your editor-in-chief role is for another journal
Your roles can differ from journal to journal. For example, you can be editor-in-chief of one journal and section editor of another. Your permission to decide applies only to the journal where you are editor-in-chief.
The submission is not at the decision stage
A final decision is made while the status of the submission is Under review or Revision submitted. In any other status the tab gives the current status of the submission in a note. To reject a submission that has not been sent to reviewers, see Desk-Rejecting a Submission.
You reviewed this submission
If you accepted a reviewer invitation for the submission, the decision buttons do not appear and the tab says so in a note. Another editor-in-chief has to make the decision. The rule is explained in Separation of Duties.
You are a system administrator
The System administrator role does not carry the permission to make final decisions. With this role you can only save decision recommendations. If you need to make decisions, you also have to be given the Editor-in-chief role.
Troubleshooting
The reviewer did not receive the invitation e-mail
Helping a reviewer who says the invitation e-mail never arrived to find the invitation in the panel.
E-mail sending may be turned off on the installation. The invitation also goes out as a notification in the panel, along with the e-mail. A reviewer with an account therefore finds the invitation in the panel.
A reviewer with an account
The reviewer signs in with the e-mail address the invitation was sent to and opens the Invitations tab of the Author & reviewer → Reviewing screen. The View invitation button opens the invitation there.
The reviewing screens require a verified e-mail address. If the reviewer's address is not verified, they need to verify it first.
A reviewer with a new account
If the person you invited by e-mail address has no account, the link for setting a password goes out only by e-mail. If e-mail sending is turned off, a system administrator creates this link and passes it on to the person. The administrator's steps are in Managing User Accounts.
The e-mail sending setting is described in Configuring Outgoing E-mail.
Troubleshooting
The reviewer's deadline has passed
Giving more time, cancelling the invitation or inviting another reviewer when a reviewer did not respond in time or is late with the review.
The row of an invitation whose deadline has passed carries the Overdue label. What you do depends on the status of the invitation.
The reviewer did not respond to the invitation
An invitation whose response period has ended closes automatically shortly afterwards, and its status changes to Expired. You get a notification too. You can invite the same reviewer again with Invite again in the Invitation actions menu of the invitation, or invite another reviewer.
The reviewer is late with the review
For an accepted invitation, reminders go to the reviewer at regular intervals once the review deadline has passed. To give the reviewer more time, select Change deadlines in the Invitation actions menu of the invitation and enter a new Review due date. The reminder counter is reset.
If the reviewer is not going to send a review, cancel the invitation with Cancel invitation and invite another reviewer.
The actions are described in Tracking Invitations and Reviews. When reminders go out is described in Reviewer Deadlines and Reminders.
Troubleshooting
Book submissions do not appear in the queue
Why submissions not tied to a journal, such as books, chapters and theses, do not appear in the editor queue, and how to fix it.
Submissions not tied to a journal are visible only to editors whose role was granted for the whole platform. Book, book chapter, proceedings paper, thesis and children's book submissions belong to this group. If your role was granted for one journal, you do not see these submissions.
Solution
If you need to work on these submissions, ask your system administrator to grant your role for the whole platform. Granting roles is described in Granting and Revoking Roles.
Filtering these submissions
Editors authorised for the whole platform list only these submissions with the Without a journal (books, chapters, theses …) option of the Journal filter in the queue. The journal column of these submissions shows Books and other submissions.
Feature
Production
Running the copy-editing, typesetting and proof work for an accepted work and releasing it to the catalogue.
When an editor accepts a submission, a job for the work opens automatically on the Editorial → Production screen. The job's checklist has these tasks: copy-editing, typesetting, cover, proof and author approval, metadata check, identifiers, licence and access, and final approval. The Production coordinator assigns the tasks, uploads the proofs and the final files and shares the proof with the author.
When the checklist is complete, the work is released to the catalogue with its publication settings. The record is published at once or stays a draft for the catalogue editors' final check. Because the release is an editorial decision, the catalogue's editor approval rule does not cover this step.
Editors and the Unit manager role can only view jobs. A job's statuses are described in Job Statuses.
Screens and settings
Production Board
The cards, filters and Open job button of the board that lists production jobs in columns by status.
The Editorial → Production screen shows the production jobs of accepted works as a board. If your role was granted for one journal, you see only the jobs of that journal.
Columns
Jobs are listed in four columns by status. Each column shows its number of jobs at the top, and the numbers follow the filters you choose. The Released column shows the jobs released last. The button at the bottom of the column brings the earlier ones too.
| Column | Jobs |
|---|---|
| Open | Jobs where work has not started yet |
| In progress | Jobs where work has started |
| Ready to release | Jobs with all required tasks done |
| Released | Jobs released to the catalogue |
The statuses are described in Job Statuses.
Cards
Each card shows the submission number and the type, title and journal of the work. The progress bar of the card counts the completed tasks. Below it you see the number of open required tasks, or Required tasks done. The bottom line of the card gives the production lead and the planned release date. An overdue job carries the Overdue badge.
Filters
- The Search box searches submission numbers and titles.
- Assigned to me shows the jobs where you are the production lead or have an open task assigned to you.
- Overdue shows the jobs that have a task past its due date, or that are not released by their planned release date.
- Show cancelled jobs lists cancelled jobs in a separate section at the bottom of the board. The ones cancelled last come first.
Opening a job
Jobs open automatically with the editor's acceptance decision. If an accepted submission has no job, use the Open job button. The button appears to people with the permission to manage production. The steps are in Planning a Job.
How-to
Planning a Job
Opening a production job by hand, assigning the production lead, and entering the planned release date and notes for the team.
As soon as an editor accepts a submission, a job with the default checklist opens for the work. The production team and the author are notified.
Opening a job by hand
If no job opened automatically for an accepted submission, you open it yourself.
- On the Editorial → Production screen, press Open job.
- Select the submission in the Accepted submission list.
- Press Open job in the dialog.
The dialog lists the accepted submissions in your scope that have no job, with their number, journal or type, and title. If the submission already has a job, the dialog says so and shows the Open the existing job link.
Job details
- Open the job from the board.
- On the Job details card, select the lead in the Production lead list.
- In Planned release date, enter when the work is planned to be released.
- Optionally write a note for the team in Notes.
- Press Save.
The assigned lead gets a notification. The list holds the users who can see production jobs for the journal of the job. A job that is not released by its planned date counts as overdue on the board.
Assigning the tasks is described in Managing Tasks.
Screens and settings
Production Job Page
The checklist, tasks, files, front matter, comments, job details and release settings cards on the page of a production job.
When you open a job from the board, the header shows the title, submission number, type and journal of the work, the production lead, the planned release date and the acceptance date. Without the production permission, you can only view the page, and a note says so. When the production lead's account was closed, the Account closed label appears next to the name, and the production coordinators receive the notifications meant for the lead.

Top buttons
- Open the submission opens the editor page of the submission and appears to people who can see the editor queue.
- Open the catalogue record opens the catalogue record once the job is released.
- Release opens the release dialog. While an item blocks the release, the button cannot be pressed.
Cards
| Card | What it shows |
|---|---|
| Release checklist | The metadata, licence, identifier, final PDF, cover, citation and release date items, and what blocks the release |
| Tasks | The tasks of the checklist with their statuses, assignees and due dates |
| Files and proofs | The versions of the proof, final PDF, EPUB, cover and other files |
| Front matter | The front matter for the first page of the article. Shown for articles only. |
| Comments | The comments of the team and the author |
| Job details | The production lead, planned release date, notes, cancelling and reopening |
| Release settings | The access, licence, identifier, placement and address settings of the catalogue record |
Rules of the screen
- On a released or cancelled job, tasks and settings cannot be changed. Reopen the job to change them.
- You cannot upload files to a cancelled job.
- The assignee of a task can change the status and the note of their own task, even without the production permission.
- While a file is being scanned for viruses, the page refreshes itself every few seconds.
The steps are in Planning a Job, Managing Tasks, Uploading Files and Sharing Proofs, Filling in the Release Settings and Releasing a Work.
How-to
Managing Tasks
Changing the status of the tasks of a production job, giving tasks an assignee and a due date, adding new tasks and setting the reminders.
Every job opens with a default checklist. The tasks are on the Tasks card of the job page.
| Task | Required |
|---|---|
| Copy-editing | Yes |
| Typesetting | Yes |
| Cover | Yes for books and children's books, no for other types |
| Proof and author approval | Yes |
| Metadata check | Yes |
| Identifiers (DOI/ISBN) | Yes |
| Licence and access | Always |
| Final approval | Always |
The "Licence and access" and "Final approval" tasks are always required. For the other tasks, you can change the Required task box in the edit dialog.
Changing the status
- Open the job and scroll down to the Tasks card.
- In the list on the row of the task, select To do, In progress, Done or Skipped.
A status you pick with the mouse is saved at once. With the keyboard, the arrow keys move between the statuses and save nothing. Save the status you chose with Enter. If you leave the list without pressing Enter, or press Escape, the saved status comes back.
A required task cannot be skipped. The status of the job changes automatically with its tasks. When all required tasks are done, the job becomes Ready to release. The row of a completed task shows who completed it and when.
Assignee and due date
- Press the Edit button with the pencil icon on the row of the task.
- Select the person in the Assignee list.
- Enter the due date in Due.
- Optionally enter a Note.
- Press Save.
The assignee gets a notification. Even without the production permission, they can update the status and the note of their own task.
New task
- Press Add task.
- In Task, enter a name of at least 2 characters.
- If the task must be done before release, tick Required task.
- Optionally enter an assignee, a due date and a note.
- Press Add task in the dialog.
Only tasks added later can be renamed.
Reminders
For an unfinished task with a due date, the assignee gets one e-mail and one panel notification before the due date. How many days before is set by the Production task reminder (days before the due date) setting on the Site settings → Workflow tab. The default is 3 days, and 0 switches the reminder off. If the due date is moved later, a new reminder goes out for the new date.
No reminder goes out for a task whose due date has passed. The task is marked Overdue on its row, and the job counts as overdue on the board.
When the assignee's account was closed, the task's row shows the Account closed label and the assignee gets no reminder. Assign the task to someone else. The reminder e-mail names the task in the recipient's language.
How-to
Uploading Files and Sharing Proofs
Uploading proof, final PDF, EPUB and cover files in versions, sharing a proof with the author and exchanging comments with the author on the proof.
The files of the work are kept in versions on the Files and proofs card of the job. Each upload is a new version (v1, v2…), and earlier versions are kept.
Uploading a file
- In the Upload a new version section at the bottom of the Files and proofs card, select the type in the File type list.
- Optionally enter a Version note.
- Drag the file onto the field, or select it with the choose from your computer link.
| Type | Format |
|---|---|
| Proof | |
| Final PDF | |
| EPUB | EPUB |
| Cover image | JPG, PNG or WebP |
| Other file | PDF, EPUB, image, ZIP, DOCX or ODT |
An uploaded file goes through a virus scan and cannot be used before the scan finishes. On release, the final PDF, the EPUB and the cover image are added to the catalogue record.
Sending the proof to the author
- Press Share with the author on the row of the proof.
- Confirm the dialog.
The author is informed by e-mail, opens the proof on the page of their submission and writes comments. The author's steps are in Checking Proofs. Sharing is separate for each version, so you share a new proof version separately too. You withdraw sharing with Withdraw sharing. A proof whose scan has not finished cannot be shared.
Comments
- On the Comments card, write your comment in Comment.
- Select the file in the Related file list, or leave it at General.
- To send the comment to the author too, tick Visible to the author.
- Press Add comment.
The author sees only the comments written with this box ticked on a proof shared with them. The author's comments appear with the Author label. A comment from the author is notified to the production lead, or to the production team if no lead is assigned. After the job is released or cancelled, the author can no longer comment on proofs.
How-to
Filling in the Release Settings
Preparing the access status, licence, identifiers, journal issue, parent book, categories and catalogue address for the catalogue record of the work.
The details on the Release settings card are used when the catalogue record is created or updated on release. You can fill in the card at any stage of the job and save it with Save.
Access and licence
- The Access status list offers Open access, Metadata only, Embargoed and Restricted. For an article Open access is preselected, and for other types Metadata only.
- Select the licence in the Licence list. An open-access release needs a licence, and it must be an open licence. Licences that are not suitable for open access are marked in the list.
- For an embargoed release, enter a future date in Embargo end date.
Identifiers and year
- If Publication year is empty, the year of the issue is used, or the year of the publication date when there is no issue.
- The DOI starts with
10. - The ISBN field appears for books, theses, proceedings papers and children's books.
If a DOI, ISBN or catalogue address is used by another record, the release is blocked.
Placing an article in an issue
- Select the issue of the article in the Journal issue list. An article can be placed only in an issue of its own journal.
- The Section and Position in the issue fields are optional.
- If you select no issue, you can tick Publish as early view. The article is released without an issue and appears in the early view section of the journal page. The catalog editors add it to an issue later.
- The Page range (for example 12-34) and Article number fields are optional.
If you do not have the permission to manage journals, the list shows only published issues. The details are in The issue I am looking for is not in the journal issue list.
Parent book and pages
For a book chapter or a proceedings paper, find and select the book with the Search books box in the Parent book section. Enter the pages of the chapter in Page range. For a book, this field is called Number of pages.
Categories and address
- Categories are the subject and genre categories of the catalogue record. A book that is to be published at once needs at least one category.
- If Catalogue address (slug) is left empty, it is generated from the title.
Publishing at once
If Publish immediately on release is on, the record is published on the public site at the moment of release. If it is off, the record is created in the catalogue as a draft and waits for the final check of the catalog editors. The Citation preview at the bottom of the card shows how the citation will look.
On a released or cancelled job, the settings cannot be changed. The release steps are in Releasing a Work.
How-to
Copying the Article Front Matter
Copying the dates, authors, citation line, article type and declarations for the first page of an article in Turkish and English, and passing them to typesetting.
For articles, the job page has a Front matter card. The card prepares the details to be printed on the first page of the article, in Turkish and in English. It holds the following.
- The title, the authors, their institutions and ORCID iDs, and the corresponding author
- The article type
- The received, revised and accepted dates
- The citation line and the DOI, for example
Abbreviation. 2026;12(1):15-22 - The licence
- The declarations on ethics committee approval, conflicts of interest, funding, author contributions and the use of artificial intelligence
Copying the front matter
- Open the job and scroll down to the Front matter card.
- Check the Missing for the front matter list and complete what is missing.
- Select the Türkçe (Turkish) or English tab.
- Press Copy and paste the text into the typesetting.
The card is refreshed every time the release settings are saved.
Missing items list
The Missing for the front matter list follows the first-page criteria of TR Dizin (the national citation index run by TÜBİTAK ULAKBİM) and does not block the release. It can include the journal abbreviation, the issue, the page range or article number, the DOI, the ORCID iDs and institutions of the authors, the English title and the ethics committee statement.
The issue, page range, article number and DOI are entered on the Release settings card. The journal abbreviation is in the catalogue record of the journal. On release, the declarations and the revision date are also written to the catalogue record.
How-to
Releasing a Work
Checking the release checklist, clearing what blocks the release, and releasing the work as a catalogue record that is published at once or kept as a draft.
A work whose checklist is complete goes into the catalogue with Release. Releasing needs a separate permission (Release accepted works to the catalogue), which the Production coordinator role has.
Checklist
The Release checklist card shows these items.
| Item | What is checked |
|---|---|
| Metadata | The title and the authors of the accepted manuscript |
| Licence and access | The access status, the licence and the embargo date |
| DOI and other identifiers | Whether the DOI and the other identifiers entered are valid. This item is optional. |
| Final PDF | The final PDF is uploaded and scanned |
| Cover image | The cover image. If the cover task is required, this item is required too. |
| Citation | The citation preview |
| Release date | The planned release date, or the moment of release |
The What blocks the release list at the bottom of the card names each missing item.
Release steps
- Press Check. The check also tries the catalogue rules without saving anything, and shows the result on the card.
- If nothing blocks the release, press Release.
- In the Release the work dialog, select Publish immediately on release or Draft.
- When you publish at once, you can fill in Publication date. If you leave it empty, the current time is used.
- Press Release in the dialog.
The job becomes Released, the catalogue record is created and the author is informed. The final PDF, the EPUB and the cover image are added to the catalogue record. You go to the record with the Open the catalogue record button at the top of the page.
Conditions that block a release
- Not all required tasks are done.
- The final PDF is not uploaded, or its scan has not finished. If the cover task is required, a cover image is needed too.
- An open-access work has no licence selected, or the end date of an embargoed work is not in the future.
- The DOI, ISBN or catalogue address is used by another record.
While Publish immediately on release is on, the place of the record in the catalogue is checked too.
- An article must be in a published issue of a public journal, or be marked as early view. Its publication year must match the year of the issue.
- For a book chapter, the book must be selected and published.
- A book must have at least one category.
If the issue is not published yet, have it published first, or switch off immediate publication and release the work as a catalogue draft. A catalog editor or the journal's editor-in-chief publishes issues.
Because releasing is an editorial decision, the editor approval rule of the catalogue does not cover this step. The rule is described in Four-Eyes Principle.
Releasing again
If a released work needs a change, reopen the job, make the change and release the work again. The catalogue record is not written anew then. Only the fields production changed since the last release go to the record. Details the catalogue editors corrected in the record, such as an author's name, an English abstract or the page range, stay as they are. The new final PDF replaces the previous file, which is archived.
How-to
Cancelling and Reopening a Job
Cancelling a production job with a reason, continuing a cancelled job and preparing a corrected version of a released work.
You cancel and reopen a job with the buttons on its Job details card.
Cancelling
- On the Job details card of the job, press Cancel job.
- In Reason for cancelling, enter a reason of at least 3 characters and confirm.
The job closes. Its tasks, files and comments are kept, and the reason for cancelling shows on the job page. A released job cannot be cancelled.
Reopening
- On a cancelled or released job, press Reopen job.
- Confirm the dialog.
The job continues from where it stopped, according to its checklist. The job of a released work is reopened to prepare a corrected version, and the catalogue record stays published. When you finish the correction and release the work again, the catalogue record is updated.
Cancelled jobs appear on the board with the Show cancelled jobs button.
Concept
Job Statuses
The Open, In progress, Ready to release, Released and Cancelled statuses of a production job, and how the status follows the checklist.
You do not choose the status of a job by hand. The status changes automatically with the tasks on the checklist. Only releasing, cancelling and reopening change the status directly. This way each column on the board shows where a job really stands.
| Status | When |
|---|---|
| Open | The job is open and no task has started |
| In progress | A task has started or is done. Uploading a file to the job also moves it to this status. |
| Ready to release | All required tasks are done |
| Released | The work has been released to the catalogue |
| Cancelled | The job was cancelled with a reason |
Overdue jobs
A job counts as overdue while a task past its due date is still open. Done and skipped tasks do not count. A job that is not released by its planned release date counts as overdue too. Overdue jobs are marked on the board and listed by the Overdue filter.
Who changes a job
The Production coordinator changes all settings of a job and releases the work. Editors and the Unit manager can only view the job. The assignee of a task can change the status and the note of their own task.
The release steps are in Releasing a Work, and cancelling and reopening in Cancelling and Reopening a Job.
Troubleshooting
The licence list is missing in the release settings
What to do when the Release settings card shows a warning instead of the licence list, or the selected licence counts as invalid.
When the panel cannot load the licence list, the Release settings card shows the warning The licence list could not be loaded; reload the page and try again. instead of the list. If a licence was selected for the job before, its code is shown next to the warning.
- Reload the page.
- If the warning stays, tell your system administrator.
An open-access work cannot be released without a licence.
The selected licence counts as invalid
The list shows only the licences in use. If a licence that was selected for the job earlier has since been withdrawn from use, it stays in the list but counts as invalid on release, and the What blocks the release list says that the selected licence was not found. Select another licence from the list and save.
Troubleshooting
A missing category blocks the release of a book
Choosing a category, or releasing the work as a draft, when a missing category blocks the release of a book with immediate publication.
A book needs at least one category in the catalogue. If no category is selected while Publish immediately on release is on, the What blocks the release list says that the book needs at least one category. You fix this in one of two ways.
Choosing a category
- On the Release settings card, select at least one category in Categories.
- Press Save.
- Check again with the Check button.
Releasing as a draft
Switch off Publish immediately on release, or select Draft in the release dialog. The record is created in the catalogue as a draft. A catalog editor adds the category and publishes the record.
Category trees are described in Managing Categories.
Troubleshooting
The issue I am looking for is not in the journal issue list
Causes and fixes when the issue you expect does not appear in the Journal issue list of the release settings.
The Journal issue list shows the issues of the article's own journal. Check the causes below.
The issue is not published yet
If you do not have the permission to manage journals, the list shows only published issues. The journal's editor-in-chief or a catalog editor creates and publishes a new issue. The steps are in Creating an Issue and Publishing an Issue.
A draft issue that was selected for the job earlier stays in the list with the draft badge.
The issue belongs to another journal
An article can be placed only in an issue of its own journal. The issues of other journals do not appear in the list.
Releasing without waiting for the issue
If the issue is not ready yet, tick Publish as early view. The article is published in the early view section of the journal page, and the catalog editors add it to an issue later. The details are in Publishing an Article as Early View.
Troubleshooting
The Open job button is missing on the board
Causes when the Open job button does not appear on the production board, or the dialog lists no accepted submission.
Jobs open automatically with the editor's acceptance decision. The Open job button is only for jobs that did not open automatically, and it appears to people with the permission to manage production. The Production coordinator and System administrator roles have this permission.
You do not have the permission
Editors and the Unit manager can only view the board. If an accepted work has no job on the board, tell a person with the Production coordinator role or your system administrator.
The dialog lists no submission
The dialog lists only accepted submissions in your scope that have no job. If there is none, the dialog says No accepted submissions found. A submission whose job was cancelled does not appear either, because the submission has a job. Find the cancelled job with the Show cancelled jobs button on the board and reopen it.
Troubleshooting
The author cannot comment on the proof
Checking the sharing, the proof version and the status of the job when the author cannot see the proof or cannot comment on it.
The author sees the proof only after you share it, and can comment only while the job is open. Check the causes below.
The proof is not shared
If the row of the proof has no Shared with the author label, press Share with the author. A proof whose scan has not finished cannot be shared.
The new version is not shared
Sharing is separate for each proof version. If you uploaded a new proof version, share that version too.
The job is closed
After the job is released or cancelled, the author can no longer comment on proofs. If a correction is needed, reopen the job. The steps are in Cancelling and Reopening a Job.
The author does not see the team's comments
The author sees a comment from the team only if it was written on a shared proof with Visible to the author ticked.
Troubleshooting
The Release button is disabled or missing
Causes and fixes when you cannot press the Release button of a production job, or the button does not appear at all.
The Release button depends on the status of the job, its checklist and your permissions. Check the causes below in order.
An item blocks the release
If the button is disabled, look at the What blocks the release list on the Release checklist card and complete each item. The details are in Releasing a Work.
The job is released or cancelled
On a released or cancelled job, the button is hidden. Reopen the job to make a correction.
You do not have the permission
Releasing needs a separate permission (Release accepted works to the catalogue). Editors and the Unit manager can only view the job.
The check passes but the release fails
The Check button also tries the catalogue rules and lists any problems on the card. If an error comes up in the release dialog, the dialog lists the blockers one by one.
Feature
Catalogue
Creating, publishing and correcting records of books, chapters, journals, articles, proceedings papers, theses and children's books.
Every publication on the public site is a catalogue record. Records of books, book chapters, journals, articles, proceedings papers, theses and children's books are created and edited on the Catalogue → Publications screen. The type of a record sets the required fields of the form and cannot be changed later.
A record starts as a draft, is sent to review and is published. A published record appears on the public site, in search, in the sitemap and in OAI-PMH. For a mistake in a published record, a correction note is added or the record is retracted. If the editor approval rule is on in your installation, the person who sent a record to review cannot publish it. The details of the rule are in Four-Eyes Principle.
The Data quality screen shows records with missing details, and the DOAB readiness screen shows whether books are ready for DOAB (the Directory of Open Access Books). For your first record, start with Creating a Catalogue Record.
How-to
Creating a Catalogue Record
Opening a new catalogue record for a book, chapter, journal, article, proceedings paper, thesis or children's book and filling in its details.
You open a new catalogue record with the New publication button on the Catalogue → Publications screen. You choose the record's type first, because the type sets the required fields of the form and cannot be changed later.
Creating the draft
- On the Catalogue → Publications screen, press New publication.
- Select the record's type from the list that opens.
- In the Title and abstract section, type the record's title on the Türkçe (Turkish) tab.
- Fill in the other details you know. Fields marked with an asterisk are required.
- Press Create draft.
The record is created as a draft and its own page opens. The page has the Details, Files, Relations and Versions tabs. Save later changes with the Save changes button in the bar at the bottom. The Ctrl+S shortcut (Cmd+S on a Mac) also saves. If you try to leave the page without saving, the panel asks you to confirm first.
Works that the production team released as drafts also arrive in the Publications list with the Draft status. You complete and publish them in the same form.
Sections of the Details tab
| Section | Contents |
|---|---|
| Title and abstract | Title, subtitle, abstract, keywords and translation status in each language |
| Authors and contributors | Authors, editors and other contributors |
| Type-specific information | Fields that depend on the type, and for articles, chapters and proceedings papers also the record's placement |
| Declarations | The article's ethics, conflict of interest and other declarations |
| Basic information | Language of the work, publication year, publisher, publication date, slug and external address |
| Categories | The categories the record belongs to |
| Persistent identifiers | ISBN, ISSN, DOI, Handle and other persistent identifiers |
| Access and licence | Access status, licence, embargo end, licence expiry and rights holder |
| Source and stewardship | Bibliographic source, data steward and, for an imported record, the source system |
Title, abstract and keywords
You write the title and the abstract on the Türkçe and English tabs. The Turkish title is required. If the English title is missing, the tab shows Translation missing and the public site shows the Turkish content. An abstract can have at most 5000 characters. Type the keywords one at a time and press Enter after each one. You can enter at most 20 keywords in each language.
Books, children's books and proceedings papers also have a Table of contents field on the same tab. Write one chapter on each line. The Translation status field of each language is explained in Translation Status.
Type-specific information
| Type | Fields in the section |
|---|---|
| Book | Edition, pages, volume, place of publication, series, series number, textbook, peer review process, Thema subject codes |
| Book chapter | Chapter number, page range, peer review process, Thema subject codes |
| Journal | Abbreviation, first year of publication and a separate journal profile card |
| Article | Article type, article number, page range, received, revised and accepted dates, funding, references |
| Proceedings paper | Event name, year and place, start and end dates, session, page range, video address |
| Thesis | Level (master's, doctoral, proficiency in art, medical specialty or other), institution, graduate school or faculty, department, advisor, degree year, thesis number, pages |
| Children's book | Minimum and maximum age, content kind, illustrator, pages, pedagogical note, suggested activities |
In the references, write one reference on each line. If Series is filled in for a book, series links appear at the top of the book list on the public site. Write the series name the same way in every book, because a difference in upper and lower case creates two separate series. The Content kind field of children's books works as a filter on the children's publications list in the same way.
Placement of the record
For an article, you select the journal and the issue in the Placement section. When you select an issue, the Section heading and Order fields appear. An article is published only while it is in a published issue. To publish it before the issue, see Publishing an Article as Early View.
A book chapter or proceedings paper is linked to a book with the Parent book field. A chapter can be published only when its parent book is published.
Declarations
For articles, the Declarations card holds ethics committee approval, conflict of interest, AI use, informed consent, permissions, data availability and acknowledgements. The declarations are shown on the article page. For articles released from production, the declarations come from the author's declarations in the submission and can be completed in the catalogue.
Basic information, identifiers and access
If you leave the Slug (URL) field empty, the slug is made from the title. Cyrillic, Greek and Georgian
letters are written in Latin letters in the slug. If the title is written in an alphabet that cannot be turned into
Latin letters, such as Arabic, the slug is made from the record's title in another language. If the record has no
title in another language, the slug starts with kayit, so fill in the field yourself. Another record's slug, or an
old address that redirects to another record, cannot be the new slug. A slug made from the title then gets a number at
the end. If you change the slug of a record that was published once, the old address redirects to the new one. The
redirect is set up even when the record is unpublished at the time.
Published records with Feature on the home page ticked are shown among the featured items on the home page. A higher Featured order value comes first. Journal records do not go into this list.
You add persistent identifiers in the Persistent identifiers section with the Add identifier button. ISBN, ISSN and DOI go through format and duplicate checks. These checks are described in Catalogue Rules. Access status, licence and embargo are explained in Access Statuses and Embargo.
Next steps
The Metadata quality card on the right lists what you must complete before publishing. Add the authors as in Adding Authors and Contributors and the files as in Files and Access. When the record is ready, go on to Record Statuses and Publishing.
How-to
Adding Authors and Contributors
Adding authors, editors, translators and other contributors to a catalogue record, ordering them and choosing their institutions and CRediT roles.
You add authors and other contributors in the Authors and contributors section of the record's Details tab. You select the person from the existing person records. If the person is not in the list, you add them as a new person.
Selecting the person
- Type the person's name or ORCID iD in the Add person field.
- Select the right person from the list. A person found by ORCID iD is marked ORCID match.
- If the person is not in the list, select the new person option in the last row.
- When you have added all contributors, press Save changes.
If the warning "Similar people are registered. If it is the same person, pick them from the list; do not create a duplicate profile." appears below the new person option, select the person from the list. Do not create a duplicate person record. The new person record is created when you save the catalogue record. If the ORCID iD you entered already belongs to another person, or there is a person without an ORCID iD with the same name, the system does not create a new record and uses the existing person.
When you select an existing person, the person's current institutions come in as the contributor's institutions. The person's earlier institutions appear in the edit area as options you can add with one click.
Contributor details
The pencil button on a contributor's row opens the edit area:
- In the Role list, select the Author, Editor, Translator, Illustrator, Advisor or Contributor role.
- For a new person, you can fill in the New person's ORCID iD (optional) field.
- Mark the person responsible for correspondence as Corresponding author.
- In the Affiliations (at publication) section, keep or remove the institutions at the date of publication.
- In the CRediT contributor roles section, tick the person's contribution types.
Order and removal
Contributors appear on the public site in the order of the list. Drag the rows to change the order. Remove a contributor with the cross button on the row. The changes are saved when you press Save changes.
Permission needed
Searching for people needs the person management permission. Without this permission, the note "Searching people needs the person management permission." appears below the field. The Catalogue editor and Production coordinator roles have this permission.
Requirements for publishing
A book needs at least one author or editor. An article, a thesis and a children's book need at least one author, and a book chapter and a proceedings paper need at least one contributor. Managing person records is explained in Managing People and Institutions.
How-to
Files and Access
Adding full text, cover and supplementary files to a catalogue record, setting a file's access, embargo and licence, and uploading a new version.
You add a record's full text, cover and supplementary files on the record's Files tab. You choose the file's settings first and then upload the file.
Adding a file
- On the record's page, open the Files tab.
- In the Add file section, select the type of the file from the File type list.
- Set the File language and Access fields.
- If needed, fill in the Display name, Rights holder, Permission reference and File licence fields.
- Drag the file onto the upload area or select it from your computer.
The panel checks the settings before the upload. If the embargo date is missing, an open access file has no licence, the file does not fit the kind or a current file of that kind exists, the upload does not start and the field is marked. Correct the setting and press Try again in the upload area. If the server refuses the file after the upload, the same button attaches the uploaded file without sending it again. Changing the settings during an upload does not change that file's settings.
After the upload the file goes through a virus scan. While the scan runs, the row says Scanning and the page refreshes by itself. The file is not served to anyone before the scan finishes. If the upload stops halfway, the Try again button in the upload area sends the file again. You do not need to select it again.
File types
| Type | Accepted file |
|---|---|
| Full text (PDF) | |
| EPUB | EPUB |
| Cover image | JPG, PNG or WEBP, at most 10 MB |
| Table of contents | |
| Supplementary file | PDF, EPUB, DOCX, ODT, ZIP or an image |
| Other | PDF, EPUB, DOCX, ODT, ZIP or an image |
For the full text, EPUB, cover and table of contents there is one current file in each language. Instead of adding a second file of the same type, upload a new version of the existing file.
Access and licence
In the Access field you select Same as the publication, Open, Embargoed or Restricted. For an embargoed file, Embargo ends is required.
A file's access cannot be more open than the publication's access. The effective access label on the row and the Public or Not public label show the result. The cover image and the table of contents appear on the record page unless their own access is restricted.
File licence stays The publication's licence by default. For a file under a different licence, such as a supplementary file, select the file's own licence. An open-access file needs its own licence or the publication's licence. The rules are explained in Access Statuses and Embargo.
Changing settings, new version and removal
- File settings changes the file's language, display name, access, embargo, rights holder, permission document and licence.
- Upload a new version uploads a new file. The earlier file is not deleted. It is archived and stays in the Earlier versions list.
- Remove (archive) removes the file from the public page. The file stays in the record's history.
A change to access, licence or embargo takes effect on the file links at once. The SHA-256 value of the file at the moment it became public is stored and appears on the row as SHA-256 when published. Changes to file access are written to the audit log.
Display on the public site
An open-access full-text PDF is shown on the publication page in a built-in PDF preview. The reader turns pages, zooms and uses the Fit width button. The preview also works on a phone. If the viewer cannot open, the page shows the browser's own PDF view and an Open PDF link.
If a file does not appear on the site, see A file does not appear on the public page.
How-to
Adding a Related Publication
Linking a catalogue record to another record as book and chapter, translation, supplement, new edition, correction or retraction.
You link a record to another record on the record's Relations tab. The number in the tab's title shows how many relations the record has.
- On the record's page, open the Relations tab.
- Press Add relation.
- In the Other publication field, search for the other record by its title or slug and select it.
- Select the type of the relation from the Relation type list.
- Select the direction of the relation from the Direction list.
- Press Add relation at the bottom of the window.
The relation is saved at once and shown on the tab as a short sentence. The Remove button on the row removes the relation after you confirm.
Relation types
- Part of (book–chapter)
- Translation of
- Supplement to
- Related
- Correction of
- Retraction notice for
- New edition of
Direction of the relation
With This record → the selected record, the record you select becomes a chapter, translation, supplement or new edition of this record. For example, on a book's page you add its chapter with this option. With The selected record → this record, the relation goes the other way. For example, on a chapter's page you select its book with this option.
Rules
- Only book chapters and proceedings papers can be linked to a book.
- A chapter or proceedings paper can belong to only one book.
- A record cannot be linked to itself.
- Chapter, supplement and new edition relations cannot form a loop.
The Parent book field of a book chapter or proceedings paper record creates the same relation with the book. A chapter can be published only when its parent book is published.
How-to
Record Statuses and Publishing
Sending a catalogue record for review, publishing it or returning it to draft, and which actions are open in each status.
Every catalogue record starts as a draft, is sent for review and is published. The status buttons are on the Status card on the right of the record's page and change with the record's status.
Statuses and actions
| Status | Actions open on the card |
|---|---|
| Draft | Submit for review, Delete |
| In review | Publish, Return to draft, Delete |
| Published | Archive, Unpublish, Add a correction notice, Retract |
| Archived | Add a correction notice, Retract |
| Retracted | None, because a retracted record cannot be changed |
While there is an unsaved change, these buttons are disabled.
Sending for review and publishing
- Save the changes on the record's page with the Save changes button.
- On the Status card, press Submit for review and confirm.
- Check that the Metadata quality card says Ready to publish.
- Press Publish.
- Type a reason if you want to, and confirm.
A published record appears on the public site, in search, in the sitemap and in OAI-PMH. The Public page link at the top of the card opens the record's public page. Publishing is written to the audit log.
If the Publish button is disabled or missing, see The Publish button is disabled or missing. The list of required fields is in Catalogue Rules.
Editor approval rule
If the system administrator switched on Catalogue records are published after an editor's approval on the Site settings → Workflow tab, the person who sent a record for review cannot publish it. In that case the card says that you sent the record and that another catalogue editor will publish it.
For a record sent by another editor, the card shows who sent it and when. You review the record and publish it, or you type a reason and send it back with Return to draft. The audit log records the person who publishes as the approver. The rule is explained in Four-Eyes Principle.
Returning to draft
You return a record in review to draft with the Return to draft button. The record leaves review and the editor who prepared it can edit it again. The reason is optional and is written to the audit log.
Permissions needed
Sending a record for review and deleting it need the catalogue edit permission. Publishing, returning to draft, unpublishing and archiving need the catalogue publish permission. Adding a correction notice and retracting are a separate permission.
The Production coordinator role edits records and sends them for review, but cannot publish them. In that case the note "An editor with the publish permission can publish this record." appears on the card.
Actions on a published record
- To take a record off the site or out of the lists, see Unpublishing and Archiving.
- For an error in a published record, see Versions, Corrections and Retractions.
- To change the status of several records at once, see Bulk Actions.
How-to
Bulk Actions
Selecting several records in the Publications list and sending them for review, publishing, returning to draft, unpublishing or archiving them.
You apply the same status action to several records from the Publications list. The system first shows a preview that changes nothing. After you confirm, the action is applied record by record.
- On the Catalogue → Publications screen, find the records with the filters.
- Select the rows with the boxes on the left. The box in the header row selects all rows on the page.
- In the bar that opens above the list, press the button of the action.
- Type the reason. Unpublish and Archive need a reason of at least 5 characters. For the other actions the reason is optional.
- Press Preview.
- In the preview, read the result for each record.
- Press Apply. The button shows the number of records the action will be applied to.
The results are listed in the same window. Successful records change, and records that do not qualify are skipped with their reasons.
Contents of the preview
For each record, the preview says on the row that the action will be applied or why the record will be skipped. An action that will be applied is shown as a status change, for example "In review → Published". The reasons for skipping are these:
- The record's status does not allow the action.
- Fields required for publishing are missing in the record.
- Someone else changed the record after you opened the list.
- The editor approval rule is on, and the record is in draft or you sent it for review yourself.
The preview tries the real action in the same order and then rolls it back. Because of this, its result is the same as the real action's. For example, if a book earlier in the list will be published, that book's chapter also passes in the preview.
Selection and permissions
The selection covers only the rows of the page that is open. When you change the page or the filters, the selection is cleared. Submit for review needs the catalogue edit permission, and the other actions need the catalogue publish permission. Only the buttons of the actions you have permission for appear.
How-to
Unpublishing and Archiving
Taking a published catalogue record off the site, or archiving it to take it out of the lists, and the difference between the two actions.
To take a published record off the site, you use Unpublish. To take it out of the lists but leave it open at its own address, you use Archive. Both actions need the catalogue publish permission and a reason of at least 5 characters. The reason is written to the audit log.
Unpublishing
- On the record's page, press Unpublish on the Status card.
- Type the reason in the Reason (written to the audit log) field.
- Confirm.
The record returns to draft. Its public page no longer opens, and OAI-PMH reports the record as deleted. The file links stop working at once too. You can correct the record and publish it again.
A book with published chapters and a journal with published issues cannot be unpublished. Unpublish the chapters or the issues first.
Archiving
- On the record's page, press Archive on the Status card.
- Type the reason in the Reason (written to the audit log) field.
- Confirm.
An archived record stays open at its own address and can be cited. It leaves the lists, the category pages and search. An archived record cannot go back to published. You can only add a correction notice to it or retract it.
Differences between the actions
| Action | Public page | Lists and search | Afterwards |
|---|---|---|---|
| Unpublish | Does not open | The record leaves them | The record returns to draft and can be published again |
| Archive | Stays open | The record leaves them | Cannot go back to published. It can get a correction notice or be retracted |
| Retract | Stays open with a retraction notice | The record leaves them | Cannot be undone, the files are closed |
Retraction and correction notices are explained in Versions, Corrections and Retractions.
Several records
You can select several records in the Publications list and apply the same action. The steps are in Bulk Actions. If many records are unpublished within a short time, the system administrators get an operations alert. If you plan a bulk correction, tell the system administrator beforehand. The details are in Operations Alerts.
How-to
Deleting a Catalogue Record
Deleting a catalogue record in draft or in review, restoring it from the trash, and the records that cannot be deleted.
Only records in draft and in review can be deleted. A deleted record goes to the trash, does not appear on the public site and can be restored with the Show deleted filter.
- On the record's page, press Delete on the Status card. The row menu in the Publications list has the same action.
- Type a reason of at least 5 characters in the Reason (written to the audit log) field.
- Confirm.
The deletion and its reason are written to the audit log.
Restoring a deleted record
- On the Catalogue → Publications screen, tick the Show deleted box.
- In the record's row menu, select Undo delete.
The Undo delete button on the record's own page does the same. A deleted record cannot be edited until it is restored.
Records that cannot be deleted
- A published record cannot be deleted. Unpublish the record first.
- Archived and retracted records remain part of the scholarly record and cannot be deleted.
- Deleting a record that was published before also needs the catalogue publish permission.
- A journal record with issues cannot be deleted. Delete the journal's issues first.
To delete a journal issue together with its articles, see Deleting a Journal Issue.
How-to
Versions, Corrections and Retractions
Viewing a record's version history, comparing two versions, going back to an earlier version, adding a correction notice and retracting the record.
Every change to a record is kept as a version that cannot be altered. You view an earlier version on the record's Versions tab and go back to it if needed. For an error in a published record, you add a public correction notice. For a serious problem, you retract the record.
Version history
The Version history table on the Versions tab shows each version's number, date, the person who made the change, the note and the status at that moment. The top row is the current version.
- The eye button on a row (View content) shows all filled fields of that version.
- The Compare with the current record button on a row shows what has changed since that version.
Comparing two versions
- Tick the boxes on the rows of the two versions you want to compare.
- Press Compare.
Each changed field appears in the Before and After columns. In the contributor, category, identifier and keyword lists, removed items are struck through and added items are shown in green. A later change to the name of a person or a category does not count as a change to the record.
Going back to an earlier version
- If the Details tab has unsaved changes, press Save changes or Discard changes.
- Press the Restore button on the version's row.
- Confirm in the Restore this version window that opens.
The titles, contributors, identifiers and other details return to their state in that version. The record's status, address and files do not change. Going back also creates a new version.
Going back puts the version's details in place of those in the form. An unsaved change is not in the version history. So while there are unsaved changes, the Restore buttons are disabled and a note at the top of the tab says what to do.
A category or person merged since that version comes back as the record it was merged into. A category, person or institution deleted since, a peer-review process removed from the settings, a licence no longer in use and an identifier another record holds now are not brought back. The restore still happens, and the notification lists what was not brought back. An article in an issue keeps its issue's journal.
Correction notice
A correction notice is used on a published or archived record and is shown to everyone on the publication page.
- On the Status card, press Add a correction notice.
- In the Public notice (Turkish) field, type the text readers will see.
- If you want, fill in the Public notice (English) field too.
- If you want, type the internal reason in the Internal reason (audit log only) field.
- Press Add a correction notice.
The public notice must have at least 10 characters in at least one language. If the record already has a correction notice, the window loads it, and the text you save replaces the earlier notice.
Retraction
A retracted record stays public, and its page shows a retraction notice. Access to its files is closed. A retraction cannot be undone, and a retracted record can no longer be changed.
- On the Status card, press Retract.
- Type the retraction notice in the Public notice (Turkish) field.
- If you want, type the English notice and the internal reason.
- Press Retract at the bottom of the window.
Permissions needed
Everyone who can see the record can see its version history. Going back to an earlier version needs the catalogue edit permission. Adding a correction notice and retracting are a separate permission, which the Catalogue editor role has.
How copyright and correction reports from the public site are resolved is explained in Copyright and Correction Reports.
How-to
Copyright and Correction Reports
Reviewing copyright infringement and correction reports from the public site's contact form, taking them up and recording the outcome.
Copyright infringement and correction reports from the public site's contact form reach you as a panel notification and by e-mail. The e-mail does not carry the content of the report. It only links to the panel. You resolve the report on the Catalogue → Copyright and correction reports screen.
- Open the Catalogue → Copyright and correction reports screen.
- Press Open on the report's row.
- Read the message. The Open publication link opens the record the report is about.
- In the New status section, select Start handling or Resolve and close.
- In the Outcome / action taken field, write what you did. This field is required when you close the report.
- If you want, fill in the Reason (written to the audit log) field.
- Press Update.
The outcome is also written to the audit history of the publication concerned. Opening the message counts as access to personal data and is written to the audit log. You send your answer to the sender from your own e-mail. The window shows the sender's address.
Outcome of the report
If the report is justified, correct the record and add a correction notice or retract the record as in Versions, Corrections and Retractions. If the copyright infringement is in a file, you can remove the file or restrict its access as in Files and Access.
Message visibility by role
On this screen the catalogue editor sees only copyright and correction reports. Content editors answer general contact messages. If you also have the content editor role, all messages are on the Institutional content → Contact messages screen. The details are in Contact Messages.
How-to
Downloading Crossref XML
Downloading the Crossref XML file of a catalogue record or a journal issue for DOI registration, and the conditions the file needs.
To upload to Crossref by hand, you download the Crossref XML file of a record or of a journal issue. The file is made only for public records that have a DOI. If your institution's automatic DOI registration is on, records go to Crossref by themselves and you do not need this file.
The file of a record
- On the record's page, find the Record information card on the right.
- Press Download Crossref XML.
The button appears on article, book, book chapter and proceedings paper records. An article's file also carries the details of its journal and its published issue. An article in early view has no issue yet, and its file is made with the details of its journal only. The file of an article whose issue went back to draft carries no issue details.
A book's file carries all the book's ISBNs. A number obtained through an ISBN request is written as print or electronic, depending on the form of the request. A number typed into the catalogue by hand counts as print.
The file of an issue
- Open the issue's page.
- Press the Crossref XML button at the top of the page.
The issue's file contains every public article of the issue that has a valid DOI. Articles without a DOI are left out of the file. The file needs a published journal record and a published issue.
Conditions for the file
- The record must be published, archived or retracted.
- The record must have a DOI.
- If a DOI prefix is entered in the site settings, the DOI must start with that prefix.
- A thesis must have an author and the institution where it was written.
If a thesis's institution is not typed in but only linked to an institution record, the institution's name and ROR ID come from that record. Imported theses may be like this. If the institution record was deleted, the thesis's file is not made.
Crossref accepts only two-letter ISO 639-1 codes as languages. Ottoman Turkish has no such code. The file does not state the language of a record or a title in that language.
An article's file also contains its reference list. References that mention a DOI in their text are written with their DOIs. If the system administrator switches off the Crossref XML export feature, the file cannot be downloaded.
Sending records to Crossref automatically is explained in Automatic DOI Registration.
How-to
Preparing a Book for DOAB
Completing an open-access book to meet DOAB's requirements and downloading the ready books in DOAB's Excel template.
DOAB (Directory of Open Access Books) accepts only books that passed independent external review before publication, carry an open licence and have their own ISBN. The Catalogue → DOAB readiness screen shows whether each book and chapter is ready for DOAB and what it lacks.
Completing the book
- If the press's peer review processes are not defined, ask the system administrator to define them on the Site settings → Peer review tab.
- In the book's record, select the process the book went through in the Peer review process field of the Type-specific information section.
- Enter at least one Thema code in the Thema subject codes field. Separate several codes with semicolons.
- On the English tab, write the abstract and the keywords.
- In the Access and licence section, set the access to Open access and select an open licence.
- Add an ISBN to the book.
- On the Files tab, upload the public full-text PDF.
- Save the changes and publish the book.
The selected process must include external review before publication. DOAB requires this review. The steps for getting an ISBN are in ISBN Process.
Downloading the template
- On the DOAB readiness screen, check that the book's row says Ready.
- Press Download DOAB template.
The file contains DOAB's template sheet, a PRISM sheet that shows the books' peer review processes and a check sheet that lists what every book lacks. By default only ready books go into the template sheet. If you tick the Also published books that are not ready box, published books that are not ready go in as well.
DOAB takes books by hand or through this template and does not harvest the press's OAI-PMH. Send the file to the DOAB team after DOAB has accepted the press. The parts of the screen are described in DOAB Readiness.
Screens and settings
Publications
The list of catalogue records with its search box, filters, columns, row menu and bulk action bar.
The Catalogue → Publications screen lists all draft, in-review and published records in the catalogue. Opening a new record, finding a record and applying the same action to several records all start here.

Buttons at the top
- New publication opens a new record of the type you select and needs the catalogue edit permission.
- Bulk import opens the bulk import screen and needs the bulk import permission.
Search and filters
The search box searches the record's titles and subtitles in every language and its slug. Turkish letters do not matter, and a search for "isik" also finds a draft titled "Işık". The characters % and _ are searched as they are typed, so a search for "50%" finds only titles that contain "50%". The filters are these:
| Filter | Options |
|---|---|
| Type | The seven record types |
| Status | Draft, In review, Published, Archived, Retracted |
| Access | Open access, Metadata only, Embargoed, Restricted |
| Missing data | No licence, No category, No abstract, No English translation |
| Year | A four-digit publication year |
| Sort | Recently updated, Recently added, By slug (A–Z), Year (newest first), Year (oldest first) |
| Show deleted | Records in the trash |
The filters stay in the address bar. If you share the link, the same list opens. If you come from a category's menu on the Categories screen, the list is filtered by that category.
Columns
| Column | What it shows |
|---|---|
| Publication | Title, authors and the first identifier. A missing translation, a deleted record and a record you sent for review are marked with a label |
| Type | The record's type |
| Status | The record's status |
| Access | Access status |
| Year | Publication year |
| Updated | Time of the last change |
Row menu
The menu at the end of a row shows the actions that suit the record's status:
- Edit opens the record's page.
- In draft, Submit for review and Delete appear.
- In review, Publish, Return to draft and Delete appear.
- When published, Archive and Unpublish appear.
- For public records, Open the public page opens the record's page on the public site.
- For a deleted record, only Undo delete appears.
If the editor approval rule is on in your installation and you sent the record for review, the Publish (another editor publishes it) item in the menu is disabled.
Bulk action bar
When you select rows with the boxes on the left, the bulk action bar opens above the list. The bar has the Submit for review, Publish, Return to draft, Unpublish and Archive buttons. The steps are in Bulk Actions. When you change the page or the filters, the selection is cleared.
Related topics
Screens and settings
New Publication
The screen where you choose the type of a new catalogue record, fill in its first details and create the draft.
The New publication screen asks for the type of a new catalogue record and opens the form where you fill in the record's first details. You reach the screen with the New publication button in the Publications list.
Choosing the type
The screen asks "What kind of record are you creating?" and lists the seven types with their descriptions:
| Type | Description |
|---|---|
| Book | Printed or digital book; needs an author or editor, a year and a category. |
| Book chapter | A chapter of a book; needs the parent book and its order. |
| Journal | Journal profile: scope, ISSN, submission and review settings. |
| Article | Journal article; needs an abstract, keywords and an issue. |
| Proceedings paper | Conference paper; needs the event name and year. |
| Thesis | Master's, doctoral, proficiency in art or medical specialty thesis; needs the institution and level. |
| Children's book | Science title for children; needs the target age and content kind. |
If you select a type from the drop-down list of the New publication button, this step is skipped and the form opens directly.
The form
When the type is chosen, the record's form opens. The form has all the sections of the Details tab of the record page. The sections are described in Creating a Catalogue Record. Files, relations and versions open on their own tabs after the record is created.
The bar at the bottom reminds you that fields marked with an asterisk are required. The Create draft button creates the record and opens its page.
Rules of the screen
- The type cannot be changed later.
- The record is always created as a draft.
- The Turkish title is required, and the title in each language must have at least 2 characters.
- If the access status is open access, a licence is required. If it is embargoed, an embargo end date is required.
- For a journal managed on DergiPark (Türkiye's national journal platform), the DergiPark address is required.
- Opening a journal record also needs the journal management permission.
Fields that cannot be saved are listed by name in the notification at the bottom right, and the page scrolls to the first field with an error.
Screens and settings
Catalogue Record
The page of a catalogue record, its tabs, the status, quality and record information cards on the right, and the save bar.
The page of a catalogue record shows all of the record's details, files, relations and versions together. You open the page by pressing the record's title in the Publications list. Next to the title you see the record's type, status, slug and any missing translation.

Tabs
| Tab | Contents |
|---|---|
| Details | Title and abstract, contributors, type-specific information, basic information, categories, identifiers, access and licence |
| Files | Full text, cover and supplementary files, the files' access and their earlier versions |
| Relations | Book and chapter, translation, supplement, new edition, correction and retraction relations |
| Versions | The record's version history, comparison and going back to an earlier version |
Cards on the right
- The Status card shows the record's status and access, the link to the public page and the actions open in that status. For a record in review it also shows who sent it for review and when.
- For a retracted or corrected record, a separate card shows the Retraction notice or Correction notice text with its date.
- The Metadata quality card shows the quality score out of 100, whether the record is ready to publish, and the Required and Recommended gaps. For articles the TR Dizin data checks warnings are here too.
- The Record information card has the time of creation, last update and first publication, the record's version number and, for an imported record, a link to the import. For the types that support it, the Download Crossref XML button and the Crossref DOI registration line are on this card too.
- On book, children's book, proceedings paper and thesis records, people with an ISBN permission see the ISBN requests card.
Save bar
When you change a field on the Details tab, a bar that says "There are unsaved changes" opens at the bottom. Save changes saves the changes, and Discard changes returns to the last saved state. The Ctrl+S shortcut (Cmd+S on a Mac) also saves. If you try to leave the page without saving, the panel asks you to confirm first.
Rules of the screen
- While there are unsaved changes, the status buttons and the Restore buttons on the Versions tab are disabled.
- While a status action runs, the other status buttons are disabled. If you press Save changes meanwhile, your changes are saved once the action is done. What you type while the action runs is not lost.
- If you have no permission to edit the catalogue, the record is view-only and a note at the top of the page says so.
- A retracted record cannot be changed. A deleted record cannot be edited until it is restored.
- On a thesis harvested from the institutional repository, a note at the top of the form says it came from the repository. The fields and files that come from the repository cannot be changed, and an earlier version cannot be restored. The categories, featuring and relations can be changed. The details are in Harvested Theses.
- If someone else changed the record while you were editing, saving stops and the "Someone else changed this record" window opens. Reload the page with Reload and make your change again.
Related topics
Screens and settings
Data Quality Screen
The filters and columns of the screen that lists catalogue records by metadata quality score, its Fix button and the CSV file.
The Catalogue → Data quality screen lists catalogue records by their metadata quality score. The record with the lowest score is at the top. You choose a problem and correct the records that have it one by one. How the score is calculated is explained in Data Quality.
Filters
| Filter | Options |
|---|---|
| Problem | The problems are listed in three groups, each with the number of records that have it. Blocks publishing, Recommended field missing, TR Dizin checks |
| Type | The seven record types |
| Status | Record statuses |
| Score | All scores, Below 80, Below 60, Below 40 |
The TR Dizin checks group appears only for articles. TR Dizin is Türkiye's national citation index.
Columns
| Column | What it shows |
|---|---|
| Publication | Title, type, status, year and authors |
| Score | Score out of 100. If the record cannot be published, Cannot be published appears below it |
| Problems | The first three problems and the number of the rest |
The Fix button on a row opens the record. If all of the record's problems concern files, the record's Files tab opens. When you correct and save the record, the score is calculated again.
CSV file
The Download CSV button downloads all rows that match the selected filters. The file has the record's ID, type, status, title, score, missing required and recommended fields, TR Dizin warnings and a link to the panel.
Rules of the screen
- The report scores the 2000 most recently changed records. When more records match the filters, a note at the top of the screen says so. Filter by type or status to see older records.
- Deleted records do not go into the report.
- The list is shown page by page, while the CSV file contains all rows.
Screens and settings
DOAB Readiness
The screen that checks books and chapters against the DOAB requirements, with its cards, its table, the gaps it checks and the template download button.
The Catalogue → DOAB readiness screen checks the books and chapters in the catalogue against the requirements of DOAB (Directory of Open Access Books). Ready records are at the top, and the others show what they lack. Ready books are downloaded in DOAB's Excel template.
Buttons at the top
- Download DOAB template downloads one XLSX file with DOAB's template, a PRISM sheet that shows the books' peer review processes and a check sheet that lists what every book lacks.
- If Also published books that are not ready is ticked, published books that are not ready also go into the template sheet.
The press's requirements
The card titled The press's requirements ticks off what DOAB expects from the press:
- A peer review process with external reviewers before publication must be defined and published on the site.
- At least three books must be ready for DOAB. Chapters do not count here.
- The address and e-mail address of the press must be on the site.
- The site must open over HTTPS.
- Editors and editorial board members must be listed on the site with their institutions. You check this line yourself.
If you have permission to manage the site settings, the card shows the Edit the peer review processes link.
Readiness count and table
The card next to it shows how many books are ready and how many records have each of the gaps that keep books out of DOAB. The table has these columns:
| Column | What it shows |
|---|---|
| Publication | Title, type, status, year and Thema codes |
| State | Ready or the number of gaps |
| Missing | What the record lacks |
| Peer review | The peer review process selected for the record |
The Fix button on a row that is not ready opens the record. If the only gap is the full text, the record's Files tab opens.
Gaps the screen checks
- The record is not published or not open access.
- There is no open licence. "All rights reserved" does not meet DOAB's terms.
- There is no public full-text PDF. This check runs only on published records.
- The book has no ISBN. A chapter goes into DOAB with its book's ISBN. That is why the book's ISBN is checked for a chapter.
- No peer review process is selected, or the process has no external review before publication.
- There is no English abstract or there are no English keywords.
- There is no Thema subject code or no publication year.
In the template, a chapter's row carries the title and the ISBN of its book. The screen checks the 2000 most recently changed books and chapters that are not deleted. The steps for preparing a book are in Preparing a Book for DOAB.
Concept
Data Quality
The metadata quality score out of 100 of a catalogue record, the required and recommended fields, and the TR Dizin data checks for articles.
Every catalogue record has a metadata quality score out of 100. The score shows how complete the record is. A record with a missing required field cannot be published. Recommended fields do not block publishing, but they help the record to be found, indexed and cited correctly.
Score calculation
Required fields make up 60 points of the score and recommended fields 40. Each missing required field lowers the score by 12. The points for recommended fields depend on the share of fields that are filled in. When you correct and save the record, the score is calculated again.
Required fields
The required fields depend on the record's type. The list for each type is in Catalogue Rules. The record's Metadata quality card lists the missing required fields under the Required heading. When nothing is missing, the card says Ready to publish.
Recommended fields
For every type, an English title, an abstract, an English abstract, keywords, a licence and a persistent identifier are recommended. For all types except journals, the rights holder, the publication year, ORCID iDs for all authors, the authors' institutions and a full-text file are recommended too. A record whose access is metadata only is not expected to have a full text.
| Type | Extra recommended fields | Expected persistent identifier |
|---|---|---|
| Book | Publisher, category, cover image | ISBN-13 |
| Children's book | Publisher, category, cover image | ISBN-13 |
| Journal | Publisher, category, cover image | ISSN or e-ISSN |
| Proceedings paper | Publisher, category | DOI or ISBN-13 |
| Thesis | Publisher, category | Handle, DOI or another identifier |
| Book chapter | No extra field | DOI or ISBN-13 |
| Article | No extra field | DOI |
TR Dizin data checks
For articles, the card also shows the TR Dizin data checks warnings. TR Dizin is Türkiye's national citation index. These warnings check details such as the English abstract, the authors' ORCID iDs and institutions, the received and accepted dates, the references, the ethics committee statement and the DOI. The warnings do not block publishing the record. If the journal makes the TR Dizin check mandatory, they block publishing the issue. The details are in Preparing for TR Dizin.
Finding the gaps
The Data Quality Screen lists the gaps in the whole catalogue by score. The Missing data filter in the Publications list also finds records with no licence, no category, no abstract or no English translation.
Concept
Translation Status
Whether a record's title and abstract in each language are in the original language of the work or a translation, and how the public site shows this.
The translation status tells whether a record's title and abstract in each language were written in the language of the work or are a translation. Readers can then tell the original text from a translation.
Default status
Each language tab has a Translation status field with the value Original language or Translation. Unless you choose otherwise, the text in the language of the Language of the work field counts as original and the other languages count as translations. If you change the language of the work, the default status changes too.
If you choose something other than the default, your choice is saved and kept even when the language of the work changes. For example, for a work published in two languages you can select Original language on both language tabs.
Display on the public site
When a reader opens a publication in a translated language, the note "Title and abstract are a translation" and the original language of the work appear below the title. Abstracts in the other languages carry a "translation" mark.
Missing translation
If a language has no title, the panel shows Translation missing on that language's tab. In the Publications list the record carries the EN missing or TR missing label. For a missing language the public site shows the Turkish content.
Concept
Catalogue Rules
The rules the system applies to catalogue records, the required fields of each type, identifier checks, address redirects and the reason rule.
The system applies the rules below to catalogue records by itself. A save or publish that breaks a rule stops, and the panel gives the reason with the name of the field.
Required fields by type
Every record needs a title, the language of the work and an access status. An open-access record also needs a licence, and an embargoed record needs an embargo end date. An open-access record whose licence has expired cannot be published. The extra fields for each type are these:
| Type | Also needed for publishing |
|---|---|
| Book | At least one author or editor, publication year, at least one category |
| Book chapter | At least one contributor, a published parent book, the chapter's order |
| Journal | Scope, publisher |
| Article | At least one author, abstract, keywords, a published issue or early view |
| Proceedings paper | Event name, publication year or event year, at least one contributor |
| Thesis | At least one author, institution, publication year, level |
| Children's book | At least one author, target age, content kind |
An article's year must be the same as the year of its issue. The article's journal must be published too.
A published record keeps these rules while it is edited. A published article cannot leave its issue, cannot move to an unpublished issue, and its year cannot differ from the issue's year. A published chapter cannot leave its book and cannot be linked to an unpublished book. For such a change, unpublish the record first.
Persistent identifiers
- ISBN, ISSN and DOI are checked for their format, and the check digit of ISBN and ISSN is checked too.
- If you enter an ISBN-10, the number is stored as an ISBN-13.
- When an ISBN is saved, it is hyphenated according to the international ISBN range list, for example 978-975-491-495-5.
- The same identifier cannot be used in two separate records.
- The ISSN and e-ISSN of a journal record come from the journal profile.
Addresses and redirects
If a record's Slug (URL) field changes, the old address redirects to the new one. Old addresses also redirect to the new ones for the slugs of people, institutions and categories, for merged people and categories, and when the volume or issue number of a published issue changes.
Records that cannot be unpublished
- A book with published chapters cannot be unpublished.
- A journal with published issues cannot be unpublished.
- An issue with published articles cannot be unpublished.
Unpublish the linked records first.
Reason and notice
Unpublishing, archiving and deleting need a reason of at least 5 characters. For a retraction or correction notice, the public notice must have 10 characters in at least one language. Reasons are written to the audit log.
Simultaneous editing
If someone else changed a record while you were editing it, saving stops. In the window that opens, reload the page and make your change again. This way nobody overwrites someone else's change.
Audit log
Publishing, unpublishing, retraction, merges, imports and changes to file access are written to the audit log. The log cannot be changed. The details are in Audit Log.
Two-factor authentication
If the system administrator made two-factor authentication mandatory for privileged roles, your catalogue permissions do not work until you set it up. You set it up on the My profile → Security tab, as explained in Using Two-Factor Authentication.
Operations alerts
The system administrators get an alert when, within a short time, many records are unpublished or retracted, or many records that were published before are deleted. The threshold and the time window are in Operations Alerts.
Concept
Automatic DOI Registration
How DOIs that start with the institution's prefix are sent to Crossref by themselves, the status line on the record page and sending at once.
If the system administrator switched on automatic DOI registration, records whose DOI starts with the institution's prefix are sent to Crossref by themselves. They are sent when the record is published and after every later metadata change. The record's state appears on the Crossref DOI registration line of the Record information card on the right.
The status line
| State | Meaning |
|---|---|
| Pending | The record is in the queue to be sent, or will be tried again after an error |
| Sent | Crossref received the file. If the file went to the test system, the line says so too |
| Error | Sending failed. The line gives the reason |
| Not sent | The record has not been sent yet |
The Sent state shows that Crossref has received the file. Crossref usually processes the file within a few minutes. JournTech reads the result from Crossref and writes it under the line:
- If Crossref confirmed the registration, the date of the confirmation shows.
- If Crossref confirmed it with a warning, the warning itself shows in English.
- If Crossref refused the record, the state becomes Error and Crossref's explanation shows.
- If the result cannot be read within a day, the line says so.
Crossref also reports the result to the institution's DOI registration e-mail address. The line appears only while the feature is on, or if the record was sent before.
When sending fails, the line gives the reason:
- If the record breaks a Crossref rule, the fields to fix are listed. The record is sent again at its next change.
- If Crossref refused the deposit login, check the Crossref account in Site settings.
- If Crossref did not accept the deposit, the HTTP code shows, with Crossref's own answer below it.
- If the Crossref server could not be reached, sending is tried again later by itself.
- If Crossref refused the record when it processed the file, Crossref's explanation shows in English. Fix the record; it is sent again at its next change.
Records that are not sent
The line gives the reason a record cannot be sent in one of these sentences:
- Only public records are sent.
- The record has no DOI; add one under Identifiers.
- No DOI prefix is set in the site settings.
- The DOI does not start with the registrant prefix; it is registered elsewhere.
- The record was harvested from DergiPark, which registers its DOI.
When you correct the record, it is sent again.
Sending at once
If you have the catalogue publish permission, the Send now button puts the record in the queue at once. The record is sent again even if it has not changed since it was last sent. Edits made one after another within half a minute go to Crossref together in one deposit. If Crossref cannot be reached or is busy, the deposit is tried again in the background. If Crossref rejects the institution's Crossref credentials, or the record does not meet Crossref's rules, the state becomes Error at once.
Switching the feature on is explained in Configuring Automatic DOI Registration. To upload by hand, download the file as in Downloading Crossref XML.
Concept
Access Statuses and Embargo
The open access, metadata only, embargoed and restricted access statuses of a catalogue record, the licence rule and how an embargo ends by itself.
A record's access status decides what a reader can open on the public site. You select the access status in the Access status field of the record's Access and licence section. The record's files follow this status, and a file's own setting can only make it more closed.
Access statuses
| Status | Meaning | Extra condition |
|---|---|---|
| Open access | Files are open to everyone. | A licence is required |
| Metadata only | Only the bibliographic data and abstract are shown. | The default for new records |
| Embargoed | Files open when the embargo ends. | An embargo end date is required |
| Restricted | Files are closed to the public. | None |
Licence
An open-access record cannot be published without a licence. The Licence list shows the licences that are active on the platform. If you select a licence that does not allow open access, for example "All rights reserved", a warning appears below the field. An open-access record whose Licence valid until date has passed drops to Metadata only by itself.
End of the embargo
For an embargoed record, Embargo ends is required. When the date comes, the record becomes open access by itself. If the record has no licence, it changes to Metadata only instead of open access. File access goes by the date, and a file whose embargo ends opens on that day.
If a file was given its own embargo, the file follows the publication's access again when the embargo ends.
Access of a file
A file's access cannot be more open than the publication's access. For example, a file set to open on a record with metadata only access stays closed to the public. The cover image and the table of contents are the exception. They appear on the record page unless their own access is restricted.
For a file to become public, the record must be published, and the file must have passed the virus scan and be the current version. An open file needs its own licence or the publication's licence.
Retraction and unpublishing
Access to the files of a retracted record is closed. The cover and the table of contents stay visible. The file links of an unpublished record stop working at once.
When changes take effect
A change to access, licence or embargo takes effect on the file links at once. Browsers and proxy servers check their copy of an open file with the server each time it is opened, and do not show the old copy after a change. Changes to file access are written to the audit log.
Concept
Four-Eyes Principle
The rule that the person who prepares a piece of work does not approve it, and the three places where JournTech applies it.
Under the four-eyes principle, the person who prepares a piece of work does not approve that same work. At least two people see each publishing decision, so fewer records are published and fewer requests are approved by mistake. JournTech applies this principle in three places.
Catalogue records
If the Catalogue records are published after an editor's approval switch on the Site settings → Workflow tab is on, a record is published only from review. The person who sent the record for review cannot publish it, and another catalogue editor publishes it. The audit log records the person who publishes as the approver.
The switch is off by default. While it is off, the person who sent the record for review can also publish it.
Releasing an accepted submission from production into the catalogue is outside this rule, because that step is already an editorial decision. Harvesting from DergiPark (Türkiye's national journal platform) and bulk import are not affected by the rule either.
Institutional content
If the Institutional content is published after review switch on the same tab is on, pages, policies and guides are published or scheduled only from review. The person who sent the content for review cannot publish it. Another editor with the publish permission publishes it.
ISBN requests
For ISBN requests the rule always applies, and no setting switches it off. A person who prepared the request, edited it after the last approval, took it back to draft or sent it for approval cannot approve the same request. The system administrator role does not carry the approval permission. An administrator who serves on the publishing board is given the Publishing board role as well.
Troubleshooting
The Publish button is disabled or missing
Why the Publish button of a catalogue record cannot be pressed or does not appear at all, and how to fix it.
The Publish button depends on the record's status, unsaved changes, required fields and the approval rule of your installation. Check the reasons below in order.
There is an unsaved change
While there is an unsaved change, the status buttons are disabled. Press Save changes in the bar at the bottom first.
The record is not in review
The Publish button works only for a record in review. Send a draft record for review first with the Submit for review button on the Status card.
A required field is missing
If the Metadata quality card does not say Ready to publish, complete the gaps the card lists. The required fields depend on the type. For example, an article needs an author, an abstract, keywords and a published issue.
You sent the record for review
If the editor approval rule is on in your installation and you sent the record for review, the Publish button does not appear. The card says that another catalogue editor will publish the record. Ask another catalogue editor to publish it, or take your request back with the Return to draft button. The rule is explained in Four-Eyes Principle.
The article is not linked to an issue
An article is published only when it is in a published journal issue, or as early view in its journal. Place the article in an issue. If the issue is not published yet, publish the issue first, or publish the issue together with the article. The details are in An article cannot be published until it is placed in an issue.
You have no publish permission
The Production coordinator role edits catalogue records but cannot publish them. Ask a catalogue editor to publish the record.
Troubleshooting
An article cannot be published until it is placed in an issue
If an article record does not publish because of an issue warning, place the article in an issue, publish it together with the issue or use early view.
An article is published only while it is in a published journal issue, or as early view in its journal. Until then, the record's Metadata quality card lists the issue as a missing required item. Follow the section below that matches the warning on the card.
The article is not placed in an issue
The warning "Place the article in an issue, or publish it as early view in its journal." appears on the card.
- In the record's Placement section, fill in the Journal and Issue fields.
- Press Save changes.
You can also add the article with the Add article field on the issue's own page. The steps are in Adding Articles to an Issue.
The issue is not published yet
The warning "Publish the issue first, or publish the article together with it." appears on the card. There are two ways:
- Publish the issue first, then publish the article.
- Publish the issue together with its articles with the Also publish draft and in-review articles option.
The steps are in Publishing an Issue.
The journal record is not published
The warning "Publish the journal first." appears on the card. Publish the journal's own catalogue record first. Until the journal record is published, its issues and articles cannot be published.
The article's year differs from the issue's year
The article's Publication year field must match the year of the issue. The card shows the issue's year. Correct the article's year and save.
Publishing without waiting for an issue
To publish the article in its journal without placing it in an issue, use early view. The details are in Publishing an Article as Early View.
Troubleshooting
A record was published by mistake
Taking a catalogue record off the site after it was published by mistake or with missing details, or reporting an error in a published work.
You take a record that was published by mistake off the site with Unpublish. The record returns to draft, its public page no longer opens and its file links stop working at once.
- On the record's page, press Unpublish on the Status card.
- Type a reason of at least 5 characters in the Reason (written to the audit log) field.
- Confirm.
After you correct the record, you can send it for review again and publish it. The steps are in Unpublishing and Archiving.
If the work was really published
If readers have seen and cited a work, do not unpublish it to hide an error. For a small error, add a public correction notice to the record with Add a correction notice. For a serious problem, retract the record with Retract. A retraction cannot be undone. The steps are in Versions, Corrections and Retractions.
Records that cannot be unpublished
A book with published chapters and a journal with published issues cannot be unpublished. Unpublish the chapters or the issues first. An archived record cannot be unpublished. It can only get a correction notice or be retracted.
To restore a detail that was changed by mistake, go back to an earlier version on the Versions tab.
Troubleshooting
An archived record does not appear in lists or search
Why an archived record leaves the public site's lists and search, stays open at its own address and cannot come back from the archive.
An archived record is taken out of the lists, the category pages and search on purpose. It stays open at its own address and can still be cited. This is not an error. It is the purpose of archiving.
Taking a record out of the archive
An archived record cannot go back to published. You can only add a correction notice to an archived record or retract it. Make sure of your decision before you archive a record.
Instead of archiving
If you want to take the record off the site for a while, do not archive it. Use Unpublish instead. An unpublished record returns to draft and can be published again. The difference between the two actions is explained in Unpublishing and Archiving.
Troubleshooting
Reading counts are missing or look too low
Where the view and download counts and the Most read lists on the public site come from, which period they count and when they do not appear.
The reading counts and the Most read lists on the public site come from the site's own visit counters. The counters do not store the visitor's identity or IP address.
The feature is off
If the system administrator switched off the Reading counts and most-read lists feature, neither the counts nor the lists appear. The feature is on the Site settings → Features tab.
Visits that are not counted
Search engine bots are not counted. If the same visitor opens the same record again on the same day, it counts once.
The period counted
- The Views / Downloads line on a publication page shows the record's all-time total. The line appears only when one of the counts is above zero.
- The Most read list on the home page is sorted by the total views and downloads of the last 90 days.
- The Most read list on a journal page counts the last 12 months.
- The Most read sort order in publication lists and in search also counts the last 12 months.
Only published records go into the lists. The lists are refreshed every few minutes. A new reading may not show in a list at once.
Troubleshooting
A file does not appear on the public page
If a full text or supplementary file added to a record does not open on the public site, check the scan, access, embargo, licence and file store reasons in order.
A file's row on the record's Files tab says Public or Not public. If the file is not public, check the reasons below in order.
The virus scan has not finished
The scan status on the row must be Available. If it says Scanning, wait for the scan to finish. The page refreshes by itself. If it says Quarantined, the file did not pass the security scan and is never served. Upload a clean file as a new version.
The record is not published
Files of records in draft or in review are not public. Publish the record. Files of an unpublished record do not open either.
The record's access is closed
If the record's Access status field is Metadata only or Restricted, its files are not public. The file's own setting cannot open them. If the files should be open, set the record's access to Open access.
The embargo has not ended
For an embargoed record or an embargoed file, the file does not open before the embargo end date. The embargo label on the row shows the date.
There is no licence or it has expired
An open file needs its own licence or the publication's licence. A record whose licence has expired drops to metadata only. Check the licence and the date in the record's Access and licence section.
The record was retracted
Access to the files of a retracted record is closed. This is not an error and cannot be undone.
The file is an earlier version
Only the current version is served. Archived files in the Earlier versions list are not public.
The file store does not answer
If the row says Public but the link opens a "Temporarily unavailable" page, the file store is not answering at that moment. The record page and its metadata still open meanwhile. Try again in a few minutes. If the problem persists, tell your system administrator.
The file is missing from the store
If the row says Public but the link opens a "Page not found" page, the file was not found in the store. Upload a new version of the file and tell your system administrator.
All the rules are in Access Statuses and Embargo.
Feature
Journals and Issues
Managing a journal's profile, boards, guidelines and reviewer criteria, and creating and publishing volumes and issues.
Journals are managed on the Catalogue → Journals & issues screen. Every journal is also a catalogue record of the journal type. The issues of a journal cannot be published before the journal record is published.
Issues are created on the journal's Issues tab. Articles are added to the issue and put in order, the issue is checked for consistency, and then it is published. The journal's profile, boards, guidelines and policies are on the other tabs of the same screen.
The editor-in-chief of a journal manages only their own journal and can add only their own journal's articles to an issue. Catalogue editors place the other records. The archive of a journal that is managed on DergiPark (Türkiye's national journal platform) is brought into the catalogue with DergiPark Harvesting.
How-to
Adding a Journal
Opening a new journal record in the catalogue, choosing the submission method and the peer review type, and publishing the journal record.
A new journal is created as a catalogue record of the journal type. After you create the record, you manage the profile, issues and other settings of the journal from the Catalogue → Journals & issues screen.
- On the Catalogue → Journals & issues screen, press New journal.
- In the Title and abstract section, type the name of the journal on the Turkish tab.
- On the Journal profile card, write the scope of the journal in the Scope (TR) field.
- Select a value in the Submissions and Peer review fields.
- If the journal has them, fill in the ISSN (print) and e-ISSN fields.
- In the Basic information section, fill in the Publisher field.
- Press Create draft.
The journal record is created as a draft. Before you publish the issues of the journal, send the journal record to review and publish it. The steps are in Record Statuses and Publishing. The scope and the publisher are required to publish the journal record.
Submission method
| Method | Meaning |
|---|---|
| Through the workspace (JournTech) | Authors send articles with the submission wizard of the panel |
| External platform | Submissions run on the journal's own platform. The External platform address field opens |
| Managed on DergiPark | Submission and peer review run on DergiPark, the national journal platform of TÜBİTAK ULAKBİM. The DergiPark address is required |
| Closed to submissions | The journal does not take submissions |
A journal appears in the submission wizard only if its record is published and its method is Through the workspace (JournTech). Entering the DergiPark address is described in Finding a Journal on DergiPark.
ISSN and categories
The ISSN and e-ISSN are written to the journal profile and added to the persistent identifiers of the record automatically. The check digit is verified. Select the categories of the journal in the Categories section of the record. The categories appear as links to the category page on the journal page and on the card of the journal in the journal list of the public site.
Next steps
Open the journal with Manage journal on the Journals & issues screen. The profile, boards, guidelines and policies are edited there. The details are in Editing the Journal Profile, Adding Board Members and Indexes and Writing Journal Policies. For the first issue, go on to Creating an Issue.
Required permissions
Creating a new journal requires both the permission to edit the catalogue and the permission to manage journals. These permissions belong to the Catalogue editor and System administrator roles. The Editor-in-chief of a journal cannot create journals but manages the profile and issues of their own journal.
How-to
Creating an Issue
Creating a new volume and issue of a journal and entering the year, date, title and special issue details of the issue.
You create a new issue on the Issues tab of the journal. The issue is created as a draft. You publish it after you have added and checked the articles.
- On the Catalogue → Journals & issues screen, open the journal with Manage journal.
- On the Issues tab, press New issue.
- Fill in the Volume, Number and Year fields.
- If you know it, fill in the Publication date field.
- Optionally, enter an Issue title in Turkish and in English.
- If the issue is a special issue, tick the Special issue box.
- Press Create.
The page of the issue opens. Add the articles to the issue as described in Adding Articles to an Issue.
Fields
- Volume is a number. The dialog fills this field with the latest volume of the journal.
- Number has at most 16 characters and can also be a name such as "Special".
- Year is a four-digit year. The year of the articles in the issue must be the same as this year.
- Publication date is needed to publish the issue. You can also enter the date later.
A journal cannot have a second issue with the same volume and issue number.
Changing the issue details
You change the details of the issue on the Issue details card of the issue page. The Editor's note is on this card too. If you change the volume or issue number of a published issue, the old address of the issue redirects to the new one.
Issues without a date
To publish old issues whose date is unknown, a system administrator can turn off the Journal issues need a date to be published switch on the Administration → Site settings → Workflow tab. The switch is on by default.
How-to
Adding Articles to an Issue
Adding articles to a journal issue, ordering the table of contents, writing section headings and removing an article from the issue.
You add articles to an issue on the Table of contents card of the issue page. You can also place an article in an issue from the Placement section of the article's own record.
- On the Catalogue → Journals & issues screen, open the journal with Manage journal.
- On the Issues tab, press Open in the row of the issue.
- In the Add article field, type the title or the short name of the article.
- Select the article in the list.
The article is added to the end of the table of contents and saved at once.
Order and section headings
- Put the articles in order by dragging them or with the arrows.
- If needed, type the section heading in the field in the row of the article, for example "Research Article".
- Press the Save contents button that appears at the top of the card. The button saves the order and the section headings together.
The order and the section headings appear in this arrangement on the issue page of the public site.
Removing an article from the issue
- Press the cross button (Remove from issue) in the row of the article.
- Confirm.
The article record is not deleted. Only its link to the issue is removed. A published article must be unpublished first. An archived or retracted article cannot leave its issue.
Rules
- Only article records can be added to an issue.
- An article can be in only one issue. An article in another issue must first be removed from that issue.
- The editor-in-chief of a journal can add to the issue only the articles of their own journal, that is records released from submissions to the journal. Catalogue editors place the other records.
- The year of the article must be the same as the year of the issue.
- A published article goes only into a published issue. Add an early-view article after the issue is published.
- An article added to the issue moves to the issue's journal and leaves early view. A new version of the article is saved. When automatic DOI registration is on, the article's DOI metadata is sent again with the volume and number.
If an article cannot be added, see An article cannot be added to the issue.
How-to
Publishing an Issue
Running the consistency check on a journal issue, publishing it with its articles or on its own, and unpublishing it.
You publish an issue with the Publish issue button on the issue page. Before publishing, check the issue and its articles with Consistency check.
- On the issue page, press Consistency check.
- Check in the notes at the top of the page that nothing is missing.
- Press Publish issue.
- To publish the articles as well, tick the Also publish draft and in-review articles box in the dialog.
- Press Publish issue in the dialog.
The issue becomes visible on the journal page. Articles are not listed on the issue page unless they are published as well. The notification says how many articles were published together with the issue and how many stayed drafts.
Consistency check
The check verifies the volume, number, year and publication date of the issue, whether the journal record is published and the publishing conditions of each article. The row of an article with problems shows its gaps in red. A separate TR Dizin data checks note lists the warnings of the articles for TR Dizin (Türkiye's national citation index), articles with the same title in the issue and overlapping page ranges.
Publishing with the articles
The Also publish draft and in-review articles option requires the permission to publish in the catalogue. If the option is ticked, the draft articles are sent to review and published together with the articles in review. If an article does not meet the publishing conditions, the issue is not published either, and the check shows the article with problems.
If the editor approval rule is on for the installation, the option is called Also publish the in-review articles. Draft articles stay drafts. If there is an article you sent to review, the issue is not published, and another catalogue editor publishes that article. The rule is described in Four-Eyes Principle.
Publishing conditions
- The catalogue record of the journal itself must be published.
- The volume, number, year and publication date of the issue must be entered. The date rule can be turned off in the site settings.
- If the TR Dizin check is mandatory for the journal, an issue whose article data still has TR Dizin warnings is not published. Details are in Preparing for TR Dizin.
- The year of the published articles in the issue must be the same as the year of the issue.
Unpublishing the issue
- On the issue page, press Unpublish issue.
- Write a reason of at least 5 characters in the Reason (written to the audit log) field.
- Confirm.
If the issue has published articles, it cannot be unpublished. Unpublish the articles first. Publishing and unpublishing are written to the audit log.
Required permissions
Publishing and unpublishing an issue require the permission to manage the journal. The editor-in-chief of the journal can publish the issue. Publishing the articles of the issue, however, requires the permission to publish in the catalogue, which the Catalogue editor role has.
How-to
Deleting a Journal Issue
Deleting a journal issue while keeping its articles in the catalogue, or together with its articles.
You can delete an issue even if it has been published. The articles of the issue either stay in the catalogue as drafts or go to the trash together with the issue. A deleted issue cannot be restored.
- On the Catalogue → Journals & issues screen, open the journal with Manage journal.
- On the Issues tab, press the trash button in the row of the issue. The Delete issue button on the page of the issue opens the same dialog.
- The dialog shows how many articles the issue has and how many of them are published. Under
The issue's articles, select an option.
- With Keep the articles in the catalogue, the articles leave the issue and return to draft. You can place them in another issue later. Published articles do not appear on the site until they are published again.
- With Delete the articles too, the articles move to the trash. They can be restored with the Show deleted filter of the Publications list.
- If the issue is not an empty draft, write a reason of at least 5 characters in the Reason (written to the audit log) field.
- Press Delete issue.
Issues that cannot be deleted
If the issue contains an archived or retracted article, the issue cannot be deleted, because these articles stay part of the publication record. In this case the dialog shows how many articles block the deletion.
Required permissions
Deleting an issue requires the permission to manage the journal. Unpublishing the published articles requires the permission to publish in the catalogue, and deleting the articles requires the permission to edit the catalogue. All these permissions belong to the Catalogue editor role.
The Editor-in-chief of a journal cannot delete an issue that has published articles. In this case the dialog says that a catalogue editor can delete the issue.
Effects of deletion
- When a published issue is deleted, the page of the issue is removed from the site.
- If a published article has a DOI, the DOI link no longer opens the article.
- If the journal is harvested from DergiPark, later harvests do not take the deleted articles in again.
- The issue placement of the production jobs planned for the issue is cleared.
- The deletion is written to the audit log together with the details of the issue and the list of its articles.
If needed, you can create a new issue with the same volume and issue number.
How-to
Editing the Journal Profile
Editing the ISSN, scope, submission method, peer review type, publication facts and contact details of a journal on the Profile tab.
The journal profile shapes the journal page on the site and sets where the journal takes submissions from. You open the journal with Manage journal on the Catalogue → Journals & issues screen and edit the profile on the Profile tab.
Profile fields
- Enter the ISSN (print) and e-ISSN. The system verifies the check digit.
- Write the aims and scope of the journal in the Scope (TR) and Scope (EN) fields. Each language takes up to 5,000 characters. You can write a long text in a larger window with the Write in a larger window button next to the field.
- In the Submissions list, select the way the journal takes submissions. The options are described below.
- In the Peer review list, select Double-anonymous, Single-anonymous or Open review.
- Fill in the Publication facts and Journal contact details sections.
- Press Save.
The peer review type of each submission is recorded when the author first submits it. A change you make later applies only to new submissions. The difference between the types is explained in Peer Review Types.
Submission methods
| Option | Result |
|---|---|
| Through the workspace (JournTech) | Authors submit through the panel. A published journal appears in the journal list of the submission wizard |
| External platform | Submissions run on another platform. The External platform address field opens and the journal page links to that address |
| Managed on DergiPark | Submission and peer review run on DergiPark, the national journal platform of TÜBİTAK ULAKBİM. The DergiPark fields open |
| Closed to submissions | The journal does not take submissions |
Submissions through the panel are possible only for journals set to Through the workspace (JournTech).
Journal managed on DergiPark
For a journal whose submission and peer review run on DergiPark, set the Submissions field to Managed on DergiPark. With this option the DergiPark address or short name and DergiPark journal number fields open in the profile. The profile is not saved without the address. Authors cannot submit to this journal through the panel, and the submit button on the site opens the submission page on DergiPark.
The steps for entering the address and finding the journal are in Finding a Journal on DergiPark. To bring the DergiPark issues of the journal into the catalogue, see Harvesting from DergiPark. The harvest card opens at the bottom of this tab once the address is saved.
Publication facts and contact details
The details in the Publication facts section appear in the About the journal section of the journal page. The checks for TR Dizin (Türkiye's national citation index) use them too.
- The Field sets the minimum number of issues a year that TR Dizin expects. Journals in the health sciences are expected to publish 3 issues a year, in science and engineering 2, and in the social sciences and humanities 1.
- Issues a year and Publication months must match. Select as many months as there are issues a year.
- In the Languages field, type the language codes, for example tr, en or de.
- The Frequency field is free text that appears on the page as written.
In the Journal contact details section you enter the e-mail address, telephone number and postal address of the journal. The TR Dizin checklist asks for the e-mail address and the postal address.
Record details
The name, abbreviation, publisher, access status and licence of the journal are in the catalogue record of the journal. If you may see draft records, the Record details button in the page header opens the record.
How-to
Adding Board Members and Indexes
Entering the editorial board of a journal with its role groups and adding the indexes that cover the journal with their verification addresses.
You enter the board members and the indexes on the Board & indexes tab of the journal. The journal page shows the boards divided into role groups. The indexes are listed on the page with their links.
Adding a board member
- Open the journal with Manage journal and go to the Board & indexes tab.
- On the Editorial board card, press Add board member.
- Type the name of the member in the Full name field. This field is required.
- In the Role group list, select the group of the member.
- Optionally, type the title to show on the page in the Role field.
- Enter the institution, city, two-letter country code and ORCID iD of the member.
- In the last list, select Publishing institution or Another institution for the member.
- When you have added all members, press Save at the bottom of the tab.
The role groups are Editor-in-chief, Editor, Associate editor, Section editor, Language editor, Statistics editor, Editorial board, Advisory board and Other. You change the order of the members by dragging the rows. You remove a row with the cross button.
Board details for TR Dizin
TR Dizin (Türkiye's national citation index) requires at least one third of the editorial board to come from other institutions. For this reason, select for each member whether they are from the publishing institution or from another one. If the Editorial board group has members, the share is calculated from this group. Otherwise it is calculated from the whole board.
The TR Dizin checklist also looks for the editor-in-chief, the section editors and the language editor. Enter these members with the matching groups. Members with a missing institution, city or country also appear as warnings in the checklist.
Adding an index
- On the Indexes card, press Add index.
- Type the name of the index in the Index name field.
- In the Verification address field, type the address of the journal's page in that index. The address
must start with
https://. - Press Save.
An index without an address is saved too. The Source links of the indexes row in the TR Dizin checklist shows which indexes have no link. If TR Dizin is among the indexes, JournTech sends reminders to upload published issues to ODİS, the journal system of TR Dizin. Details are in Downloading the ODİS Package.
How-to
Setting Author Guidelines and Review Criteria
Entering the author guidelines, reference style, abstract limit and former titles of a journal, and defining the criteria scored in the review form.
The Guidelines & review criteria tab of the journal keeps the author guidelines shown to authors and the criteria that reviewers score in one place. You save the changes on the tab with the Save button at the bottom of the tab. The article template on the same tab, however, is saved as soon as you upload it. The template steps are in Uploading the Article Template.
Author guidelines
- Open the journal with Manage journal and go to the Guidelines & review criteria tab.
- In the Reference style field, type the style the journal uses, for example APA 7 or ISNAD 2.
- In the Similarity check tool field, type the similarity software the journal uses.
- In the Abstract word limit field, type the maximum number of words in an abstract. The value must be between 50 and 2000.
- Write the author guidelines in the Author guidelines (TR) and Author guidelines (EN) fields. You can use simple HTML such as paragraphs, lists and links.
- Press Save.
The author guidelines appear in the submission wizard when the journal is selected, and in the Author guidelines section of the journal page. The reference style, the abstract limit and the similarity tool appear at the top of the same section. The data check for TR Dizin (Türkiye's national citation index) warns about articles whose abstract exceeds this limit.
Former titles of the journal
If the title or the ISSN of the journal has changed, add its former titles to the Former titles card.
- Press Add a former title.
- Fill in the Former title, ISSN and Last year fields.
- Press Save.
The former titles appear in the About the journal section of the journal page.
Review criteria
The Review criteria card defines the criteria scored in the review form. If the journal has not defined any criteria, the card lists the default criteria used in the review form. If you add criteria, only your criteria are used.
- Press Add criterion.
- In the Code field, type a short code that starts with a lower-case letter, for example originality. The code consists of lower-case letters, digits and underscores.
- In the Name (TR) field, type the Turkish name of the criterion. The Name (EN) field is optional.
- In the Maximum score field, type a value between 2 and 10.
- Press Save.
You change the order of the criteria by dragging the rows. The reviewer gives each criterion a score between 1 and the maximum score.
The criteria are copied to a review at the moment the reviewer accepts the invitation. A change you make later applies only to invitations accepted after it.
The minimum number of reviewers and the yearly reviewer list on the same card are described in Setting the Reviewer Minimum and Reviewer List.
How-to
Uploading the Article Template
Uploading, replacing or removing the writing template that authors download from the journal page.
The article template is the file authors use when they prepare their articles. Once the template has passed the virus scan, it can be downloaded from the journal page with the Manuscript template button.
- Open the journal with Manage journal and go to the Guidelines & review criteria tab.
- Drop the file on the Upload a template area of the Article template card.
You can upload a DOCX, ODT or PDF file. For a LaTeX template, upload a ZIP file. The upload is saved at once, and your other unsaved changes on the tab are kept. While the scan runs, the card says that the file is being scanned. If the file does not pass the scan, the card says why, and the template does not appear on the journal page. In that case, upload a smaller or clean copy of the file. If the card says that the file is missing from the file store, uploading the same file again is enough.
Replacing and removing the template
- Uploading a new file replaces the previous one.
- The Remove the template button removes the template from the journal page. The file itself stays in the library.
- If you may see draft catalogue records or manage the file library, the Choose from the file library button appears too. With this button you select a document in the library and press Use as template. Files linked to a catalogue record cannot be templates.
- The list starts with the newest files of the library. You can also find a document by typing its name in the Search by file name box. If the library has more than 1,000 files, the list looks at the newest 1,000 and a note says so. Search for an older document by its name.
Template changes are written to the audit log. The checklist for TR Dizin (Türkiye's national citation index) suggests adding a template, and the Fix link in the checklist takes you straight to this card.
How-to
Setting the Reviewer Minimum and Reviewer List
Setting the minimum number of reviewers expected in a review round and publishing the yearly list of reviewers of the journal.
You set the minimum number of reviewers and the yearly reviewer list at the top of the Review criteria card on the Guidelines & review criteria tab of the journal.
- Open the journal with Manage journal and go to the Guidelines & review criteria tab.
- In the Minimum reviewers per round field, type a number between 1 and 5. The default value is 2.
- To publish the reviewer list, tick the Publish the yearly list of reviewers box.
- Press Save at the bottom of the tab.
Minimum number of reviewers
If a round has fewer reviewers than this number, the editor is warned by the Reviewer rules note on the Reviewers tab of the submission. The warning does not block any action. TR Dizin (Türkiye's national citation index) expects at least two reviewers. The note is described in Tracking Invitations and Reviews.
Yearly reviewer list
If the list is turned on, an Our reviewers link appears on the journal page. The list includes only reviewers who allowed the publication of their name in their review. The reviewers are listed by the year they submitted the review, with their titles, names and institutions. Within each year the list is in alphabetical order of the full name; the title does not affect the order. The list does not say which article they reviewed. While the list is turned off, this page does not open.
The permission of the reviewer is an optional box in the review form, and it starts unticked. Details are in Writing a Review.
How-to
Writing Journal Policies
Writing the peer review, open access, copyright, ethics, AI, fee, archiving and complaints policies of a journal in Turkish and English.
You write the policies of the journal on the Policies tab. The policies you fill in are published on the journal page as separate sections under the Journal policies heading. Policies you leave empty are not shown.
- Open the journal with Manage journal and go to the Policies tab.
- Select a policy in the list on the left. The list shows whether each policy has been written.
- Select Turkish in the language tabs and write the text. Then write the English text.
- Repeat steps 2 and 3 for the other policies.
- Press Save.
You can use formatting such as headings, lists and links in the text. Harmful tags are removed when you save.
Policies and TR Dizin
The list has eleven policies. The checklist for TR Dizin (Türkiye's national citation index) shows a missing policy as a warning or as a suggestion.
| Policy | If missing in the TR Dizin checklist |
|---|---|
| Peer review process | Warning |
| Open access policy | Warning |
| Copyright and licensing | Warning |
| Ethical responsibilities of authors | Warning |
| Ethical responsibilities of reviewers | Warning |
| Ethical responsibilities of editors | Warning |
| Plagiarism and similarity checks | Suggestion. The row is complete if a similarity tool was entered on the guidelines tab |
| Use of AI tools | Suggestion |
| Publication fees | Warning |
| Archiving policy | Suggestion |
| Complaints and appeals | Suggestion |
If the journal charges no fees, say so clearly in the Publication fees policy, for example "The journal charges authors no fees." The TR Dizin checklist is described in detail in Preparing for TR Dizin.
How-to
Posting Journal Announcements and Calls
Writing, publishing, unpublishing and deleting the announcements of a journal and its calls for papers, such as calls for a special issue.
You manage the announcements and calls for papers of the journal on the Announcements & calls tab. Published announcements and open calls appear on the journal page. Calls are also listed on the Calls page of the site.
Writing an announcement or a call
- Open the journal with Manage journal and go to the Announcements & calls tab.
- Press New announcement or New call for papers.
- For a call, fill in the Deadline field. This field is required for calls.
- On the Turkish tab, fill in the Title, Short description and Text fields. The Turkish title is required.
- Optionally, fill in the same fields on the English tab.
- Press Save.
A saved item stays a draft and does not appear on the site. To edit an item, press its title in the list.
Publishing and unpublishing
- In the list, press Publish in the row of the item.
The item is published at once. You remove a published item from the site with the Unpublish button. The trash button deletes the item. Both actions ask for confirmation.
Journal announcements are not subject to the review rule of institutional content. An editor who can use this tab publishes the items themselves.
On the site
- The journal page shows the last three announcements and the open calls.
- The Calls page of the site sorts the open calls by deadline. Expired calls stay on the same page in a separate section.
- A call whose deadline has passed drops off the journal page automatically.
News and calls of the institution that are not tied to a journal are described in Adding News, Announcements and Events.
How-to
Preparing for TR Dizin
Checking how ready a journal is for the TR Dizin criteria with the checklist on the TR Dizin tab, fixing the gaps and turning on the strict check.
The TR Dizin tab of the journal checks the details, boards, recent issues and article data of the journal against the journal criteria of TR Dizin, the national citation index of Türkiye run by TÜBİTAK ULAKBİM. The list shows whether the data is ready. You still upload the issues and articles to TR Dizin yourself, through ODİS, the journal system of TR Dizin.
Reading the list
| Group | What is checked |
|---|---|
| Journal details | ISSN, Turkish and English journal title, abbreviation, publisher, scope in two languages, field, publication frequency and months, the minimum number of issues a year for the field, languages, contact details, open access and licence, indexes and former titles |
| Guidelines and policies | Author guidelines, reference style, abstract limit, article template, policies and similarity check |
| Boards | Editor-in-chief, section and language editors, the institution and location details of the members, the share of external members on the editorial board, and ORCID |
| Recent issues | The number of issues published in recent years, combined and special issues, match with the publication months, and continuous page numbering within a volume |
| Article data (last two years) | English data, completeness of the second language, ORCID, institution, dates, references, ethics committee statement, article type, DOI and abstract limit |
Each row carries the Done, Warning, Missing or Suggestion label. Above the list you see the number of done, warning and missing rows and the time of the check.
Fixing the gaps
- In a missing or warning row, press the Fix link. The link opens the tab where you fix the gap. In the template and index rows it goes straight to the field concerned.
- Fix the gap and save.
- Go back to the TR Dizin tab and press Check again.
The link in the journal title, abbreviation, publisher, open access and licence rows opens the catalogue record of the journal. If you do not have the permission to open this record, ask a catalogue editor to correct these details.
The link in the article data rows opens the Issues tab. The Consistency check button on the issue screen shows the TR Dizin warnings of each article separately.
Strict check
If the Hold issues to the TR Dizin data checks switch is on, an issue whose article data still has TR Dizin warnings cannot be published. While the switch is off, the warnings are for information only. The setting is saved the moment you change the switch. Journals that turn on the strict check also get the ODİS upload reminders.
TR Dizin record
If a system administrator turned on the Show TR Dizin data feature flag, the TR Dizin record card appears at the top of the tab. The card reads the open data of TR Dizin by the ISSN of the journal. It shows whether the journal is indexed in TR Dizin and, by year, the numbers of missing issues, missing review reports and expert warnings.
The record refreshes automatically once a week. To refresh it now, press Fetch from TR Dizin. Because the record is read by ISSN, the journal must have an ISSN. If there is no ISSN, the card says so.
The steps for uploading issues to ODİS are in Downloading the ODİS Package.
How-to
Downloading the ODİS Package
Downloading the files of a published issue for upload to TR Dizin as a single ZIP file, and marking the issue as uploaded to ODİS.
The ODİS package collects the files you need to upload an issue to ODİS, the journal system of TR Dizin (Türkiye's national citation index), in a single ZIP file. JournTech does not upload the issue to ODİS for you.
Downloading the package
- On the Catalogue → Journals & issues screen, open the journal.
- Open the published issue from the Issues tab.
- Press ODİS package in the page header.
The button appears only on published issues.
Contents of the package
| File | Contents |
|---|---|
| 00-tam-sayi.pdf | The full issue, with the cover, the table of contents and the articles in order |
| makaleler | A folder with the PDF of each article, numbered in table-of-contents order |
| odis-veri.xlsx | The article, author and reference details to copy when you enter them in ODİS |
| hakem-dosyalari | A folder with the referee dossiers of the selected articles |
| BENIOKU.txt | A read-me file with the steps for uploading to ODİS |
By default the package adds the referee dossiers of 15% of the articles, and of no fewer than two. Referee dossiers are added only for articles reviewed in the panel, and only with the permissions of an editor-in-chief. If you do not have these permissions, the BENIOKU file says that the referee dossiers were not added. Articles without a PDF are also listed in this file.
Uploading to ODİS
The BENIOKU file describes these steps:
- Create the issue in ODİS and upload the full issue PDF.
- Enter each article with the details from the data sheet and attach its PDF.
- Upload the referee dossiers. Also add the dossier of one rejected article each year.
- Send the issue to the checking process in ODİS.
You get the referee dossier of a rejected article from the editor screen of the submission. Details are in Downloading the Referee Dossier.
Uploaded mark
- After uploading the issue to ODİS, press Mark as uploaded to ODİS on the issue page.
From then on the button shows the date of the mark. If you set the mark by mistake, press the same button again to remove it.
Reminders
For issues without the mark, reminders go out 14 and 45 days after the issue is published. Reminders go out only for journals that list TR Dizin among their indexes or have turned on the strict TR Dizin check. They reach the editors authorised for the journal by e-mail and as panel notifications. If there is no such editor, they go to the other users with the permission to manage the journal.
A system administrator changes the days in the ODİS upload reminder (days after the issue was published) field on the Workflow tab of the Administration → Site settings screen. If the field is left empty, no reminders are sent.
How-to
Publishing an Article as Early View
Publishing an accepted article on the journal page without placing it in an issue, and adding it to an issue later.
With early view, an accepted article is published on the journal page without being placed in an issue. When you later add the article to an issue, it leaves early view automatically. The journal of the article must be published.
Early view from production
- On the Editorial → Production screen, open the job of the article.
- On the Release settings card, leave the Journal issue field empty.
- Tick the Publish as early view box.
- Press the Save button of the card.
- Release the article.
The steps for releasing are in Releasing a Work.
Early view from the catalogue
- Open the catalogue record of the article.
- In the Placement section, select the journal of the article in the Journal field. Leave the Issue field empty.
- Tick the Early view: publish in this journal before placing it in an issue box.
- Save the record and publish it.
Publishing the record is described in Record Statuses and Publishing.
On the site
The article appears in the Early view section of the journal page. The page of the article shows the Early view label, and its source line gives the name of the journal.
When you add the article to an issue, the early view mark is removed automatically and the article leaves this section. An article placed neither in an issue nor in early view cannot be published, and the form says so with an error.
From early view to an issue
An article in early view is a published record, so it goes only into a published issue. Prepare the other articles of the issue and publish the issue, then add the early-view articles to it from the issue's page or from the Placement section of the article. When automatic DOI registration is on, the article's DOI metadata is sent again with the volume and number.
Screens and settings
Journals and Issues Screen
The screen that lists the journals in your scope as cards, the details on the cards and the Manage journal and Record details buttons.
The Catalogue → Journals & issues screen lists the journals you may manage as cards. If your role was granted for a single journal, you see only that journal. The menu is hidden from people without the permission to manage journals.
Button at the top
New journal opens a new journal record and requires the permission to edit the catalogue. The steps are in Adding a Journal.
Journal card
Each card shows the following:
- The name of the journal and its ISSN and e-ISSN numbers, or its short name if it has no numbers.
- The status of the journal record.
- A short excerpt from the scope of the journal.
- The submission method, the peer review type and the number of issues.
- The EN missing or TR missing label if a translation is missing.
Manage journal at the bottom of the card opens the management screen of the journal. Record details opens the page of the journal record in the catalogue and requires the permission to see unpublished catalogue records.
Related topics
Screens and settings
Journal Management
The tabs, the issue list, the DergiPark card on the Profile tab and the buttons at the top of the screen that Manage journal opens.
You open the management screen of a journal with the Manage journal button in the Journals & issues list. The screen gathers the issues, profile, boards, guidelines, policies and announcements of the journal and its readiness for TR Dizin (Türkiye's national citation index) in tabs. Next to the title you see the status of the journal record, the submission method and the peer review type.
Buttons at the top
- Record details opens the page of the journal record in the catalogue. The name, categories, publisher and licence of the journal are edited there.
- Public page opens the page of the journal on the public site in a new tab, if the journal record is published.
Tabs
| Tab | Contents | Topic |
|---|---|---|
| Issues | The list of volumes and issues | Creating an Issue |
| Profile | ISSN, scope, submission method, peer review type, publication facts, contact details | Editing the Journal Profile |
| Board & indexes | Editorial board members and indexes | Adding Board Members and Indexes |
| Guidelines & review criteria | Author guidelines, article template, former titles, reviewer settings and criteria | Setting Author Guidelines and Review Criteria |
| Policies | The publication policies of the journal | Writing Journal Policies |
| Announcements & calls | Journal announcements and calls for papers | Posting Journal Announcements and Calls |
| TR Dizin | The readiness checklist for the TR Dizin journal criteria | Preparing for TR Dizin |
Issues tab
The tab lists the issues of the journal with the newest volume at the top. The table has the Issue, Year, Status and Articles columns. Special issues are marked separately. Open in a row opens the page of the issue, and the trash button opens the dialog for deleting the issue. New issue creates a new issue.
DergiPark card on the Profile tab
For a journal whose submission method is Managed on DergiPark and whose DergiPark address is saved, the Harvest from DergiPark card appears at the bottom of the Profile tab. The card brings the archive of the journal from DergiPark, the national journal platform of TÜBİTAK ULAKBİM, into the catalogue. Details are in Harvesting from DergiPark.
Screen rules
- People with the permission to manage journals open the screen. An editor whose role was granted for one journal sees only that journal.
- The profile, board, guidelines and policies tabs each have their own Save button. A change on a tab is saved with the button of that tab.
- Saving one tab does not discard the unsaved changes on the other tabs. Moving between tabs keeps them as well. If you try to leave the screen with unsaved changes, the panel asks first.
- If two people edit the profile at the same time, the person who saves last gets the "Someone else changed this record" warning. Reload the page and make the change again.
Screens and settings
Issue Page
The table of contents, the issue details card, the consistency check, the publishing, ODİS and Crossref buttons and the deletion of a journal issue.
The issue page shows the articles and the details of a journal issue together. You open the page from the row of the issue on the Issues tab of the journal. The header shows the volume and issue number, and next to them the status, year and title of the issue and the special issue mark.

Buttons at the top
| Button | What it does |
|---|---|
| Consistency check | Checks the issue and its articles and shows the result at the top of the page |
| Crossref XML | Downloads the Crossref file of the public articles of the issue that have a DOI |
| ODİS package | Downloads the ODİS package of the published issue |
| Mark as uploaded to ODİS | Marks, with the date, that the issue has been uploaded to ODİS |
| Publish issue | Publishes the draft issue |
| Unpublish issue | Unpublishes the published issue, with a reason |
ODİS is the journal system of TR Dizin, the national citation index of Türkiye. The ODİS buttons appear only on a published issue and are described in Downloading the ODİS Package.
Table of contents
The Table of contents card lists the articles of the issue in order. Each row shows the title, status, year and pages of the article and a field for the section heading. After a check, the row of an article with problems shows its gaps and TR Dizin warnings.
- You put the rows in order by dragging them. When the order or a section heading changes, the Save contents button appears. The button saves the order and the section headings together.
- The Add article field at the bottom of the card adds an article to the issue.
- The cross button in a row removes the article from the issue.
The steps are in Adding Articles to an Issue.
Issue details
The Issue details card has the Volume, Number, Year, Publication date, Turkish and English Issue title, Special issue and Turkish and English Editor's note fields. The editor's note is formatted text: the toolbar adds headings, bold or italic text, lists and links. The note appears on the issue's public page under "From the editor". The Save button of the card is active only when there is a change. The Delete issue button at the bottom of the card opens the dialog for deleting the issue.
Screen rules
- Only people who may manage the journal open and change the page.
- Publishing the articles together with the issue requires the permission to publish in the catalogue.
- An issue with published articles cannot be unpublished.
- Changes to the order you set by dragging, to the section headings and to the issue details stay until you save them. Adding or removing an article, publishing the issue or saving the other card does not discard them. If you try to leave the page with unsaved changes, the panel asks first.
- Deleting the issue is described in Deleting a Journal Issue.
The publishing steps are in Publishing an Issue.
Troubleshooting
The journal does not appear in the submission wizard
Causes when authors cannot find your journal in the journal list of the submission wizard, or the journal page has no Submit an article button.
The journal list of the submission wizard contains only published journals that accept submissions through the panel. Check the causes below in order.
The submission method is not the panel
On the Profile tab of the journal, the Submissions field must be set to Through the workspace (JournTech). With the other options, authors cannot submit to the journal through the panel. The difference between the options is explained in Editing the Journal Profile.
The journal record is not published
The catalogue record of the journal must be published. A catalogue editor publishes the record. The steps are in Record Statuses and Publishing.
Submissions are closed
If a system administrator turned off the New submissions feature flag, no journal accepts submissions and the Submit an article button on the journal pages is hidden. A system administrator turns the flag back on.
Troubleshooting
The issue cannot be published
Checking the journal record, the missing details of the issue, the TR Dizin check and the status of the articles when Publish issue fails.
If an issue is not published, the panel gives the reason in the notification at the bottom right and shows the result of the consistency check at the top of the page. Check the causes below in order.
The journal record is not published
The notification reads "Publish the journal first." Publish the catalogue record of the journal itself before the issue. You open the journal record with the Record details button on the management screen of the journal.
The details of the issue are missing
The volume, number, year and publication date of the issue must be entered. If the date is missing, the notification reads "Enter the issue date before publishing the issue." Enter the missing details on the Issue details card and press Save.
The TR Dizin check is mandatory
The notification reads "The issue does not pass the TR Dizin data checks." If the data check for TR Dizin (Türkiye's national citation index) is mandatory for the journal, an issue whose article data still has warnings is not published. Fix the warnings in the TR Dizin data checks note of the check. Details are in Preparing for TR Dizin.
An article does not meet the conditions
When you publish the issue with its articles and an article cannot be published, the issue is not published either. The row of the article with problems shows its gaps in red. Fix the article, or publish the issue without the articles.
If the year of a published article in the issue differs from the year of the issue, the issue is not published. Correct the year of the article or of the issue.
You sent the article to review
If the editor approval rule is on for the installation and you sent an article of the issue to review, the notification reads "You sent this article to review. Another editor has to publish it." Have another catalogue editor publish the article, or publish the issue without the articles. The rule is described in Four-Eyes Principle.
The option to publish the articles is missing
The Also publish draft and in-review articles box in the publishing dialog requires the permission to publish in the catalogue. The editor-in-chief of the journal publishes the issue, and a Catalogue editor publishes the articles.
Troubleshooting
The issue cannot be unpublished
Unpublishing the articles first, or deleting the issue, when an issue with published articles cannot be unpublished.
An issue cannot be unpublished while it has published articles. The notification reads "Unpublish the issue's published articles first." Unpublish the articles first, then unpublish the issue.
- On the Catalogue → Publications screen, find the articles of the issue.
- Select the articles and press Unpublish in the bulk action bar.
- Write the reason and confirm the preview.
- On the issue page, press Unpublish issue.
- Write a reason of at least 5 characters and confirm.
The steps of the bulk action are in Bulk Actions. Unpublishing articles requires the permission to publish in the catalogue.
Removing the issue completely
If the issue will not be published again, you can delete it even while it is published. The deletion dialog either keeps the published articles in the catalogue as drafts or moves them to the trash. The steps are in Deleting a Journal Issue.
Troubleshooting
An article cannot be added to the issue
Checking whether the article is in another issue and whether the journal editor restriction applies when an article cannot be added to the table of contents of an issue.
The Add article field of an issue searches only article records. If the article cannot be found or a warning appears when you add it, check the causes below.
The article is in another issue
An article can be in only one issue. The warning reads "The article is in another issue." First remove the article from the table of contents of the other issue, or change its issue in the Placement section of its record.
The article does not belong to this journal
If your role was granted for one journal only, you can add to the issue only the articles of that journal, that is records released from submissions to the journal. In this case the warning reads "This article cannot be placed: a journal's editors place only their journal's articles (released from submissions to the journal). Catalogue editors place other records." Have a catalogue editor place the other records.
The record is not an article or has been deleted
Only records of the article type can be added to an issue. A book chapter or a proceedings paper is linked to a book, not to an issue. A deleted article does not appear in the search. First find it with the Show deleted filter in the Publications list and restore it.
A published article cannot be added to an unpublished issue
A published article, for example one in early view, goes only into a published issue. The warning reads "Publish the issue first." Publish the issue first, then add the article.
A published article cannot be removed from the issue
To remove a published article from the issue, unpublish the article first. The warning reads "Unpublish the issue's published articles first." An archived or retracted article cannot leave its issue at all. In this case the warning reads "An archived or retracted article cannot leave its issue."
Feature
DergiPark Harvesting
Copying the issues and articles of a journal managed on DergiPark into the catalogue and keeping them up to date.
For a journal managed on DergiPark (Türkiye's national journal platform), submissions and peer review take place on DergiPark. DergiPark is selected as the submission method in the journal's profile, and the journal's DergiPark address is entered. From then on, the submit button on the public site opens the submission form on DergiPark.
Once harvesting is turned on, the issues and articles the journal has published on DergiPark are copied into the catalogue and updated automatically once a week. The original page of a harvested article is on DergiPark. For this reason these articles are not included in the sitemap or in OAI-PMH, but they appear on the public site, in search and on the issue pages.
JournTech sends its requests to DergiPark one at a time and with pauses between them. If DergiPark turns a request down, JournTech waits for the time DergiPark asks for and tries again. PDFs that cannot be fetched at the moment are requested again later.
How-to
Finding a Journal on DergiPark
Entering the DergiPark address in the profile of a journal managed on DergiPark, finding the journal number and sending authors to DergiPark.
For a journal whose submissions and peer review take place on DergiPark (Türkiye's national journal platform), Managed on DergiPark is selected as the submission method in the profile, and the journal's DergiPark address is entered. The Find on DergiPark button finds the journal on DergiPark and automatically fills in the journal number that the submission link needs.
Entering the address
- On the Catalogue → Journals & issues screen, open the journal with Manage journal.
- Go to the Profile tab.
- In the Submissions list, select Managed on DergiPark.
- In the DergiPark address or short name field, enter the journal's DergiPark address or only its short name. For example, the
short name in the address
https://dergipark.org.tr/en/pub/shortnameisshortname. - Press Find on DergiPark.
- Check the journal name and the journal number that appear under the field.
- Press Save.
Find on DergiPark saves nothing. The address and the journal number are saved only with the Save button. If the search cannot find the journal number, you can also fill in the DergiPark journal number field by hand. The link under the field shows the address that authors will be sent to.
For a journal that changed its name, DergiPark redirects the old short name to the new address. In that case, the search writes the journal's new short name in the field. For a journal without a Turkish interface, DergiPark sends Turkish addresses to the English page, and the search follows this redirect too.
When creating a new journal
The same fields are used when you create a new journal record. In the New journal form, the address field, the Find on DergiPark button and the journal number appear once Managed on DergiPark is selected in the Submissions field. If the address is empty, the form warns you before saving. The journal profile card on the journal's Record details page has the same fields. The steps for adding a journal are in Adding a Journal.
Changes on the public site
When you save the profile, the public site shows the journal like this.
- The note This journal is managed on DergiPark appears at the top of the journal page.
- The submission button becomes Submit on DergiPark and opens the submission form on DergiPark in the visitor's language. If no journal number is saved, the button opens the journal's page on DergiPark.
- Links to the journal's DergiPark page, its archive and its writing rules appear at the side of the journal page.
- In the journal list, the journal is shown with the DergiPark label.
- In the author guide, the journal's row has a button that goes to DergiPark.
Submissions to this journal cannot be made in the panel. The journal list of the submission wizard shows only the journals that take submissions through the panel.
Next step
To bring the journal's published DergiPark issues into the catalogue, go on to Harvesting from DergiPark. If the search cannot find the journal, see The Find on DergiPark button cannot find the journal.
How-to
Harvesting from DergiPark
Turning on the harvest of the issues and articles a DergiPark-managed journal has published into the catalogue, starting it at once and reading its results.
The DergiPark harvest copies the issues and articles that a journal has published on DergiPark (Türkiye's national journal platform) into the catalogue and updates them automatically once a week. You turn the harvest on in the Harvest from DergiPark card on the journal's Profile tab. The card appears only for journals whose submission method is saved as Managed on DergiPark and whose DergiPark address has been entered.
Before you start
- Save the journal's DergiPark address as described in Finding a Journal on DergiPark.
- Publish the journal's own catalogue record. If the journal record is not published, the harvested issues and articles stay as drafts.
- If you are going to copy the PDFs too, select a licence in the journal record. The copied PDFs are published under this licence.
- Get permission for the harvest from the journal's editorial board. You confirm this permission when you turn the harvest on.
Turning the harvest on
- On the Catalogue → Journals & issues screen, open the journal with Manage journal.
- On the Profile tab, scroll down to the Harvest from DergiPark card.
- Turn on the Harvest the published issues from DergiPark switch.
- If you want the PDFs to be copied too, turn on the Copy the PDFs too switch.
- Tick the box that confirms the editorial board's permission.
- Press Save.
The confirmation box appears only the first time you turn the harvest on. The Save button does not work until the box is ticked, and your confirmation is written to the audit log. Turning the harvest on needs the catalogue publishing permission, because the harvested articles are published in the catalogue. This permission is in the Catalogue editor and System administrator roles. The journal's editor with the Editor-in-chief role sees the card but cannot turn the harvest on.
Starting the harvest
Once you save, the Harvest now button appears on the card.
- Press Harvest now.
- Wait for the results while the button says Harvest running….
The harvest runs in the background, and you can leave the page. The card refreshes the results by itself. Only one harvest runs at a time for a journal.
If you do not press the button, the system starts the harvest itself. The system checks the journals that have the harvest on every six hours and starts a new run for a journal whose last run was a week ago or longer. Each run reads all of the journal's records on DergiPark and skips the articles that have not changed. The speed of a run depends on DergiPark's responses. The details are in DergiPark Request Intervals.
Reading the results
The line under the card shows the number of DergiPark records in the catalogue, how many of them are published and the date the harvest was turned on. The table lists the last ten runs.
| Column | What it shows |
|---|---|
| Started | When the run started. Runs that the system started show scheduled under the time |
| Status | Running, Done or Failed |
| Result | The counts above zero and the first three problems |
The counts in the result column are these.
| Count | Meaning |
|---|---|
| Records | DergiPark records processed in this run |
| New | Articles newly created in the catalogue |
| Updated | Articles updated because they changed on DergiPark |
| Unchanged | Articles skipped because they did not change on DergiPark |
| Published | Articles published in this run |
| Left as drafts | Articles left as drafts because they failed the publish checks |
| Issues opened | Issues published in this run |
| PDFs | PDFs copied |
| PDFs to try again | PDFs that DergiPark did not give at the time and that will be requested again later |
| Gone from DergiPark | Records taken in earlier runs that are no longer on DergiPark |
| Errors | Problems found in records |
Problem lines give the record's DergiPark ID and the reason for the problem. For articles left as drafts, see Articles harvested from DergiPark stay as drafts. For failed runs, see The DergiPark harvest shows as failed.
Turning the harvest off
If you turn off the Harvest the published issues from DergiPark switch and press Save, the weekly harvest stops. Records harvested earlier stay in the catalogue. How harvested records behave is described in Records Harvested from DergiPark, and the PDF copies in DergiPark PDF Copies.
How-to
Deleting a DergiPark Article
Removing an article harvested from DergiPark from the catalogue and knowing what the harvest does with articles that are deleted, unpublished or gone from DergiPark.
To remove an article harvested from DergiPark (Türkiye's national journal platform) from the catalogue, you first unpublish it and then delete it. A deleted article is not taken in again or republished in later harvests.
Deleting the article
- On the Catalogue → Publications screen, open the article.
- On the Status card on the right, press Unpublish.
- Enter a reason of at least 5 characters and confirm.
- On the same card, press Delete.
- Enter the reason and confirm.
A published record cannot be deleted directly. Deleting a record that was published before also needs the publishing permission. A deleted article goes to the trash. You find it in the Publications list with the Show deleted filter and restore it with Undo delete.
Later harvests
- Deleted and retracted articles are skipped. The harvest does not overwrite these records and does not republish them.
- An article that was only unpublished stays a draft. If this article's information changes on DergiPark, the next harvest updates the record and republishes it if the record passes the publish checks. If you never want the article to appear on the site, delete it.
- An article you restore from the trash comes back as a draft. The harvest republishes it only if its information on DergiPark changes.
Articles removed from DergiPark
An article that is no longer on DergiPark is not deleted from the catalogue automatically. The harvest reports these records with the Gone from DergiPark count in the result line. If you want to remove such an article from the catalogue too, delete it with the steps above.
Deleting an issue
You can also delete an issue harvested from DergiPark as described in Deleting a Journal Issue. The delete window also states that the journal is harvested from DergiPark.
- With the Delete the articles too option, the articles go to the trash and are not taken in again in later harvests.
- With the Keep the articles in the catalogue option, the articles stay as drafts without an issue. For an article that is updated on DergiPark, the next harvest creates its issue again, and the article can be published again.
Manual changes
The harvest protects only deleted and retracted records. The catalogue information of an article that changed on DergiPark is rewritten with the information on DergiPark. The details are in Records Harvested from DergiPark.
Concept
Records Harvested from DergiPark
What the DergiPark harvest brings into the catalogue, when it publishes issues and articles, and how the harvested records appear on the site.
The DergiPark harvest creates an article record in the catalogue for every article that a journal has published on DergiPark (Türkiye's national journal platform). The record's original page stays on DergiPark. The article appears on the public site, in search and on issue pages, but the sitemap and OAI-PMH leave it out, because the DergiPark record announces the article itself.
Information taken over
The harvest takes an article's information from two sources.
- DergiPark's OAI-PMH record provides the title, abstract and keywords in each language, the authors, the language of the work, the publication date, the DOI, the volume, the issue and the pages.
- The article's DergiPark page provides the authors' ORCID iDs and institutions, the references, the article type and the PDF address.
The article page is read only for new or changed articles. A page that cannot be read appears as a problem in the result line and is read again in the next harvest. When the page cannot be read, the ORCID iDs, affiliations, references and article type of an existing record are not removed.
The authors on the article page are matched to the authors of the OAI-PMH record by their names. An author whose name does not match is matched by position only when both lists have the same number of authors. If the lists differ, that author's ORCID iD and institution are not taken from the page. This way, no author gets someone else's ORCID iD.
Authors are linked to existing person records by their ORCID iDs, or by an exact match of their names when there is no ORCID iD. If there is no match, a new person record is created. Institutions are matched by their Turkish or English names too. An institution without a match is added to the institution tree, and if the institution text ends with Türkiye or Turkey, the city and the country are filled in too. You can merge duplicate person records as described in Merging Person Records.
The article's access depends on the Copy the PDFs too option. If the PDFs are copied, the article becomes open access under the journal's licence. If they are not copied, the article stays Metadata only, and its page links to the original page on DergiPark. The details are in DergiPark PDF Copies.
Issues and publishing
- An article is placed in the journal's issue that has the same volume and issue number. If there is no such issue, the harvest creates it. An article with no volume and issue information at all is not placed in an issue and stays a draft.
- If the journal record is published, the harvest publishes the issue. The issues that the harvest creates have no publication date. The harvest publishes them anyway, because this step is not held back by the issue date rule.
- An article is published if it passes the catalogue's publish checks. Otherwise it stays a draft. An article left as a draft is tried again in the next harvests, even if it did not change on DergiPark. An article that an editor took off the site, and an issue that was published once and withdrawn, are not published again. For articles left as drafts, see Articles harvested from DergiPark stay as drafts.
- The installation's editor approval rule does not apply to this publishing, because the content is already published on DergiPark. The details of the rule are in Four-Eyes Principle.
Display on the public site
- The article page names the DergiPark page as the original address. The note This record comes from the journal's DergiPark archive appears on the page with a link to the original page.
- The page does not write Google Scholar tags. This way, search engines do not see two originals of the same article.
- The record is left out of the sitemap and OAI-PMH.
- The record's DOI is registered by DergiPark. JournTech does not send these records to Crossref. The details are in Automatic DOI Registration.
If you delete the DergiPark address in the record's External address field, the record counts as your own record and is included in the sitemap and OAI-PMH. If the article changes on DergiPark, the next harvest writes this address again.
Updated records
Each harvest reads all of the journal's records on DergiPark. Articles whose OAI-PMH record has not changed are skipped. The catalogue record of a changed article is rewritten with the information on DergiPark. Manual changes in the following fields are lost in the process.
- The title, abstract and keywords in each language
- The authors and their institutions
- The type-specific details, including dates added by hand, funding and declarations
- The persistent identifiers, which are replaced by the DOI on DergiPark
- The access status, the publisher, the language of the work, the publication year and the publication date
- External address
The record's categories, files and featured setting are kept. Deleted and retracted articles are never updated. Records that are no longer on DergiPark stay in the catalogue and are only counted. The details are in Deleting a DergiPark Article.
Concept
DergiPark PDF Copies
When the DergiPark harvest copies the article PDFs, how it requests again the PDFs that DergiPark did not give at the time, and which PDFs it does not request again.
The harvest copies the articles' PDFs only if the Copy the PDFs too option is on. While the option is off, the article page links to the original page on DergiPark (Türkiye's national journal platform), and the PDF is read on DergiPark.
Conditions for copying
- A licence must be selected in the journal record. The copied PDFs are published under the journal's licence, and the article becomes open access.
- Every PDF goes through the virus scan like other uploads and does not open before the scan has finished.
- If the article already has a current full text in the catalogue, the harvest does not take a new copy.
- PDFs are requested from DergiPark one at a time and at longer intervals than pages. The details are in DergiPark Request Intervals.
If you turned the option on after the first harvest, the earlier articles open under the journal's licence at the next harvest. The details are in The PDFs of DergiPark articles do not show on the site.
PDFs to try again
If DergiPark does not give a PDF at the time, the harvest marks the PDF to be tried again later. This happens with a 429 or 5xx response and when DergiPark does not answer at all. The result line says that the PDF could not be downloaded for now and will be tried again shortly. The PDFs to try again count shows the number of these PDFs.
- When the run finishes, a new attempt is set up for 20 minutes later.
- For PDFs that still cannot be received, the attempts continue at the same interval. Each PDF is tried at most 5 times.
- A PDF that is copied later drops off the run's problem list.
- The weekly harvest also requests again the missing copies of articles that have not changed on DergiPark.
- When a harvest job passes 20 minutes, it leaves the remaining PDFs to the next attempt without waiting. In that case, the PDF does not lose an attempt.
- If Copy the PDFs too is turned off, the waiting attempts are not made.
PDFs not requested again
A file that is not found on DergiPark (404), is not a PDF or is larger than 100 MB is not requested again. A PDF that could not be received in 5 attempts is not requested again either. The last warning stays in the result line. You can upload the full text of such an article by hand as described in Files and Access.
Concept
DergiPark Request Intervals
At what intervals JournTech sends requests to DergiPark, how it waits while DergiPark is busy and how long-running harvest jobs are split up.
JournTech sends requests to DergiPark (Türkiye's national journal platform) one at a time and with pauses in between. This way, the journal's archive is taken without straining DergiPark. That is why the first harvest of a large archive can take a long time.
DergiPark's rules
The harvest never requests the sign-in and search addresses that DergiPark's robots.txt file forbids. The record list is read from DergiPark's OAI-PMH address in pages of 100 records, and each page is a separate background job.
Waiting between requests
The harvest waits 1 second before each request and 6 seconds before each PDF. The wait is longer for PDFs, because DergiPark limits downloads more strictly than pages.
When DergiPark is busy
If DergiPark answers with 429 (too many requests) or 503, the harvest waits and makes the same request again.
- The waiting time that the response gives (Retry-After) is used.
- If the response gives no time, the wait grows to 30, 60 and 120 seconds.
- The wait never exceeds 5 minutes.
- After such a response, the wait between requests doubles for the rest of that job and can grow up to eight times its normal length.
If there is still no response after the waits, the page of the record list is retried later in the job queue. An article page is read again in the next harvest. A PDF is marked to be tried again later. The details are in DergiPark PDF Copies.
Long-running jobs
Once a job passes 20 minutes, it stops waiting for DergiPark and leaves the remaining PDFs to the next attempt. A run that lasts longer than half a day counts as stuck and is closed as failed.
Only one harvest job runs at a time. When the harvests of two journals are under way at the same time, their pages are taken in turn. Short jobs such as e-mails and virus scans do not wait for the harvest.
Redirects
For a journal without a Turkish interface, DergiPark redirects Turkish addresses to the English page. The harvest follows redirects only within DergiPark and over https, at most three times. The page that answers becomes the original address of the article record.
Troubleshooting
The Find on DergiPark button cannot find the journal
If the Find on DergiPark button shows a warning under the address field, correcting the address, checking the short name or waiting a little and trying again, depending on the warning.
If the Find on DergiPark button cannot read the address or cannot find the journal on DergiPark (Türkiye's national journal platform), a warning appears under the DergiPark address or short name field. Follow one of the sections below, depending on the warning.
The address belongs to another site
The warning "This is not a dergipark.org.tr address." appears. Only dergipark.org.tr addresses go in this field. Enter the journal's address on DergiPark or its short name.
The address names no journal
The warning "The address names no journal. Enter the journal address in the form …/pub/shortname." appears. The address must contain /pub/ and the journal's short name. The address
of the submission form or of a PDF download page does not work. Open the journal's home page on DergiPark and copy its
address.
The short name is invalid
The warning "Enter the journal's short name on DergiPark (letters, digits, - or _)." appears. A short name consists of letters, digits, hyphens or underscores and contains no spaces.
DergiPark has no such journal
The warning "DergiPark has no journal with this name." appears. DergiPark shows no journal with this name, or the journal has moved away from DergiPark. Compare the spelling of the short name with the journal's address on DergiPark. For a journal that changed its name, DergiPark redirects to the new short name, and the search writes the new name in the field itself.
DergiPark does not respond
The warning "DergiPark did not answer." appears. DergiPark did not respond at the time or gave an unexpected response. Try again a few minutes later. If the problem continues, ask your system administrator whether the server can reach dergipark.org.tr.
Too many attempts
The search can be run at most 20 times a minute from the same IP address. Once the limit is passed, the warning "Too many attempts. Please wait a moment and try again." appears above the field. Wait a minute and try again.
Even if the search cannot find the journal, you can enter the journal's DergiPark journal number by hand in the DergiPark journal number field if you know it. The steps are in Finding a Journal on DergiPark.
Troubleshooting
The Harvest from DergiPark card is missing
If the journal's Profile tab has no Harvest from DergiPark card, saving the submission method and the DergiPark address or going to the right tab.
The Harvest from DergiPark card appears on the journal's Profile tab, below the profile form. The card appears only for journals whose submission method is saved as Managed on DergiPark and whose address on DergiPark (Türkiye's national journal platform) has been entered. Check the causes below in order.
The profile is not saved
The card looks at the saved profile. Selecting an option in the Submissions list or pressing Find on DergiPark is not enough.
- In the Submissions list, select Managed on DergiPark.
- Fill in the DergiPark address or short name field.
- Press Save.
After saving, the card opens below the profile form. The details of finding the address are in Finding a Journal on DergiPark.
You are on another tab
The card is only on the Profile tab. It does not appear on the Issues tab or on the other tabs.
The journal management screen does not open
The journal management screen needs permission to manage the journal. This permission is in the Catalogue editor role and in the Editor-in-chief role granted for the journal. If you do not have the permission, contact your system administrator.
Troubleshooting
The DergiPark harvest cannot be turned on
If the switches or the Save button on the Harvest from DergiPark card do not work, checking the publishing permission, the editorial board's consent and the journal record's licence.
The switches and the Save button on the Harvest from DergiPark card depend on your permissions, on the confirmation of the editorial board's consent and on the licence of the journal record. Check the causes below in order.
No publishing permission
If the card says "Switching the harvest on needs catalogue publishing rights (catalogue editor or system administrator).", you do not have permission to turn the harvest on. Because the harvested articles are published in the catalogue, the switch is turned on by someone with the catalogue publishing permission. The journal's editor with the Editor-in-chief role sees the card but cannot turn the harvest on. Ask a catalogue editor or a system administrator for help.
Changing the settings while the harvest is on needs this permission too. An editor without it can only turn the harvest off.
The Save button is disabled
When you turn the harvest on for the first time, a box appears that confirms the editorial board's consent. The Save button does not work until the box is ticked. The button is also disabled when no setting has changed.
The PDF copy switch is disabled
If the switch has the text "Set open access and a licence in the journal's record first; PDFs are published under it." under it, the journal record has no licence. Because the copied PDFs are published under the journal's licence, a licence must be selected first.
- On the journal management screen, press Record details.
- In the Access and licence section, set the Access status field to Open access.
- In the Licence field, select the journal's licence.
- Press Save changes.
- Go back to journal management and turn on the Copy the PDFs too switch.
No address saved
If saving shows the warning "Enter the journal's DergiPark address first.", the journal's address on DergiPark (Türkiye's national journal platform) is not saved. Save the address as described in Finding a Journal on DergiPark.
Troubleshooting
Articles harvested from DergiPark stay as drafts
If the harvest results show a Left as drafts count, checking the journal record's status, the volume and issue details and the articles' missing fields, and publishing the articles.
The harvest publishes an article only if it passes the catalogue's publish checks. Articles that fail them stay as drafts and are added to the Left as drafts count in the result line. Check the causes below in order.
The journal record is not published
If the journal's own catalogue record is not published, the harvest publishes neither the issues nor the articles. Publish the journal record as described in Record Statuses and Publishing.
The first harvest after you publish the journal record also publishes the articles left as drafts earlier, and their issues. This happens even when the article did not change on DergiPark (Türkiye's national journal platform). If you do not want to wait for the weekly harvest, press the Harvest now button on the journal management screen.
The harvest does not publish again an article that an editor took off the site. It does not publish an issue that was published once and taken down later either, nor the draft articles in it. Publish such issues by hand on the issue screen. The details are in Publishing an Issue.
The article has no volume and issue information
An article whose DergiPark record has no volume and issue information at all is not placed in an issue and stays a draft. Place the article in an issue as described in Adding Articles to an Issue. To publish it without waiting for an issue, see Publishing an Article as Early View.
A required field is missing in the article
The catalogue requires at least one author, an abstract and a keyword for an article. If one of these is missing in the DergiPark record, the article stays a draft.
- On the Catalogue → Publications screen, open the article.
- Fill in the gaps that the Metadata quality card lists.
- Press Save changes.
- Press Submit for review.
- Press Publish.
If you do not publish the article by hand, the next harvest publishes it when it passes the checks. If the article changes on DergiPark, the next harvest rewrites the record with the information on DergiPark, and the details you added are lost. That is why completing the missing information on DergiPark too is the lasting solution. The details are in Records Harvested from DergiPark.
Troubleshooting
The PDFs of DergiPark articles do not show on the site
If the pages of articles harvested from DergiPark have no PDF, checking the copy setting, the article's access status, the waiting attempts and the virus scan.
The PDF of an article harvested from DergiPark (Türkiye's national journal platform) appears on the site only if the harvest copied the PDF and the article is open access. The page of an article whose PDF was not copied links to the original page on DergiPark. Check the causes below in order.
PDF copying is off
If the Copy the PDFs too option is off, the harvest does not copy PDFs. Turn the option on as described in Harvesting from DergiPark. The option needs a licence in the journal record.
The option was turned on after the first harvest
If copying was turned on later, the earlier articles open at the next harvest. The harvest also copies the PDFs of articles that have not changed on DergiPark, sets their access status to Open access and, if their licence field is empty, enters the journal's licence. If you do not want to wait for the harvest, press Harvest now.
The PDF will be tried again
If the result line has a PDFs to try again count, DergiPark did not give these PDFs at the time. The harvest requests them again 20 minutes later and again after that if needed. The details are in DergiPark PDF Copies.
The PDF will not be requested again
If the result line says that the PDF could not be downloaded, the file may not have been found on DergiPark, may not be a PDF or may be too large. The harvest does not request this PDF again. Upload the full text by hand on the article's Files tab. The steps are in Files and Access.
The virus scan is running
Every copied PDF goes through the virus scan and does not appear on the site before the scan has finished. The scan status of the file is shown on the article's Files tab.
Troubleshooting
The DergiPark harvest shows as failed
If a harvest run ended with the Failed status or its results have problem lines, waiting, checking the address or restarting the harvest, depending on the cause.
If a run cannot get the record list from DergiPark (Türkiye's national journal platform) or stops halfway, it ends with the Failed status. A problem with a single article does not stop the run. It only appears in the result line. Follow one of the sections below, depending on the reason that the problem line gives.
DergiPark does not respond
If the line says "DergiPark could not be reached." or that DergiPark is not responding at the moment, DergiPark did not give the record list despite several attempts. Restart the harvest after a while with the Harvest now button. If you do not start it by hand, the system tries again a week later.
DergiPark gave a response that cannot be read
If the line says "DergiPark sent an answer that cannot be read." or that DergiPark gave an OAI error or an unexpected response, the record list could not be read. Try again after a while. If the problem continues, tell your system administrator.
The journal or the address is gone
If the line says "The journal or its DergiPark address is gone.", the journal record was deleted or the DergiPark address in the profile was removed. Save the address again as described in Finding a Journal on DergiPark.
The harvest stopped without finishing
If the line says "The harvest stopped without finishing.", the run took longer than half a day and the system closed it as failed. Start a new run with the Harvest now button. The new run reads the whole list from the start, but it skips the records that were taken in earlier runs and have not changed.
Problem lines in a finished run
A run with the Done status can also list problems with individual articles.
- If an article page could not be read or has moved to another address, the article is taken with its other information from DergiPark, and the page is read again in the next harvest. What the page gave an article taken before is not removed.
- The warning "This DergiPark article belongs to another journal here." says that the same DergiPark article is linked to another journal in the catalogue. Check whether the same DergiPark address is saved in the profiles of two journals.
- The warning "The record has no title." says that the record received has no title in any language. Such a record is not added to the catalogue.
- The warning "The record could not be added to the catalogue." says that the catalogue refused the record. The rest of the warning gives the reason.
For PDF problems, see DergiPark PDF Copies.
Alert to the system administrators
Every run that ends as failed sends an operations alert to the system administrators. At most one alert per hour goes out for the same journal. The alert links to the journal's Profile tab. The details of the alerts are in Operations Alerts.
Troubleshooting
The Harvest now button does not start a harvest
If the Harvest now button is missing, disabled or shows a warning when pressed, checking the harvest setting, a run in progress and the hourly limit on attempts.
The Harvest now button starts a new harvest run in the background. If the button does not work, check the causes below in order.
The button is missing
The button appears only after the harvest has been turned on and saved. Turn on the Harvest the published issues from DergiPark switch and press Save. If the switch does not turn on, see The DergiPark harvest cannot be turned on.
A run is already in progress
If the button says Harvest running…, a run of the journal is in progress. Only one run goes at a time for a journal, and the button becomes active again when the run finishes. If someone else started a run at the same time, the warning "A harvest of this journal is already running." appears. The results arrive in the card's table by themselves.
A run that lasts longer than half a day counts as stuck and is closed as failed in the system's regular check. After that, the button works again.
Too many attempts
At most 6 harvests an hour can be started by hand from the same IP address. The limit is shared by all journals. Once the limit is passed, the warning "Too many attempts. Please wait a moment and try again." appears. Wait a while and try again.
The harvest was turned off or the address removed
If the warning "Turn on the DergiPark harvest first." appears when you press the button, the harvest has been turned off in the meantime. The warning "Enter the journal's DergiPark address first." says that the journal's address on DergiPark (Türkiye's national journal platform) has been removed. Refresh the page and check the settings.
Feature
Institutional Archive
Importing the theses in the institution's open repository into the catalogue over OAI-PMH, keeping them in step with it and showing them on the Institutional Archive pages of the public site.
The Institutional Archive shows the theses in the institution's own open repository on the public site. The theses are imported into the catalogue from the repository's OAI-PMH service and synced with it every night. You set up and follow the harvest on the Catalogue → Thesis harvest screen.
The original of an imported thesis stays in the repository. A mistake in a thesis is corrected in the repository, and the next sync brings the correction into the catalogue. The thesis page on the public site links to the record in the repository. An embargoed or restricted thesis shows only its bibliographic details.
The Institutional Archive page of the public site shows how many theses there are, of which types and from which graduate schools. On the Theses page theses are filtered by type, graduate school, department, advisor, year, language and access status. The two pages are not added to the menu by themselves. How to add them is explained in Adding the Institutional Archive to the Menu.
How-to
Setting Up the Thesis Harvest
Entering the OAI-PMH address of the institution's open repository, checking the source, choosing the record format and the sets, switching the harvest on and starting the first full harvest.
You set up the thesis harvest in the Source settings card of the Catalogue → Thesis harvest screen. People with the Manage site settings and feature flags permission change the source settings. People with the Bulk import (CSV, XLSX, JSON) permission see the screen, start the harvest and read its results.
Before you start
- Ask the repository's administrator for its OAI-PMH address. In DSpace repositories this address usually ends in
/server/oai/request. - Ask the repository's administrator which sets hold the theses. In DSpace repositories every graduate school's community and every department's collection is a set of its own.
Checking the source
- Open the Catalogue → Thesis harvest screen.
- Type the repository's OAI-PMH address in OAI-PMH address.
- Press Check the source.
The check reads the repository's identity, the record formats it offers and its sets. In a repository with many sets this takes about a minute. When it is done, The archive's details shows the repository's name, its contact address, how it reports deleted records and the formats it offers. If the check fails, see Check the source gives an error.
Choosing the settings
- Leave the recommended format selected in Metadata format. JournTech recommends the format, among those the repository offers, that gives the most detail about a thesis. In DSpace repositories this is xoai.
- Tick the sets that hold the theses in Sets. The Choose the thesis collections button chooses every set whose name shows it is a thesis collection.
- Choose in Full text how readers reach the full texts.
- Leave the recommended The archive's record option selected in Original page.
- Type the name of the university that awards the degrees in Institution name. If the university is in the institution tree, also choose it in Its entry in the institution tree.
- Switch Harvest on on.
- Press Save.
The harvest can only be switched on with the address that was checked. If you change the address, check the source again before you save.
Sets
A thesis that is in several sets is in the catalogue once. One installation imports theses from at most 300 sets.

The list of sets a check reads is kept. When you open the screen again, the list shows with the date of the check. You do not need to check the source again to add a set. A set added to the repository after the last check is not in the list. To add it, check the source again. The new check replaces the kept list.
If a chosen set is not in the kept list, not in the archive shows next to it. The list shows at most 2,000 sets. For a repository with more sets, the note under the list gives the number of sets in the repository. If the screen shows only the chosen sets, no list has been kept yet. Check the source once in that case.
Full text
With Link to the archive's file selected, the page of an open-access thesis opens the full text from the file in the repository.
With Copy the file here after a malware scan selected, open-access PDF files are copied here and scanned for viruses like every upload. Copying works only with xoai, the format that lists the files, and files larger than 150 MB are not copied. To keep the load on the repository low, JournTech waits ten seconds before each file. The first full harvest therefore takes much longer.
The files of embargoed and restricted theses are never copied or linked, whichever option you choose.
Original page
With The archive's record selected, search engines treat the thesis's record in the repository as its original page. The page on this site carries no citation tags, and the thesis stays out of the sitemap and of this site's OAI-PMH output. This way the same thesis does not appear twice in search engines. The page on this site makes the page on this site the original.
The first full harvest
After you save the settings, press Full harvest in the Status card. A full harvest reads every record in the chosen sets. If you press the button outside the night hours, the harvest starts by itself when they come. The card shows the night hours.
The full harvest runs in the background and you can leave the screen. While the screen is open, the counts refresh by themselves. JournTech sends its requests to the repository one at a time with pauses, so a full harvest of a repository with thousands of theses can take hours. After the first full harvest, new and changed theses are synced every night by themselves. The details are in Full Harvest and Sync.
Switching the harvest off
If you switch Harvest on off and press Save, the scheduled runs stop. The theses imported so far stay in the catalogue and on the public site.
Concept
Full Harvest and Sync
The three kinds of run of the thesis harvest, the night hours, the pauses between requests to the repository and the safety limit for theses missing from the repository.
The thesis harvest reads the repository with three kinds of run. The system starts them by itself in the night hours. You can also start a run by hand on the Catalogue → Thesis harvest screen. Only one run goes on at a time.
Kinds of run
| Kind | What it reads | When |
|---|---|---|
| Full harvest | Every record in the chosen sets | At the first setup and when asked for |
| Sync | The records that are new or changed since the last sync | Every night |
| Removal check | The repository's whole list of records | Every six days |
A full harvest reads every record in the chosen sets from the start and skips the theses that did not change in the repository. Start a full harvest after you change the sets, the record format, the full-text option or the institution name. A sync reads only the records that changed in the repository, so it does not bring the older theses of a newly chosen set.
A sync asks the repository for the records changed since the last successful full harvest or sync. A repository does not always change a thesis's record when its embargo ends, so the sync also reads the theses whose embargo date has passed. One sync checks the embargo of at most 200 theses.
The removal check compares the repository's whole list with the catalogue. A thesis that is no longer on the list is unpublished. A record on the list with a newer date than ours is read again. Some repositories report deleted records only for a while. Thanks to this check, a thesis deleted from the repository is unpublished within a week at the latest.
If the repository's address, the record format or the sets change while a run is going on, the run stops halfway and its problems say the source changed. Start the run again with the new settings.
Night hours
Full harvests and scheduled runs take place in the night hours, when the repository's load is low. By default they are from 01:00 to 06:00, and the Night hours line of the screen shows them. The system administrator changes them in the installation settings.
A full harvest asked for outside the night hours starts when they come. The Sync now and Check for removed theses buttons start their run at once.
Pauses between requests
JournTech sends its requests to the repository one at a time and waits two seconds before each one. When full texts are copied, it waits ten seconds before each file. If the repository's robots.txt asks for a longer pause, JournTech keeps to it up to thirty seconds. If the repository says it is busy, JournTech waits for the time the repository asks for and sends the request again. If the repository names no time, it waits half a minute, then one minute, then two minutes.
The list of records is read page by page, and each page is queued as a job of its own. Every thesis read is saved at once, so the theses read before a harvest stopped are not lost. A run that takes longer than twelve hours counts as failed and is closed.
Safety limit for removals
During maintenance or a migration, a repository may leave part of its records off its list for a while. So that a scheduled check does not empty the catalogue in such a case, there is a limit. If the number of theses missing from the repository's list is greater than both 25 and 5 per cent of the imported theses, the check unpublishes none of them. The run's problems say so, and an alert goes to the system administrators.
If the theses really were removed from the repository, start the check by hand with Check for removed theses. A check started by hand does not apply the limit. The details are in The removal check did not remove the theses.
Failed runs
If the repository cannot be reached, gives an answer that cannot be read, or the run stops halfway, the run ends with the Failed status and an operations alert goes to the system administrators. A problem in a single record does not stop the run.
Nor does a page the repository cannot produce in spite of several tries. The repository usually fails because it cannot write one record on that page. JournTech then gets that set's list of records again from its start and asks for the records it has not harvested yet one at a time. A record the repository still cannot produce is added to the list of problems; the other records are harvested. The next set is read page by page as usual. The solutions are in Thesis harvest looks failed.
Screens and settings
Thesis Harvest Screen
The status card, the harvest buttons, the source settings, the list of recent runs and the transfer report of the thesis harvest screen.
The Catalogue → Thesis harvest screen is where you set up, start and follow the harvest of theses from the institution's open repository. The screen needs the Bulk import (CSV, XLSX, JSON) permission. Only people with the Manage site settings and feature flags permission change the source settings. Everyone else sees them read-only.
The Transfer report (CSV) button at the top of the screen downloads the transfer report. Its columns are listed at the end of this topic.

Status
The first line of the Status card says where the harvest stands. While a run is going on, the screen refreshes itself every few seconds.
| Count | Meaning |
|---|---|
| Records read | Every record seen in the chosen sets |
| Published | Imported theses that are published in the catalogue |
| Drafts | Theses that stay drafts because they did not pass the publishing checks |
| Embargoed | Theses whose embargo is still running in the repository |
| Restricted | Theses with restricted access in the repository |
| Removed from the archive | Theses unpublished because they were removed from the repository |
| Skipped records | Records not imported because they are not theses or could not be read |
Under the counts you see when the last full harvest, sync and check for removals finished. The Next run line shows the system's next run and the earliest time it starts. The Night hours line shows the hours in which full harvests and scheduled runs take place.
Harvest buttons
| Button | What it does |
|---|---|
| Sync now | Brings the theses that are new or changed in the repository since the last sync. |
| Check for removed theses | Compares the repository's whole list with the catalogue and unpublishes the theses the repository no longer has. |
| Full harvest | Reads every record in the chosen sets again. |
Sync now and Check for removed theses stay disabled until the first full harvest has finished. While a run is going on, or while the harvest is switched off, all three buttons are disabled. The note under a button gives the reason.
Check for removed theses asks for confirmation first. A check started by hand unpublishes every thesis that is missing from the repository's list. The safety limit of the scheduled check does not apply to it. The limit is explained in Full Harvest and Sync.
If you press Full harvest outside the night hours, the harvest starts when they come. The screen tells you when it starts.
Source settings
| Field | Meaning |
|---|---|
| Harvest on | While it is on, the scheduled runs take place. |
| OAI-PMH address | The repository's OAI-PMH address. The Check the source button checks it. |
| Metadata format | The record format the harvest reads. The recommended format is marked. |
| Sets | The sets the theses are imported from. The list shows the sets the last check read and the date of that check. |
| Full text | Whether readers reach the full text in the repository or the file is copied here |
| Original page | The page search engines treat as the original |
| Institution name | The name of the university that awards the degrees. It goes into the institution field of the imported theses. |
| Its entry in the institution tree | The university's record in the institution tree. The list shows with the Create and edit persons and institutions permission. |
How to fill in the fields is explained in Setting Up the Thesis Harvest.
Recent runs
The Recent harvests table lists the last ten runs. The Kind column shows the kind of run, and Started shows when it started and who started it. Result shows the main counts above zero.
The row of a run started by hand gives the name of the person who started it. A full harvest asked for outside the night hours shows the name of the person who asked for it. A run the system started by itself shows Scheduled. If the account of the person who started it was deleted, Started by a user takes the place of the name.
The Details button of a row opens all the counts of the run, the records by set and the problems.

| Count | Meaning |
|---|---|
| Records in the archive | Records the repository listed in a check for removals |
| Records read | Records read in this run |
| New | Theses newly created in the catalogue |
| Updated | Theses updated because they changed in the repository |
| Unchanged | Theses skipped because they did not change in the repository |
| Removed | Theses unpublished because they were removed from the repository |
| Back again | Theses that came back because the repository lists them again |
| Skipped | Records not imported because they are not theses or could not be read |
| Left as drafts | Theses that stay drafts because they did not pass the publishing checks |
| Embargo lifted | Theses that became open access because their embargo ended |
| Files copied | Full texts copied |
| Files to try again | Full texts the repository did not give at the moment, to be asked for again later |
| Errors | Problems found in records |
| Pages read | Pages read from the repository |
The Records by set table shows, for every set, how many records the repository reports next to how many the run read. When the two differ, the row shows a warning sign.
The Problems and skipped records list gives each problem's record identifier and its cause. The list shows the first twenty problems. If there are more, the Show all problems button opens up to a hundred. How to solve them is explained in Thesis harvest looks failed.
Transfer report
The Transfer report (CSV) button downloads a CSV file with one row for every record the harvest knows. The file opens in a spreadsheet with Turkish characters intact.
| Column | Content |
|---|---|
oai_identifier |
The record's OAI identifier in the repository |
source_url |
The record's page in the repository |
title |
The thesis title |
level |
The kind of thesis (ms master's, phd doctoral, art proficiency in art, medical medical specialty) |
year |
The thesis year |
status |
published, draft, removed (removed from the repository), skipped (not imported), deleted (deleted in the catalogue) |
access |
The access status |
embargo_until |
When the embargo ends |
local_url |
The address of a published thesis on this site |
note |
Why the thesis stays a draft, was skipped or was removed |
Concept
Harvested Theses
Which details the thesis harvest takes from the repository, how it decides the kind of thesis and its access status, when it publishes theses and how harvested theses behave in the panel and on the public site.
The thesis harvest creates a thesis record in the catalogue for every thesis in the chosen sets of the repository. The original of the record stays in the repository. A thesis that changes in the repository is updated in the catalogue at the next sync too.
Details taken from the repository
The thesis harvest takes these details from the repository.
| Field in the catalogue | Where it comes from in the repository |
|---|---|
| Title, abstract and keywords | The thesis title and its title in the other language, its abstracts and subject words |
| Author | The author of the thesis |
| Advisor | The advisors of the thesis |
| Graduate school or faculty | The graduate school or faculty that published the thesis |
| Department | The department or programme of the thesis |
| Level | The kind of thesis |
| Year and publication date | The date the thesis was published |
| Language of the work | The language of the thesis |
| Access status and embargo | The rights statement of the thesis and its embargo date |
| Licence | The licence address of the thesis |
| Persistent identifier | The handle address of the thesis and its DOI, if it has one |
The institution field gets the university name typed on the thesis harvest screen. The repository's language tags are not always right, so a text's own words decide whether it is Turkish or English. The "ÖZET" heading and the reference line in DSpace's Turkish abstract field are left out of the abstract. Names and titles written in capitals are changed so that only their first letters are capitals.
Authors are linked to existing person records by their ORCID iD, or by an exact match of their names when there is no ORCID iD. If nothing matches, a new person record is created. You can merge duplicate persons as in Merging Person Records. Advisors are not linked to person records. Their names go into the record's advisor field.
Kind of thesis
The kind of thesis comes from the repository's type and subtype. In DSpace repositories a thesis whose subtype is medical specialty becomes Medical specialty, and one whose subtype is proficiency in art becomes Proficiency in art. Without a subtype, a master's thesis becomes Master's and a doctoral thesis Doctoral. Records that are not theses, such as bachelor's theses, working papers or datasets, are not harvested and count under Skipped records.
Access status and full text
- A thesis with an embargo date in the future in the repository becomes Embargoed, and the date the embargo ends goes into the record. When the embargo ends, the thesis becomes open access at the next sync.
- A thesis known to be embargoed in the repository, but without an end date, becomes Restricted.
- A thesis with restricted access in the repository becomes Restricted, and one whose details only are open becomes Metadata only.
- All other theses become Open access.
The full text of an open-access thesis opens through a link to the file in the repository or is copied here, depending on the choice on the thesis harvest screen. The files of embargoed and restricted theses are never copied or linked.
Licence
The licence of a thesis is found from the licence address in the repository. If the catalogue's licence list has a licence with the same address, the thesis is published under it. If the repository names a Creative Commons licence the list lacks, the thesis harvest adds that licence to the list. A thesis under CC BY-NC-ND 3.0 US, for example, is published under its own licence and is not turned into the 4.0 version. If the repository names no licence at all, the thesis gets the All rights reserved licence. The rights then stay with its author, and the repository only distributes it. An open-access thesis that comes with a licence the catalogue does not know, other than a Creative Commons one, stays a draft.
Publishing
A harvested thesis is published when it passes the catalogue's publishing checks. If it does not, it stays a draft. A thesis that stays a draft is tried again when it changes in the repository or at the next full harvest. The installation's editor approval rule does not apply to this publishing, because the thesis is already published in the repository. For theses that stay drafts, see A harvested thesis stays a draft.
A thesis an editor unpublished is not published again. A thesis deleted in the catalogue is not created again by the harvest.
Theses removed from the repository
If the repository reports that it deleted a thesis, or the removal check does not find the thesis on the repository's list, the thesis is unpublished and goes back to draft. If the repository lists the thesis again, it comes back at the next sync.
A harvested thesis in the panel
At the top of a harvested thesis's record form, a note says the thesis came from the repository, with the Open the archive's record link. The fields that come from the repository are read-only. Correct a mistake in the repository's record, and the next sync brings the correction here. You can change the thesis's categories, whether it is featured on the home page and its relations to other records in the panel. The details are in The details of a harvested thesis cannot be changed.
On the public site
- The thesis page links to the record in the repository and says the thesis was harvested from the institution's open repository.
- When The archive's record is chosen as the original page on the thesis harvest screen, the original address the page gives is the record in the repository. The page writes no Google Scholar tags, and the thesis stays out of the sitemap and of this site's OAI-PMH output.
- Harvested theses do not appear in the new publications section of the home page. They appear on the Institutional Archive pages, in search and in the catalogue lists of the public site.
- JournTech does not send harvested theses to Crossref. If a thesis has a DOI, the repository registered it itself.
Troubleshooting
Check the source gives an error
What to do when Check the source says the repository cannot be reached, the address is not an OAI-PMH service or robots.txt does not allow it.
When Check the source cannot read the repository's identity, formats and sets, the reason appears under OAI-PMH address. The harvest can only be switched on with an address whose check succeeded. Follow the section below that matches the message under the field.
The address cannot be reached
If the repository did not answer, or the check did not finish within a minute, the message says the address cannot be reached.
- Check that the address is typed correctly. It starts with
https://orhttp://and contains no question mark or parameters. - Open the address in a browser and add
?verb=Identifyat its end. If the repository answers, the page shows its name. - If the browser gets an answer but the check still cannot reach the repository, the JournTech server cannot reach it. Ask your IT department to let the JournTech server connect to the repository's address.
- If the repository is busy at the moment, try again a little later.
The address is not an OAI-PMH service
If the address answered but the answer is not an OAI-PMH answer, the message says the address is not an OAI-PMH
service. This mostly happens when the repository's home page or search page was entered. In DSpace 7 and later the
OAI-PMH address ends in /server/oai/request, in older versions usually in /oai/request. Ask the repository's
administrator for the right address.
robots.txt does not allow it
If the repository's robots.txt forbids reading the OAI-PMH address, JournTech does not read the repository. Ask the repository's administrator to open the OAI-PMH address in robots.txt. Once they have, check the source again.
The address has not been checked yet
If saving with Harvest on switched on says the address has not been checked yet, the address changed after the last check. Press Check the source and save again when the check is done.
Troubleshooting
Thesis harvest looks failed
What to do when a thesis harvest run ended with the Failed status or its results list problems, by waiting, asking the repository's administrator or starting the harvest again, depending on the cause.
When a run cannot get the list of records from the repository, or stops halfway, it ends with the Failed status. A problem in a single thesis does not stop the run; it only appears in the list of problems. Nor does a page the repository cannot produce. To see the problems, press the run's Details button in the Recent harvests table. Follow the section below that matches the cause the problem line gives.
The repository is not answering
If the line says "The source archive could not be reached." or that the repository is not answering right now, the repository did not answer despite several attempts. Start the run again a little later. If you do not start it by hand, the system tries again the next night. If the problem lasts for several days, contact the repository's administrator.
The repository gave an answer that cannot be read
If the line says "The source archive sent an answer that cannot be read.", or that the repository reported an OAI error or answered unexpectedly, the repository's answer could not be read. Try again a little later. If the problem continues, pass the error code on the line to the repository's administrator.
robots.txt no longer allows it
If the line says "The source archive's robots.txt does not allow its OAI-PMH address.", the repository's robots.txt changed after the check. Ask the repository's administrator to open the OAI-PMH address again.
The run stopped halfway
If the line says "The harvest stopped without finishing.", the run took longer than twelve hours and the system closed it as failed. Start the run again. The theses read until then stay in the catalogue, and the unchanged ones are not written again.
If the line says "The archive's address, format or sets changed during the harvest. Start it again.", the repository's address, the record format or the sets were changed while the run was going on. Start the run again with the new settings.
Problem lines in a finished run
A run with the Done status can also list the problems of single records.
- If the line says the record is not a thesis, the record is of another kind, such as a bachelor's thesis or a dataset, and is not harvested. If it is a thesis, correct its type in the repository.
- "The record has no title." says the record has no title in any language. Add the title in the repository.
- "The record's OAI identifier is longer than 128 characters." says the record's identifier is too long to be harvested. Tell the repository's administrator.
- "The record could not be added to the catalogue." says the catalogue refused the record. The rest of the message gives the reason.
- "The source archive could not produce this page, so the set's records were asked for one at a time." says the repository could not produce a page in spite of several tries. It usually fails because it cannot write one record on that page. JournTech then gets the set's list again from its start and asks for the records it has not harvested yet one at a time. The run therefore takes longer than usual.
- If the line says the repository could not produce the record, the repository refused the record with an error each time it was asked for, and the record was not harvested. The error usually comes from the record itself; its abstract may hold a character that XML does not accept, for example. Pass the record identifier on the line to the repository's administrator. Once the record is corrected in the repository, the next sync brings it.
- If the line says the thesis stays a draft, see A harvested thesis stays a draft.
Full-text problems
These problems only come up while full texts are copied.
- If the line says the full text was not downloaded for now, the repository did not give the file at that moment. The file is asked for again up to five times, twenty minutes apart.
- If the line says the full text was not downloaded, the repository refused to give the file. Check that the file is open access in the repository.
- "The full text is larger than the 150 MB limit." says the file is too large to be copied. In that case the thesis page does not show the full text.
The removal check did not remove theses
If the line says "Many theses were missing from the source archive's list. As that is beyond the safety limit, no thesis was unpublished.", see The removal check did not remove the theses.
The alert to the system administrators
Every run that ends as failed sends an operations alert to the system administrators. At most one alert is sent per hour. The alert links to the Thesis harvest screen. Alerts are explained in Operations Alerts.
Troubleshooting
A harvested thesis stays a draft
What to do when a thesis harvested from the repository is not published and stays a draft, by finding the reason in the problem list or the transfer report and fixing it in the repository or the installation.
A harvested thesis that does not pass the catalogue's publishing checks stays a draft. You find the reason in two
places. The run's problem list says which check the thesis did not pass. In the Transfer report (CSV) file, the
thesis's status column says draft and its note column gives the code of the reason. Follow the section below that
matches the code.
A thesis that stays a draft is tried again when it changes in the repository or at the next full harvest.
The licence is not known
If the code is open_needs_licence, the thesis is open access, but the licence the repository names is not in the
catalogue's licence list. The thesis harvest adds the Creative Commons licences a repository names to the list by
itself. This code comes up with a licence address that is not Creative Commons. Check the licence address in the
repository. If it is wrong, have the repository's administrator correct it. If it is right, contact your system
administrator.
The author or the year is missing
If the code is author_required, the record in the repository has no author. If the code is year_required, the
record has no date for the thesis. Add it to the record in the repository. As the record changed in the repository,
the thesis is tried again at the next sync.
An editor unpublished the thesis
If the note column says taken_down, the thesis was published once and an editor unpublished it. The thesis harvest
does not publish again a thesis an editor took down. To publish it again, use the publish button of its record form.
The thesis was removed from the repository
If the status column says removed, the thesis went back to draft because it was removed from the repository.
deleted in the note column means the repository reported that it deleted the thesis, and missing means the thesis
was not on the repository's list in a removal check. If the repository lists the thesis again, it comes back at the
next sync.
Troubleshooting
A thesis in the repository does not show on the site
What to do when a thesis in the institution's open repository does not show on the public site, by looking up its status in the transfer report and correcting the set, the thesis type or the record in the repository.
If a thesis in the repository does not show on the public site, first download the Transfer report (CSV) file on the
Catalogue → Thesis harvest screen. Look the thesis up in the file by its OAI identifier or title,
and follow the section below that matches the status column of its row.
A thesis missing from the report
If the thesis is not in the report, the harvest has not read it yet.
- Check that the collection the thesis is in is among the chosen sets. If it is not, choose the set in Sets, save and start a full harvest. If the collection is not in the list, it was added to the repository after the last check. Check the source again first in that case.
- If the thesis was added to the repository recently, it comes with the next night's sync. To bring it at once, press Sync now.
A thesis not harvested (skipped)
The thesis was not harvested, and the note column gives the reason. The not_thesis code says the record is not a
thesis. After the code comes the record's type in the repository, for example not_thesis:bachelorThesis. The
no_title code says the record has no title. Master's, doctoral, proficiency in art and medical specialty theses are
harvested. If the record is a thesis, correct its type or title in the repository. The next sync then brings it.
A thesis that stays a draft (draft)
The thesis stays a draft in the catalogue. The reason is explained in A harvested thesis stays a draft.
A thesis removed from the repository (removed)
The thesis was unpublished because it was removed from the repository. If the repository lists it again, it comes back at the next sync.
A published thesis (published)
The thesis is published on the site, and the local_url column gives its address. Harvested theses do not appear in
the new publications section of the home page. You find the thesis on the Theses page of the public site or in
search.
The page of an embargoed or restricted thesis shows only its bibliographic details, and the full text does not open. If there is an embargo end date, the page shows it.
Troubleshooting
The removal check did not remove the theses
What to do when a scheduled removal check unpublished no thesis because many theses were missing from the repository's list, by checking the repository's address and the sets and, if needed, starting the check by hand.
If the system started the removal check and the check did not find many theses on the repository's list, no thesis is unpublished. The run's problems say "Many theses were missing from the source archive's list. As that is beyond the safety limit, no thesis was unpublished.", and an alert goes to the system administrators. The limit applies when the number of theses missing from the repository's list is greater than both 25 and 5 per cent of the harvested theses. Why it exists is explained in Full Harvest and Sync.
- Press the check's Details button in the Recent harvests table.
- In the Records by set table, find the sets with fewer records than expected or none at all.
- Ask the repository's administrator whether these sets changed.
Depending on the answer, follow one of the ways below.
The repository had a passing problem
If the repository was under maintenance or left part of its records off its list for a while, you need to do nothing. The next scheduled check reads the repository's whole list again.
The repository's sets changed
If collections were merged, moved or renamed in the repository, the theses are now in other sets.
- Press Check the source.
- In Sets, choose the new sets and untick the ones that no longer exist.
- Press Save.
- Start a full harvest.
The full harvest sees the theses in the new sets, and the next check does not remove them.
The theses really were removed from the repository
If the repository's administrator confirms the theses were removed, press Check for removed theses and confirm. A check started by hand does not apply the safety limit and unpublishes every thesis missing from the repository's list.
Troubleshooting
The details of a harvested thesis cannot be changed
What to do when the fields of a thesis harvested from the institutional repository are locked in the record form or saving is refused, by correcting it in the repository and using the fields the panel can change.
The original of a thesis harvested from the institutional repository is in the repository, so the fields that come from there are locked in the record form. The note at the top of the form says the thesis came from the repository and when the repository last listed it.
Correcting a detail
- Open the thesis's record in the repository with the Open the archive's record link at the top of the form.
- Correct the mistake in the repository's record, or have the repository's administrator correct it.
- If you want the correction at once, press Sync now on the Catalogue → Thesis harvest screen.
If you do not press the button, the correction comes with the next night's sync.
What the panel can change
You can change these settings of a harvested thesis in the panel.
- The thesis's categories
- Whether the thesis is featured on the home page, and its place there
- The thesis's relations to other records
These settings do not come from the repository, and the sync leaves them alone. The thesis's files come from the repository and cannot be changed in the panel. An earlier version of the thesis cannot be restored either.
Keeping a thesis off the site
If you do not want a thesis on the site, unpublish it from its record form. The thesis harvest does not publish again a thesis an editor unpublished. If the thesis must also leave the repository, contact the repository's administrator.
Feature
People and Institutions
Editing author, editor and institution records and merging duplicate person records.
The authors, editors and other contributors in the catalogue are person records. People and institutions are managed on the Catalogue → People & institutions screen. Institutions form a tree of parent institutions and their units.
If a person has two separate records, the records are merged and the publications are gathered on one record. The system scans for possible duplicates every day and lists them on the Duplicates tab. A merge cannot be undone and is written to the audit log.
Deleted people and institutions do not disappear permanently. They can be restored if needed. A person's e-mail address is never shown on public pages.
How-to
Managing People and Institutions
Adding, editing and deleting the person records and the institution tree of the catalogue, and restoring deleted ones.
You manage person and institution records on the Catalogue → People & institutions screen. People are on the People tab and institutions on the Institutions tab. You can also create a new person while adding an author to a catalogue record. That way is explained in Adding Authors and Contributors.
Adding a person
- On the People tab, press New person.
- In the Display name field, type the name the person will have in publications.
- If you know them, fill in the Given name, Family name and ORCID iD fields.
- Select the person's current institution from the Institution list.
- Press Create.
The person's page opens. If there are people with similar names, the notification at the bottom right gives their names. If the new record belongs to the same person, merge it with the existing record as in Merging Person Records.
You can type the ORCID iD in the form 0000-0002-1825-0097 or as an https://orcid.org/… link. Its check digit is verified. An ORCID iD can belong to only one person in the catalogue. The address in the E-mail (private) field is never shown on public pages.
Editing a person's details
- On the People tab, press the person's name.
- Correct the details on the Identity card.
- On the Short bio card, write the Turkish and English bio.
- On the Affiliations card, press Add institution.
- Select the institution on the new row.
- If you want, fill in the Title / position, From and To fields.
- Press Save.
A person can have at most 20 institution links. The end date of a link cannot be before its start date. If the Display name changes, the person's slug is renewed from the new name. Whether the slug changes this way or in the Slug (URL) field, the old address redirects to the new one. The Public page button at the top of the page opens the person's author page on the public site.
Deleting and restoring a person
Only a person who does not appear in any publication can be deleted.
- On the person's page or in the row menu of the list, select Delete person.
- Confirm the deletion in the window that opens.
A deleted person is not gone for good. When you tick the Show deleted box, the list shows deleted people. Restore in the row menu brings the person back. Until a deleted person is restored, they cannot be added to publications and their public page does not appear.
Adding an institution
- On the Institutions tab, press New institution.
- Fill in the Name (Turkish) field and, if there is one, the Name (English) field.
- If the institution is a unit of another institution, select the parent from the Parent institution list.
- Fill in the ROR ID, Country code, City and Website fields.
- Press Save.
To add a unit under an institution, select Add sub-unit from that institution's menu in the tree. The parent institution field fills in by itself. To take the institution's details from its ROR record, see Searching ROR for an Institution.
The country code is two capital letters, and a new institution comes with TR filled in. A ROR ID can belong to only one institution. An institution cannot be moved under itself or under one of its sub-units. If an institution's slug changes, its old address redirects to the new one.
Deleting and restoring an institution
An institution with sub-units or linked people, or one that a publication lists as its authors' institution, cannot be deleted. In the tree, the Delete institution item of an institution with sub-units is disabled.
- In the tree, select Delete institution from the institution's menu.
- Confirm the deletion in the window that opens.
The Show deleted box on the Institutions tab lists deleted institutions with the time they were deleted. The Restore button on the row brings the institution back. To restore a sub-unit, restore its parent institution first. Deleting and restoring are written to the audit log.
The reasons why a record cannot be deleted or restored are in A person or institution cannot be deleted and A deleted person or institution cannot be restored.
How-to
Searching ROR for an Institution
Finding an institution's ROR record with the Search ROR button of the institution form and copying its ROR ID, names and contact details into the form.
ROR (Research Organization Registry) gives research organisations a persistent identifier. The Search ROR button in the institution form lists the matches in ROR and writes the ROR ID and the name of the record you select into the form.
Before you start
The button appears only if the system administrator switched on ROR search in the institution form on the Administration → Site settings → Integrations tab. The server must be able to reach api.ror.org.
Searching and selecting
- On the Catalogue → People & institutions screen, open the Institutions tab.
- Press New institution, or select Edit from the menu of an existing institution.
- In the form, press Search ROR. The search box fills with the institution's name from the form.
- If needed, change the name to search for.
- Press Search.
- In the list, press the institution's record.
- Check the details written into the form.
- Press Save.
The list shows at most 10 matches with their name, acronym, city, country and ROR ID. A search needs at least two characters.
Details written into the form
The ROR ID of the record you select is written into the ROR ID field. If the ROR record has a Turkish name, it goes into the Name (Turkish) field. If it has an English name, that goes into the Name (English) field. If the Turkish name field is empty and ROR has no Turkish name, the record's name in ROR is written. The country, city and website are filled in only if they are empty in the form.
Marked matches
- A record that is not active in ROR is marked Inactive in ROR, and a record withdrawn from ROR is marked Withdrawn from ROR.
- A ROR ID used by another institution cannot be selected. The row says which institution uses the ID.
When ROR does not answer
If ROR cannot be reached, the warning "ROR is not answering right now. Try again a little later." appears instead of the list. You can also type the ROR ID into the ROR ID field by hand. The ID has nine characters and starts with 0. You can also paste the ID as an https://ror.org/… link.
How-to
Merging Person Records
Merging two person records of the same person and gathering their publication links and details in the record that is kept.
If a person has two separate records, you merge the record to remove into the record to keep. All publication links of the removed record move to the record that is kept. A merge cannot be undone.
Opening the merge window
You open the window from these places:
- The Merge with another person button on the person's page.
- Merge with another person in the person's row menu in the People list.
- The merge buttons on the Duplicates tab.
- The Merge button on the Possible duplicates card of the person's page.
Steps
- On the person's page, press Merge with another person. This person comes in as the Profile to remove (source).
- In the Search the target person field of the Profile to keep (target) card, type the name or ORCID iD of the person to keep.
- Select the person to keep from the list.
- If the source and the target are the wrong way round, press Swap direction between the two cards.
- If you want, type the reason for the merge in the Reason field.
- Press Merge.
The notification says how many contributions were moved and how many publications were updated. If you started the merge from a person's page, the page of the person you kept opens.
Results of the merge
- The publication contributions of the removed record move to the record that is kept. If the kept person already appears on the same publication with the same role, the duplicate contribution is deleted. Its corresponding author mark, institutions and contribution roles are added to the remaining contribution.
- If a user account's profile or author rows of submissions point to the removed record, they point to the kept record afterwards.
- The institution links of the removed record that the kept record does not have are added.
- The ORCID iD, the user account link, the bio, the web page and the e-mail are taken from the removed record if they are empty in the kept record.
- The old addresses of the removed record on the public site redirect to the page of the kept person.
- The duplicate match between the two people is closed. The other matches of the removed person leave the queue too.
- The action is written to the audit log with its reason.
If two people try to merge the same pair in opposite directions at the same time, the second action waits for the first one to finish and stops with the warning "This person was merged into another record; a merged record cannot be restored."
Records that cannot be merged
- Two people with different ORCID iDs cannot be merged.
- Two people linked to different user accounts cannot be merged.
- A record that was merged before cannot be merged again.
- A deleted person cannot be merged. Restore the person first with Restore.
How to solve these cases is explained in Person records cannot be merged. Merging needs a separate permission. The Production coordinator role edits person records but cannot merge them.
How-to
Reviewing Duplicate Records
Reviewing the possible duplicate person records the system finds every day, merging records of the same person and taking different people out of the queue.
The system scans person records every day and lists pairs that may belong to the same person on the Duplicates tab of the Catalogue → People & institutions screen. For each pair you merge the records or mark them as different people. The tab is open only to people with the merge permission.
Building the list
- Pairs of people with similar names go on the list. The percentage on the row shows how similar the two names are.
- Pairs with a similarity below 55 per cent do not go on the list.
- Two records with the same ORCID iD count as 100 per cent similar.
- If two people share an institution, 10 points are added to their similarity.
- People with different ORCID iDs never match.
- Deleted and merged people are not scanned.
- A pair that was merged or marked as different people does not come back to the list. The scan counts only new pairs, so a new pair is found however many old pairs fill the queue.
- When an import, a DergiPark harvest or a release brings a new author, the system does not guess a match with a person of the same name. If the author's ORCID iD is not in the catalogue, or several people have that name, a new person record is created and enters the list with its namesakes at 100 percent similarity. You decide whether the records belong to the same person.
The list is sorted from the highest similarity down.
Reviewing the pairs
- On the Catalogue → People & institutions screen, open the Duplicates tab.
- Compare the names, ORCID iDs and institutions of the two people on the row.
- If you are not sure, press a person's name to open their page.
- If the two records belong to the same person, press one of the two merge buttons on the row.
- In the window that opens, complete the merge as in Merging Person Records.
- If the records belong to different people, press Different people.
A merge button shows the two names with an arrow. The record on the left of the arrow is removed, and the record on the right is kept. A pair you mark with Different people leaves the queue, and the people's records do not change.
Running the scan at once
To scan newly added people without waiting for the next day, press Scan again at the top of the tab. The notification says how many new possible duplicates were added to the queue.
A person's pending matches also appear on the Possible duplicates card of their own page. The Merge button on the card opens the window with the person whose page you are on as the source and the matching person as the target. If needed, turn the direction round with Swap direction.
Screens and settings
People and Institutions Screen
The tabs, filters, columns and menus of the screen with the person records, the institution tree and the queue of duplicate records.
The Catalogue → People & institutions screen shows the person records of the authors, editors and other contributors in the catalogue, the institution tree and the pairs of people that may be duplicates. The screen needs the person management permission.
Tabs and the button at the top
| Tab | Contents | Button at the top |
|---|---|---|
| People | Person records | New person |
| Institutions | Institutions and their sub-units | New institution |
| Duplicates | Pending pairs that may be duplicates | Scan again |
The Duplicates tab opens only for people with the merge permission and shows the number of pending pairs.
People tab
The search box finds people by any part of their name. Turkish characters and upper or lower case make no difference. To search by ORCID iD, type the full number with its hyphens. The ORCID filter separates people with an ORCID iD from people without one. The Show deleted box lists deleted people.
| Column | What it shows |
|---|---|
| Person | The person's name. A person with an account shows "Linked to a user account", and a deleted person shows "Deleted" |
| ORCID | ORCID iD, with a link to the record on orcid.org |
| Institution | The person's institution links |
| Records | The number of records where the person appears as a contributor. Drafts and records in the trash are counted too |
The row menu has Edit, Merge with another person and Delete person. Deleting is disabled for a person who appears in a publication. The menu of a deleted person shows only Restore.
Institutions tab
Institutions are shown as a tree. A row shows the institution's name, its English name when the panel is in Turkish, its city and country, its ROR ID and the number of sub-units. A missing translation is marked on the row. You open and close the sub-units with the arrow.
The row menu has Add sub-unit, Edit and Delete institution. Deleting is disabled for an institution with sub-units. The Show deleted box shows, instead of the tree, the list of deleted institutions with the Deleted at column and the Restore button.
Duplicates tab
Each row shows the similarity percentage and the two people's names, ORCID iDs and institutions. The two merge buttons on the row start the merge in one of the two directions. The Different people button takes the pair out of the queue.
Related topics
Screens and settings
Person Page
A person record's identity details, bio, institution links, possible duplicates and the merge and delete buttons.
The person page is the screen where you edit the details of a person record. You open the page by pressing the person's name in the Catalogue → People & institutions list.
Page header
The header shows the person's name, the ORCID iD if there is one, and how many publications the person contributed to. If the person is linked to a user account, the "Linked to a user account" label appears. The Public page button opens the person's author page on the public site.
On the page of a merged person, the note "This profile was merged into another profile." and the Open the current profile link appear. The page of a deleted person has a deletion note and the Restore button.
Identity details
| Field | Description |
|---|---|
| Display name | The person's name as shown in publications and on the public site, required |
| Given name and Family name | The given name and family name used in citations and exports. A person with two family names appears in citations with the whole family name. For a corporate or group author, leave the given name empty and write the whole name as the family name. Citations show this name as written |
| ORCID iD | Checked with its check digit, and held by only one person in the catalogue |
| E-mail (private) | Never shown on public pages |
| Web page | An address that starts with https:// or http:// |
| Slug (URL) | The last part of the address on the public site. If it changes, the old address redirects to the new one |
Bio and institution links
On the Short bio card, the Turkish and English texts are written on separate tabs. You can enter at most 4000 characters in each language.
Each row on the Affiliations card has the Institution, Title / position, From and To fields. Add institution adds a new row. A person can have at most 20 institution links.
The Save button becomes active when you make a change.
Side cards
- The Possible duplicates card shows the person's pending matches with their similarity percentage. Each row gives the other person's name and the reason for the match, for example the same ORCID iD or a similar name. The name opens the other person's page. Only people with the merge permission see the card.
- The Merge with another person button opens the merge window with this person as the source. If there are unsaved changes, the panel asks before it opens the merge window.
- The Delete person button is active only for a person who does not appear in any publication.
Related topics
Troubleshooting
A person or institution cannot be deleted
Why Delete person or Delete institution is disabled or deleting gives an error, and how to solve it.
A person can be deleted only if they do not appear in any publication. An institution can be deleted only if it has no sub-units and no linked people and no publication lists it as the institution of its authors. See which of the cases below applies.
The person appears in a publication
If the Records column of the list shows a number above zero, Delete person is disabled. This number also includes records in draft and in the trash. There are two solutions:
- If the person is a duplicate of another person record, merge the two records as in Merging Person Records.
- If the person was added by mistake, remove the person from the Authors and contributors section of the records concerned, then delete the person.
The person was merged or is already deleted
On the page of a merged person, the delete button is disabled. This record stays as a redirect to the kept person. A deleted person is already in the trash and appears in the Show deleted list.
The institution has sub-units
In the tree, the Delete institution item of an institution with sub-units is disabled. First delete the sub-units, or move them under another parent institution with Edit.
People are linked to the institution
If the institution appears on a person's Affiliations card, deleting stops with a warning. On the people's pages, remove this institution from their links or replace it with the right institution, then delete the institution again.
Institution links of deleted people count too. If the link is on a deleted person, restore the person, remove the link and save, then delete the person again.
Authors of publications list the institution
If a contributor in the Authors and contributors section of a publication has this institution, deleting stops with a warning. The warning says how many publications use the institution. In these publications, replace the contributor's institution with the right one and save, then delete the institution again. A deleted institution does not appear as an author's institution on publication pages, because its page no longer opens.
Troubleshooting
Person records cannot be merged
Why the button for merging people does not appear or the merge gives an error, and how to solve it.
If the system finds a detail that shows the two records belong to different people, it does not merge them. Follow the section below that matches the warning in the window or the notification.
The merge button does not appear
The Merge with another person button and the Duplicates tab are open only to people with the merge permission. A Production coordinator can edit people but cannot merge them. A Catalogue editor does the merge.
The two people have different ORCID iDs
Two records with different ORCID iDs count as separate people and are not merged. If the ORCID iD in one of the records is wrong, first correct the ORCID iD on that person's page and save. Then try the merge again.
The people are linked to different user accounts
If both records say "Linked to a user account" and the accounts are different, the records are not merged. These two records belong to separate account holders.
One of the records was merged before
A merged record stays as a redirect to the kept person and cannot be merged again. Go to the current record with the Open the current profile link on the record's page and do the merge with that record.
The source and the target are the same person
If the same person is selected on both cards of the window, the warning "The source and target must be different." appears. Select another person on the target card.
One of the people was deleted
A deleted person cannot be merged. First restore the person from the Show deleted list, then merge.
Troubleshooting
A deleted person or institution cannot be restored
Why a person or institution in the Show deleted list does not come back with Restore, and how to solve it.
Deleted people and institutions come back from the Show deleted list with Restore. Restoring stops in the cases below.
The person's ORCID iD is on another person
If the same ORCID iD was given to another person after the person was deleted, restoring stops and the warning "Another person has this ORCID iD. Merge the two records." appears. An ORCID iD can belong to only one person in the catalogue. A deleted person cannot be merged either. Bring the two records together in this order:
- Open the page of the person who now holds the ORCID iD.
- Clear the ORCID iD field.
- Press Save.
- Restore the deleted person with Restore.
- Merge the two records as in Merging Person Records.
In the merge, the ORCID iD is taken from the removed record if it is empty in the kept record.
The person was merged
A merged person cannot be restored. This record does not appear in the deleted list either, and its old addresses redirect to the page of the kept person. Edit the details on the kept person's page.
The institution's parent was deleted too
A sub-unit goes back under its parent institution. If the parent was deleted, restoring stops and the warning "Restore the parent institution first." appears. In the deleted list on the Institutions tab, restore the parent first and then the sub-unit.
Feature
Categories
Managing the category trees that group the publications on the public site.
Categories group the publications on the public site by subject and type. They are managed on the Catalogue → Categories screen as trees divided into taxonomies. An installation comes with two taxonomies, one for the fields of science and one for type categories.
A publication can be linked to more than one category. A book must have at least one category before it can be published. Category pages are listed on the public site. Hidden or inactive categories do not appear in the lists of the public site.
A category in use is not deleted but merged into another category. When categories are merged, the publications and subcategories move to the target, and the old address redirects to the target category.
How-to
Managing Categories
Creating a taxonomy, adding categories and sub-categories, changing a category's name, place, order and visibility, and deleting an empty category.
You manage categories on the Catalogue → Categories screen. Each taxonomy is a separate tab on the screen and has its own category tree. The Subject areas and Genres taxonomies come with the installation.
Adding a category
- At the top of the screen, select the tab of the taxonomy the category goes into.
- Press New category.
- Fill in the Name (Turkish) field.
- If you want, fill in the Name (English), Description (Turkish) and Description (English) fields.
- If the category goes under another category, select the parent from the Parent category list.
- Press Save.
To add a category directly under another one, select Add sub-category from that category's menu in the tree. The parent category field fills in by itself.
Category settings
When you select Edit from a category's menu in the tree, the same form opens.
| Field | Effect |
|---|---|
| Parent category | The category's place in the tree. Only categories of the same taxonomy can be selected. Moving it does not change the category's address |
| Slug (URL) | The last part of the category's address on the public site. If left empty, it is made from the Turkish name. If it changes, the old address redirects to the new one and menu links move to the new address |
| Order | The order of the categories under the same parent. A smaller number comes first |
| Active | When off, the category cannot be newly selected in the record form and does not appear on the public site. Existing links of records are kept |
| Visible on the public site | When off, the category does not appear on the public site and its category page does not open, but it can be selected in the record form |
A category cannot be moved under itself or under one of its sub-categories. Two categories cannot have the same slug. The old address of a category that was merged or whose slug changed keeps redirecting and is not given to another category. A new category with the same name therefore gets a number at the end of its slug.
Creating a taxonomy
- Press New taxonomy.
- In the Code field, type a short code with lower-case letters, digits, hyphens and underscores.
- Fill in the Name (Turkish) field and, if you want, the Name (English) field.
- In the Kind list, select Subject area (hierarchical) or Genre category.
- Press Create.
The code has 2 to 48 characters and cannot be the same in two taxonomies. The new taxonomy opens on its own tab. Taxonomies of the subject area kind come first among the tabs. In the panel, a taxonomy's name cannot be changed later and a taxonomy cannot be deleted.
Deleting an empty category
Only a category that is not linked to any record and has no sub-categories can be deleted. For all other categories the Delete item in the menu is disabled.
- In the tree, select Delete from the category's menu.
- Confirm the deletion in the window that opens.
A deleted category does not go to the trash and cannot be restored. Remove a category that is in use by merging it, as explained in Merging Categories. Every change to a category is written to the audit log.
How-to
Merging Categories
Merging a category in use into another category with a preview, and moving its publications and sub-categories there.
Instead of deleting a category that is in use, you merge it with another category. The category's publications and sub-categories move to the target category, its old address redirects to the target, and the category is deleted.
Steps
- On the Catalogue → Categories screen, select the tab of the category's taxonomy.
- In the tree, select Merge into another category from the menu of the category to remove.
- From the Target category list, select the category the publications will move to.
- Review the preview that the window prepares.
- Press Merge.
The notification says how many publications and how many sub-categories were moved.
The target list contains only categories of the same taxonomy. The merged category itself and its sub-categories cannot be the target.
Preview
When you select the target, the window prepares a preview without changing anything. The Merge button becomes active when the preview is ready. The preview shows:
- The number and the list of publications that will move to the target. Publications that are already in the target are marked separately.
- The sub-categories that will move.
- The redirects that will be created.
- The category that will be deleted.
The list shows at most 200 publications by name and gives the number of the rest.
Results of the merge
- The category's publication links move to the target. A publication that is already in the target is not linked a second time.
- The sub-categories move under the target.
- The category's Turkish and English public addresses redirect to the target category.
- Menu links to the category move to the target category.
- The category is deleted, and this cannot be undone.
- The merge is written to the audit log.
Screens and settings
Categories Screen
The parts of the Categories screen, with the taxonomy tabs, the category tree, row labels, the row menu and the category form.
The Catalogue → Categories screen shows subject areas, genres and other taxonomies as trees. The screen needs the category management permission.
Buttons and tabs at the top
- New taxonomy creates a new taxonomy.
- New category adds a new category to the selected taxonomy.
Each taxonomy is a tab, and the tab shows the number of categories. The toolbar below the tab shows the taxonomy's code. Expand all and Collapse all open or close all branches of the tree.
Tree rows
Each row shows the category's Turkish name, its English name if there is one, its slug and its order. The labels on the right of the row are these:
| Label | Meaning |
|---|---|
| Number of publications | Records linked to the category. Records in draft and in the trash are counted too |
| EN missing or TR missing | The category has no name in that language |
| Hidden | The category does not appear on the public site |
| Inactive | The category cannot be selected for new records and does not appear on the public site |
Row menu
- Add sub-category adds a new category under the category.
- Edit opens the category's form.
- Merge into another category merges the category into another category with a preview.
- Publications opens the publication list with the records linked directly to this category.
- Delete deletes an empty category. It is disabled if records or sub-categories are linked to the category.
Category form
The form has the Name (Turkish), Name (English), Description (Turkish), Description (English), Parent category, Slug (URL) and Order fields and the Active and Visible on the public site boxes. The Turkish name is required. The effect of each field is explained in Managing Categories.
Related topics
Troubleshooting
A category cannot be deleted
If the Delete item in a category's menu is disabled, or deleting stops with an in-use warning, remove the category by merging it or emptying it.
Only a category that is not linked to any record and has no sub-categories can be deleted. For all other categories the Delete item in the menu is disabled.
Records are linked to the category
If the number of records on the row is above zero, the category is in use. This number also includes records in draft and in the trash. The way to remove the category is to merge it with another category. The merge moves the records to the target category and deletes the category. The steps are in Merging Categories.
If you want to move the records to another category one by one, the Publications link in the menu lists the records linked to this category. Records in the trash do not appear in this list, but they still block the deletion.
The category has sub-categories
A category with sub-categories cannot be deleted. Move the sub-categories under another parent category with Edit, or merge the category. In a merge, the sub-categories move under the target.
A deleted category does not come back
Categories do not go to the trash, and a deleted category cannot be restored. Because only empty categories can be deleted, no record loses a link. The records of a merged category are in the target category.
Troubleshooting
A category cannot be selected in the record form
Why a category's box in the Categories section of a catalogue record is disabled, a category is missing from the list, or the list does not open at all.
The Categories section of a catalogue record shows the categories as boxes grouped by their taxonomy. If you cannot select a category, check the reasons below in order.
The category is inactive
The box of an inactive category is disabled for new selections. An inactive category that was linked to the record earlier stays ticked. To make the category selectable, open its form on the Catalogue → Categories screen, tick the Active box and save.
The category cannot be found in the list
Categories are listed in separate groups by their taxonomy. If the list is long, type the category's name in the Filter categories box at the top of the section. If the category does not exist at all, create it first as in Managing Categories.
The record is read-only
If you have no permission to edit the record, or the record was retracted or deleted, the form opens read-only and the boxes cannot be changed. The note at the top of the form gives the reason.
The category list does not open
If, instead of the boxes, a note says that the category management permission is needed, your account cannot read the category list. The record's existing category links are kept. Ask your system administrator for the permission.
The selected category does not appear on the public site
A category labelled Hidden in the list can be selected, but it does not appear on the public site. Tick the Visible on the public site box in the category's form.
Feature
Bulk Import
Creating many catalogue records at once from a CSV, XLSX or JSON file.
Bulk import brings the records of an old catalogue into the catalogue at once from a CSV, XLSX or JSON file. The work is done on the Catalogue → Bulk import screen.
The uploaded file is checked first, and the result of each row is shown in a dry-run report. No record is created at this step. When you confirm the report, the valid rows are created as draft records and the rows with errors are skipped. Publishing is a separate step.
A row uploaded again with the same source ID does not create a second record. The existing record is skipped or updated, as you choose. Rows that could not be imported can be retried once the problem has been fixed.
How-to
Importing Records in Bulk
Filling in the template, uploading the CSV, XLSX or JSON file, reviewing the dry-run report and importing the valid rows as draft records.
A bulk import has two steps. First you upload the file and get a dry-run report. No record is created in this step. When you review the report and confirm it, the valid rows enter the catalogue as draft records.
Preparing the file
- Open the Catalogue → Bulk import screen.
- Download the CSV, Excel (XLSX) or JSON template from the Templates section.
- Delete the two sample rows in the template.
- Write each record on one row.
The README sheet of the Excel template describes each column. The rules of the columns are in
Import Columns. Write each record's ID from the old system in the source_id column. This
ID prevents the same record from being created twice when you upload the file again later.
Upload and dry-run report
- In the Upload and dry-run section, type a short name of your old system in the Source system name field, for example old-catalogue.
- Drag the file onto the upload area or select it from your computer.
- Review the rows in the dry-run report that opens.
The report shows each row's problems and the action the import will take. The parts of the report are in
Dry-Run Report. The Source system name is stored as the origin of the records. The
system recognises an existing record when this name and the source_id value match together. Always upload files from
the same old system with the same name.
Correcting errors
- In the report, open the Invalid tab.
- Press Download the error report (CSV).
- Correct the errors in your file with the downloaded list.
- Upload the corrected file again with the same Source system name.
The error list contains the row number, the column, the problem, the source_id value and the title. Warnings are
also in the list, on separate rows. You can also leave the invalid rows and import the valid rows right away. Invalid
rows are skipped in the import and can be tried again later with
Retrying Failed Rows.
Importing the valid rows
- For the When a record with the same source ID exists option, select Skip (leave the existing record) or Update (write the data from the file).
- Press Import the valid rows.
- Confirm the import in the window that opens.
The valid rows are created as draft records and marked with the import ID. Invalid rows are skipped. A row that fails during the import does not affect the other rows. The notification counts the created, updated and failed rows. The import is written to the audit log, and a report can be imported only once.
After the import
The imported records are drafts. You send them for review and publish them from each record's own page or with Bulk Actions. The link in the report's Title column opens the created record. The Import line on the record's Record information card also links to the report that brought the record in.
How-to
Retrying Failed Rows
Importing the invalid or failed rows of a completed bulk import again with a new dry-run report after the problem has been fixed.
Rows that were invalid in an import or failed during the import can be tried again after the cause has been fixed in the catalogue. Use this option if, for example, you created the missing category or corrected the DOI of a conflicting record.
Steps
- On the Catalogue → Bulk import screen, open the imported report from the Earlier imports list.
- Press the Retry the failed rows button at the top of the report.
- Review the rows in the new dry-run report that opens.
- Choose an option for When a record with the same source ID exists.
- Press Import the valid rows.
- Confirm the import in the window that opens.
The number on the button shows the rows that will be tried again. The button appears only on an imported report, and only when rows that were not imported remain.
Retry behaviour
- Only the rows that were not imported are read again from the file you uploaded.
- The rows are checked again against the catalogue as it is today.
- The row numbers stay the same as in the file.
- No record is created until you confirm the new report.
- The first report links to its retries, and the new report links to the first report.
Errors in the file itself
A retry does not change the file. If the error is inside the file, for example a mistyped ISBN, the retry gives the same error. In that case, correct the file and upload it again as in Importing Records in Bulk. If the stored file can no longer be read, the retry stops and the warning "The import file is no longer available. Upload the corrected file again." appears.
Screens and settings
Import Columns
The columns of a bulk import file, which ones are required, how values are written and the rules that make a row invalid.
The first row of a bulk import file holds the column names. The file can contain only the columns below. An unknown
column causes the whole file to be rejected. Upper and lower case in column names make no difference. Spaces and hyphens
count as underscores, so a header "Title TR" is read as title_tr.
Columns
| Column | Required | Contents |
|---|---|---|
type |
Yes | Record type. book, chapter, journal, article, proceedings, thesis, children, or the Turkish kitap, bölüm, dergi, makale, bildiri, tez, çocuk |
source_id |
Recommended | The record's ID in the old system |
title_tr, title_en |
At least one | Turkish and English title, between 2 and 500 characters |
subtitle_tr, subtitle_en |
No | Subtitles |
abstract_tr, abstract_en |
No | Abstracts, at most 5000 characters |
keywords_tr, keywords_en |
No | Keywords, separated by semicolons |
language |
No | Language of the work (tr, en …). If empty, the language of the first title is used |
year |
No | Four-digit publication year, between 1500 and next year |
published_at |
No | Publication date |
contributors |
No | Contributors, in the format given below |
isbn |
No | ISBN-10 or ISBN-13. The check digit is verified |
doi |
No | A DOI starting with 10. or a https://doi.org/… link |
issn, eissn |
No | ISSN and e-ISSN. For journal rows they are written to the journal profile; on other rows they are not read |
categories |
No | The slugs of the categories, separated by semicolons |
publisher, rights_holder |
No | Publisher and rights holder |
access_status |
No | open, metadata_only, embargoed, restricted, or the Turkish açık, yalnız üstveri, ambargolu, kısıtlı. If empty, metadata only |
license |
No | The code of a licence active in the system, for example CC-BY-4.0 |
embargo_until |
If embargoed | The date the embargo ends |
details |
No | Type-specific fields, as a JSON object |
The file must have the type column and one of the title_tr or title_en columns. If one of these is missing, the
file is not read.
Writing the values
- Dates are written as YYYY-MM-DD. DD.MM.YYYY and DD/MM/YYYY are read too.
- In lists, values are separated by semicolons. If a value has no semicolon, a comma counts as the separator.
- Categories are written with their Slug (URL) value, not with the category name.
- Type-specific fields are given as a JSON object such as
{"edition": "1", "pages": 240}and are checked with the rules of the record form. - On thesis rows, the
levelvalue in the type-specific fields is written as its code (ms,phd,art,medical,other) or its Turkish or English name, for example{"level": "Medical specialty"}. A "tezi" or "thesis" at the end of the name makes no difference. - On rows that are not journals, the
issnandeissncolumns are not read. These numbers belong to the article's journal or to the book's series and are not stored on the record. A file that repeats the journal's ISSN on every article row is therefore imported without problems. - In a CSV file the separator can be a semicolon, a comma or a tab, and is taken from the first row. If the file is not UTF-8, it is read with the Turkish Windows encoding and the report notes this.
- In an XLSX file the sheet named
publicationsis read, or the first sheet if there is none. - A JSON file is a list of objects, or an object that holds such a list in its
rowsfield. Lists can also be written as JSON arrays.
Contributors
In the contributors column, contributors are separated by vertical bars. Each contributor is written as "Family name,
Given name". If the role is not author, put the role and a colon before the name. An ORCID iD goes after the name in
square brackets. For example:
Aksoy, Deniz | editor: Yalçın, Ece [0000-0002-1825-0097]
As the role, write author, editor, translator, illustrator, advisor or contributor. The Turkish equivalents
yazar, editör, çevirmen, resimleyen, danışman and katkıda bulunan are accepted too. A contributor without a role counts
as an author.
Cases that make a row invalid
A row is invalid and is not imported in these cases:
- A required value is missing or a value has the wrong format.
- A subtitle, abstract or keywords are given in a language that has no title.
- A category slug or licence code in the row does not exist in the system.
- The row is embargoed, but no embargo end date is given.
- The same ISBN, DOI or
source_idvalue also appears in an earlier row of the file. - The ISBN or DOI value is used in another record in the catalogue.
- The ISSN or e-ISSN value of a journal row also appears in an earlier row of the file or is used in another record in the catalogue.
- The existing record that matches the row is of another type.
Warnings
Warnings do not make a row invalid, but they are shown in the report:
- The row has no
source_idvalue. If this row is uploaded again, a second record is created. - The catalogue has another record with the same title, type and year.
- The row is open access but has no licence. This record cannot be published until a licence is selected.
Screens and settings
Bulk Import Screen
The upload area, the source system name, the template buttons and the list of earlier imports on the bulk import screen.
The Catalogue → Bulk import screen is where you upload the import file, download the templates and follow earlier imports. The screen needs the bulk import permission. The Bulk import button on the Publications screen also opens this screen.
Upload area
The Upload and dry-run section has the Source system name field and the upload area.
- Source system name is stored as the origin of the records. It can contain letters, digits, full stops, underscores, colons and hyphens. Turkish-specific letters cannot be used. If it is left empty, the name "import" is used.
- The upload area accepts CSV, XLSX and JSON files. The upload starts as soon as you select the file, and the dry-run report opens.
- If the upload stops halfway because of a connection problem, the Try again button in the area sends the file again without asking you to select it. This button does not appear for a file over the size limit.
An upload only produces a dry-run report and creates no record.
Templates
The CSV, Excel (XLSX) and JSON buttons in the Templates section download a template with the column
names and two sample rows. The README sheet of the Excel template and the columns field of the JSON template describe
each column.
Earlier imports
| Column | What it shows |
|---|---|
| File | File name, source system name and file format. Pressing the name opens the report |
| Status | Dry run done or Imported |
| Rows | The number of data rows in the file |
| Valid | Rows that were valid in the dry-run report |
| Errors | Rows that were invalid in the dry-run report |
| Date | The time the file was uploaded |
Related topics
Screens and settings
Dry-Run Report
The counts, notes, import and retry sections, row tabs and columns of the bulk import report.
The dry-run report checks every row of the file you uploaded and shows what will happen in the import. While the report is open, no record has been created. After the import, the same page shows the result of each row.
Page header
The header shows the file name, the status of the report, the source system name, the file format and the upload time. If there are invalid rows, the Download the error report (CSV) button downloads the list of errors as a CSV file in the language of the interface.
Counts
| Box | Meaning |
|---|---|
| Total rows | Data rows in the file |
| Valid | Rows without problems |
| Invalid | Invalid rows that will not be imported |
| To create | Rows that will create a new record |
| To update | Rows that match an existing record |
| With warnings | Rows with warnings |
The Notes box shows notes about reading the file. If the report is a retry, the note at the top links to the first report.
Import section
If the report has not been imported, the Import the valid rows section appears. Its When a record with the same source ID exists option offers two ways for matching records:
- Skip (leave the existing record) leaves the matching record as it is.
- Update (write the data from the file) writes the details from the file to the matching record.
The button says how many valid rows will be imported. If there are no valid rows, a warning and the Upload a corrected file link appear instead of the button.
On an imported report, this section is replaced by the import date and the result counts. If rows that were not imported remain, the Retry the failed rows section appears and links to the reports of earlier retries.
Row table
The All rows, Invalid and Valid tabs filter the rows and show their numbers.
| Column | What it shows |
|---|---|
| Row | The row's number in the file |
| Type | Record type |
| Title | Title and source_id. After the import it becomes a link to the record |
| Action | Before the import Create, Update, or Skip for an invalid row |
| Result | After the import Created, Updated, Skipped, Failed or Invalid |
| Problems | Which columns have errors, and the warnings. A row without problems shows No problems |
The column names and their rules are in Import Columns.
Related topics
Troubleshooting
An import file does not upload or cannot be read
Why a bulk import file does not upload, or an error appears instead of the dry-run report, and how to solve it.
If the file does not pass the checks, no dry-run report is created. The upload area gives the reason below the file's name. Follow the section below that matches this warning.
The upload stopped halfway
If the connection dropped or the server did not answer for a while, press Try again in the upload area. You do not need to select the file again. If the warning "Too many uploads right now. Try again a little later." appears, wait a little and try again as well.
The file is too large or its type is not accepted
An import file can be at most 20 MB. Split a larger file into several files. Only files with the .csv, .xlsx and .json extensions are accepted. Save an Excel file in the .xlsx format. An empty file is rejected too.
The file cannot be read
The warning "The file could not be read. Check its format (CSV, XLSX or JSON)." has these causes:
- The CSV file cannot be read as text or its format is broken. Save the file again as "CSV UTF-8".
- The XLSX file is broken or its content is too large.
- The JSON file is not valid JSON or does not hold the records as a list.
The format is taken from the file's extension. Every file other than XLSX and JSON is read as CSV.
Columns are unknown or missing
- The warning "The file has unknown columns." does not say which columns are unknown. Compare the header row with the template, then delete the extra columns or correct their names to match the template.
- The warning "The file lacks required columns." means that the file has no
typecolumn, or has neither of thetitle_trandtitle_encolumns.
The valid column names are in Import Columns.
There are no rows or too many rows
If there is no data row below the header row, the warning "The file has no data rows." appears. At most 5000 rows are imported from one file. Split a longer list into several files.
At most 100,000 rows of an XLSX worksheet are read, empty rows included. If the sheet is longer, a note in the report's Notes box says so. If there is data in the later rows, split the file.
The file did not pass the virus scan
No records are created from a file in which the virus scan found a problem. Produce the file again from a clean copy and upload it.
Uploads are switched off
The message "File uploads are switched off at the moment." in the upload area means that file uploads are switched off on the site. The system administrator switches uploads on again with the File uploads switch on the Site settings → Features tab.
The source system name is not valid
The Source system name field accepts only letters, digits, full stops, underscores, colons and hyphens. Remove Turkish-specific letters and spaces, then upload again.
Troubleshooting
An import created the same record twice
Why uploading a file again created new drafts instead of updating the existing records, and how to clean up the extra records.
A bulk import recognises an existing record only when the Source system name and the source_id value
match together. If no match is found, the row creates a new record. Check the reasons below.
The rows have no source_id
Each row without a source_id value creates a new record on every upload. The dry-run report shows the warning
"No source_id: importing this row again would create a second record." on these rows. Write each record's ID from the old system into the file, then upload it.
The source system name is different
If you uploaded the file with a different Source system name than the first time, the records do not match. Always upload files from the same old system with the same name. The name used in the first upload appears below the file name in the Earlier imports list.
The old record was deleted
Records in the trash are not taken into account for matching. A row uploaded again with the same source_id creates a
new record. If you want to use the old record, find it with the Show deleted filter in the
Publications list and restore it before the import.
The similar record warning was overlooked
If the catalogue has a record with the same title, type and year, the dry-run report marks the row with a warning. The warning does not stop the row. Before importing, look at the With warnings count and the warnings on the rows.
A row whose ISBN or DOI value is used in another record, on the other hand, is invalid and is not imported. On journal rows the ISSN and e-ISSN are checked the same way. Records with these identifiers are not created twice.
Cleaning up the extra records
The extra records are drafts. The link in the report's Title column opens each record. Delete the extra drafts as in Deleting a Catalogue Record.
Feature
File Library
Seeing all uploaded files, their virus scan status and the places where each file is used.
The Catalogue → File library screen lists the uploaded files, their virus scan status and the places where each file is used. Publication files, covers, images of institutional content, documents and the site logo appear here.
Every file goes through a virus scan, and nobody can open it before the scan has finished. The library shows only the files you have permission to see. The final files of a work in production do not appear in the library until the work is released and linked to its record.
A publication's files are added on the Files tab of its record. The file's access, embargo and licence are also set there. The steps are in Files and Access.
How-to
Uploading Files to the Library
Uploading a publication file, cover, institutional content or branding file to the file library, and the file types each upload purpose accepts.
The file library also accepts files that are not linked to a record. You add a publication's full text and cover on the record's own Files tab instead. The steps are in Files and Access.
- On the Catalogue → File library screen, press Upload file.
- Select the purpose of the file from the Upload purpose list.
- Drag the files onto the upload area or select them from your computer. You can select several files.
After the upload every file goes through a virus scan. Nobody can open the file before the scan finishes. The list refreshes by itself while the scan runs.
Files accepted for each purpose
| Purpose | Accepted file | Permission needed |
|---|---|---|
| Publication file | PDF, EPUB, DOCX, ODT, ZIP or an image | Catalogue edit |
| Cover image | JPG, PNG or WEBP, at most 10 MB | Catalogue edit |
| Institutional content | PDF or an image | Institutional content edit |
| Branding | JPG, PNG or WEBP, at most 10 MB | Institutional content edit or site settings |
The list shows only the purposes you have permission to upload for. The upload area shows the largest file size allowed. If the system administrator switched off the File uploads feature, files cannot be uploaded.
Using an uploaded file
A file that is not linked anywhere appears in the list as Not used. A document in the library can, for example, be made a journal's author template. Files linked to a record cannot be templates. The places where a file is used are described in File Library Screen.
Screens and settings
File Library Screen
The search box, filters and columns of the screen that lists uploaded files, the file details window and the places where a file is used.
The Catalogue → File library screen lists uploaded files with the newest upload at the top. Here you follow each file's scan status and the places where it is used.
Button at the top
Upload file opens the upload area. The steps are in Uploading Files to the Library.
Search and filters
| Filter | Options |
|---|---|
| Search box | File name or SHA-256 value |
| Purpose | Publication file, Cover image, Institutional content, Branding |
| Scan | Scanning, Available, Quarantined, Failed |
The purpose list contains only the purposes you have permission to see.
Columns
| Column | What it shows |
|---|---|
| File | File name, file type and size |
| Purpose | Upload purpose |
| Scan | Status of the virus scan |
| Used by | The first place where the file is used and the number of other places |
| Uploaded | Upload time |
The button at the end of the row downloads the file. If you have permission to open the place where the file is used, the place appears as a link.
File details
When you press a file's name, the File details window opens. The window shows the file's type, size, purpose, scan status and its detail, the scan time, whether its metadata was removed, the dimensions of images, the SHA-256 value, all places where it is used and the File id. Use in a deleted record or in an earlier version is marked separately.
Places of use
A file can be used in these places:
- Publication
- Issue cover
- Journal author template
- Institutional document
- Banner
- News / event cover
- Image in a news text
- Image in a page text
- Site logo
- Dark theme logo
- Default share image
- Tab icon
- Bulk import
Rules of the screen
- Publication files and covers need the permission to see unpublished catalogue records.
- Institutional content and branding files need the file library or the institutional content permission. The person who manages the site settings also sees branding files.
- The final files of a work in production do not appear in the list until the work is released and linked to its record. Open them from the production job.
- Submission and review files never appear on this screen.
Troubleshooting
A file stays in scanning or quarantine
What to do when an uploaded file does not leave the Scanning status or shows as Quarantined or Failed, and why this happens.
Every uploaded file goes through a virus scan and is not served to anyone before the scan finishes. The scan status appears in the file library and on the record's Files tab. For a banner image, a news cover image, the site logo and the article template, the field itself shows the status. If the file does not pass the scan, the field also says what to do.
The file stays in Scanning
The Scanning status shows that the scan is running. The page refreshes by itself, and when the scan finishes the status becomes Available.
If the virus scanner cannot be reached, the scan job is tried again for about an hour. If the scanner is not back by then, the scan is queued again by itself within 15 minutes. The file is scanned once the scanner works again. If the status still does not change for a long time after that, ask the system administrator to look at the background jobs on the System health screen. The details are in Monitoring System Health.
The file is Quarantined
A file with the Quarantined status did not pass the security scan and is not served anywhere. There are two reasons:
- The scan found malware in the file.
- The content of the file does not match its extension. For example, its name ends in .pdf but the file is not a PDF.
The Scan detail line in the file details window gives the reason. Upload a clean copy of the file again. A quarantined file cannot be added to a record.
The file shows Failed
A file with the Failed status could not be scanned and is not served anywhere. The scan is not tried again. There are two reasons:
- The file is larger than the virus scanner accepts. The Scan detail line says
too large for the virus scanner. - The file is missing from the file store. This happens when a database is restored without its files or when a file
is deleted from the store by hand. The Scan detail line says
object missing from the file store.
Upload a smaller copy of a file that is too large, or ask the system administrator to raise the scanner's size limit. Upload a missing file again. The fields of a banner image, a news cover image, the site logo and the article template tell these two cases apart too.
Feature
ISBN and Legal Deposit
Preparing an ISBN request, getting the publishing board's approval, recording the application to the Ministry and following the legal deposit.
ISBNs are issued by the Yayın Standartları ve Derleme Bilgi Sistemi (the publication standards and legal deposit information system) of the Ministry of Culture and Tourism. The person authorised for your institution in the Ministry's system applies there with their own e-Devlet (Türkiye's e-government gateway) login. JournTech never sends an application on your behalf. It collects the details of the application, has the publishing board approve them, and records the Ministry steps and the number that comes back.
Requests run on the Editorial → ISBN & legal deposit screen. The Production coordinator prepares the request and the Publishing board approves it. The Ministry's form is filled in by hand from the copy sheet on the request page, or with the browser extension your institution has installed.
Once the number has been assigned, the barcode for the cover and the copyright page are prepared. When the print date is entered, the 15-day legal deposit period starts and JournTech follows the legal deposit steps. Reminders go out for upcoming and overdue tasks. The whole process is described in ISBN Process.
How-to
Entering the Publisher Settings
Entering the publisher certificate, the Ministry officers, the printers, and the legal deposit and reminder settings for ISBN requests.
Before the first ISBN requests, a System administrator enters the details of the publisher once. The settings are on the Publisher and ISBN tab of the Administration → Site settings screen. All changes are saved with the Save button at the bottom of the page.
Publisher certificate
- On the Publisher certificate card, type the certificate number into the Certificate no. field.
- In Valid until, enter the expiry date of the certificate.
The certificate is issued by the General Directorate of Copyright (Telif Hakları Genel Müdürlüğü) and is renewed every four years. A request cannot be sent for approval without a certificate number or while the certificate has expired. The card shows for how many more days the certificate is valid.
Ministry officers
The Ministry officers list holds the JournTech accounts of the people who act for the institution in the system of the Ministry of Culture and Tourism.
- With Add person, find the person by name or e-mail address.
- Add the person to the list and save the settings.
When people are listed, only they record that the application was sent, that the Ministry returned it, and the ISBN that came back. Only they can start filling the form with the extension too. While the list is empty, everyone who handles ISBN requests records these steps.
A listed person must have the permission to handle ISBN requests, for example through the Production coordinator role. The list holds at most 20 people. Each officer must also have an approved record as an authorised person in the Ministry's system. If the JournTech account of an officer is closed, the system administrators get a reminder.
Printers
- On the Printers card, press Add printer.
- Fill in Printer’s name, Certificate no. and Place.
The first printer in the list is filled in on new requests for printed books. A request for a printed book cannot be sent for approval without the printer's certificate number. You can add at most 30 printers.
Legal deposit and reminders
While the One copy for the ISBN agency switch is on, the legal deposit (derleme) of a printed book also tracks one copy sent to Türkiye's ISBN agency. The Reminders card sets the reminder days, and lists of days are separated with commas. While Weekly digest is on, an e-mail with the number of upcoming and overdue tasks goes out on Mondays. All reminders are listed in ISBN Reminders.
ISBN range message
The ISBN range message section at the bottom of the tab shows the status of the range message of the International ISBN Agency, its file of ISBN ranges. The file is refreshed once a week. It decides whether a number belongs to Türkiye and where its hyphens go. If it has not been fetched yet, only Türkiye's prefixes are checked, and the copyright page and the barcode show the ISBN without hyphens.
If the file has not been refreshed for more than three weeks, the section shows a warning, and the system administrators get an operations alert every day. Meanwhile, numbers the file does not know are saved with a warning and shown without hyphens. Check that the server can reach www.isbn-international.org. Once the file is refreshed, the warning goes away.
Screens and settings
ISBN & Legal Deposit Screen
The status filters, search, columns, upcoming obligations card and yearly report card of the screen that lists ISBN requests.
The Editorial → ISBN & legal deposit screen tracks ISBN requests, the publishing board's approval, the steps at the Ministry of Culture and Tourism, printings and legal deposit (derleme) in one place.
Status filters
The buttons above the list filter the requests by status and show the number of requests in each status. You can select several statuses at once.
| Status | Meaning |
|---|---|
| Draft | The data for the Ministry form is being filled in |
| Awaiting approval | The request is waiting for the publishing board's approval |
| Ready to apply | The approved request is waiting to be entered in the Ministry's system |
| Sent to the Ministry | The application is made and the number is awaited |
| ISBN assigned | The number is entered and the book is not printed yet |
| Printed | The print date is entered and the legal deposit period is running |
| Deposit complete | The legal deposit steps of every printing are complete |
| Cancelled | The request was cancelled |
Search and filters
- The Search box searches titles, application numbers and ISBNs. For an ISBN, type at least 4 digits.
- The Form list filters requests by the forms Print, PDF, EPUB and Other.
- The Year of request field filters by the year in which the request was opened.
The filters stay in the address bar.
Columns
| Column | Shows |
|---|---|
| Title | The title. Set and volume requests are marked. |
| Form | Print, PDF, EPUB or other |
| Edition | The edition number |
| Status | The status of the request |
| ISBN | The assigned number |
| Planned date | The planned print or publication date |
| Updated | The time of the last change |
Side cards
The Upcoming and overdue obligations card lists approvals, Ministry steps, print dates, and bandrol (banderole) and legal deposit deadlines by due date. Overdue items are at the top, and each row opens its request. The Yearly report (Excel) card downloads the workbook for the selected year.
New request
The New ISBN request button is shown to the people who handle ISBN requests. The steps are in Preparing an ISBN Request.
How-to
Preparing an ISBN Request
Opening an ISBN request for a book in the catalogue or for a title only, filling in the data for the Ministry form and sending the request to the publishing board for approval.
The Production coordinator prepares the ISBN request. The request does not move on to the application at the Ministry of Culture and Tourism until the publishing board approves it.

Opening a request
- On the Editorial → ISBN & legal deposit screen, press New ISBN request. The Open an ISBN request button on the ISBN requests card of a catalogue record opens the same dialog.
- With A book in the catalogue, choose the book from the catalogue. For a book that has no catalogue record, select A title only and type the title.
- Under Form, select Print, PDF, EPUB or Other.
- Enter the edition number in Edition.
- For a multi-volume work, select Multi-volume (set) under Volumes.
- Press Open request.
Only book, children's book, proceedings and thesis records can be chosen from the catalogue. The title, authors, language and page count come from the catalogue record and can be edited in the request. A request opened with a title only is not linked to a catalogue record.
Data for the Ministry form
- On the request page, fill in the Data for the Ministry form card. Missing required fields are listed at the top of the card.
- Select the Author type, and add the people under Authors and contributors in the order of the Ministry form.
- For a printed book, complete Binding, Print run and the printer details.
- Press Save.
Sending for approval needs the following.
- The title and the language
- At least one author, unless the author type is No author
- The number of pages, for a printed or PDF book
- The planned print or publication date
- The printer's certificate number, for a printed book
The Note field stays in JournTech and is not part of the Ministry form.
Sending for approval
- Save the changes in the form.
- Press Send for approval and confirm.
The request becomes Awaiting approval and goes to the publishing board. While it awaits approval, the form cannot be edited. A request cannot be sent for approval until a valid publisher certificate is entered in Site settings. The approval steps are in Approving an ISBN Request.
Request rules
- Each form and each new edition gets its own ISBN. You cannot open a second request for the same form and edition of the same record.
- A change of binding also needs a new number.
- A reprint with unchanged content keeps the same number. Do not open a new request for it. Add a printing to the existing request as described in Tracking Legal Deposit.
- For a multi-volume work, you open a set request and add each volume with the Add volume button on the request page. The set and each volume get their own ISBN.
- To change a request that was sent for approval or approved, press Back to draft first. After editing, the request goes for approval again.
- A draft request is deleted with the Delete button. A request past the draft stage can only be cancelled.
Screens and settings
ISBN Request Page
The status line, warnings, action buttons and the form, copy sheet, printings, barcode, copyright page and history cards on the page of an ISBN request.
The header of the request page shows the title, the status, the form and edition, the assigned ISBN and the application number at the Ministry of Culture and Tourism. The line below the header gives the next step and who takes it. On a request linked to a catalogue record, the Catalogue record button opens the record.
Warnings
The warnings at the top of the page show these situations.
- The publishing board sent the request back, or the Ministry returned the application, with a reason.
- The request was cancelled.
- No publisher certificate is entered, or it has expired.
- No Ministry officers are listed.
- The ISBN range message has not been fetched yet.
- The ISBN range message has not been refreshed for more than three weeks and does not know the number of the request.
Action buttons
Which buttons appear depends on the status of the request and on your permissions.
| Button | Request status | Who uses it |
|---|---|---|
| Send for approval | Draft | Production coordinator |
| Approve, Send back | Awaiting approval | Publishing board |
| Back to draft | Awaiting approval, Ready to apply | Production coordinator |
| Sent to the Ministry, Fill with the extension | Ready to apply | Ministry officer |
| Enter the ISBN, Ministry returned it | Sent to the Ministry | Ministry officer |
| Add volume | Set request | Production coordinator |
| Cancel request | Before a print date is entered | Production coordinator |
| Delete | Draft | Production coordinator |
If a button you expect is missing, the reason is shown below the buttons. For example, if you prepared the request, it says that another member of the publishing board has to approve it.
Cards
| Card | What it shows |
|---|---|
| Data for the Ministry form | The data the Ministry form asks for. The card can be edited only while the request is a draft. |
| Copy sheet for the Ministry form | The fields of the Ministry form in the form's order, each with a copy button |
| Printings and legal deposit | The date, bandrol (banderole) and legal deposit steps of each printing. The card appears once the ISBN is assigned. |
| Barcode and copyright page | The EAN-13 barcode and the copyright page. The card appears once the ISBN is assigned. |
| History | Every action on the request, who took it and when |
| Request details | Who prepared the request, sent it for approval and approved it, the board decision, who sent it to the Ministry, the application number and who entered the ISBN |
| Volumes | The volumes of a set, or the set of a volume |
For an electronic publication, the printings card is called Publication and EYDeS. The order of the cards depends on the status of the request. For example, on a request that is ready to apply, the copy sheet moves above the form.
The whole process is described in ISBN Process.
How-to
Applying at the Ministry
Applying in the Ministry's system with your own e-Devlet login for an approved ISBN request, and recording the application in JournTech.
ISBNs are assigned by the Yayın Standartları ve Derleme Bilgi Sistemi (the publication standards and legal deposit information system) of the Ministry of Culture and Tourism. The Ministry offers no public service that other systems can connect to. The person authorised for your institution in the Ministry's system applies with their own e-Devlet login (Türkiye's e-government gateway). JournTech never sends an application on your behalf, and it never sees or asks for your e-Devlet password.
If Ministry officers are listed in the site settings, only the people on the list record these steps.
Applying
- Open the request while it is Ready to apply.
- Log in yourself with e-Devlet at ekygm.gov.tr.
- Fill in the ISBN application form with the help of the Copy sheet for the Ministry form on the request page. The copy button next to each field copies its value to the clipboard, and Copy all copies all fields at once.
- Check the Ministry form, then press the save or submit button on the Ministry page yourself.
The copy sheet lists the fields in the order of the Ministry form and marks the required ones. You can also fill in the form with the browser extension your institution installed. The steps are in Using the ISBN Helper Extension.
Recording it in JournTech
- On the request page, press Sent to the Ministry.
- In Application number, enter the number that the Ministry's system gave the application.
- Check the date of the application in Application date. The date cannot be in the future.
- Press Mark as sent.
The request becomes Sent to the Ministry. The Ministry usually assigns the number the same day. Record the number as described in Entering the ISBN.
If the Ministry returns the application
- On the request, press Ministry returned it.
- In The Ministry’s reason, enter the reason shown in the Ministry's system and confirm. The reason must be at least 5 characters long.
The request returns to draft with the reason. Once it is corrected, it goes to the publishing board for approval again.
If an approved request is not entered at the Ministry within 3 business days, the Ministry officers get a reminder.
How-to
Using the ISBN Helper Extension
Filling in the Ministry form with the JournTech ISBN helper browser extension, checking the fields and sending the application number back to JournTech.
JournTech ISBN yardımcısı (JournTech ISBN helper in an English browser) is a browser extension for Chrome and Edge. In your browser, it fills in the form of the Ministry of Culture and Tourism with the data of the approved request. It does not send the application. You always press the save or submit button on the Ministry page yourself.
Your institution's IT department installs the extension. If the extension is not installed, fill in the form with the copy sheet as described in Applying at the Ministry.
Filling in the form
- While the request is Ready to apply, press Fill with the extension on the request page. The Ministry's system opens in a new tab.
- Log in yourself with e-Devlet (Türkiye's e-government gateway).
- Open the ISBN application form and press Fill the form in the extension's panel.
- Check every field on the Ministry page. Complete by hand the fields that the extension could not find or found to be different.
- Select the authors yourself in the Ministry's Yazar Seç (Select author) dialog.
- Press the save or submit button on the Ministry page yourself.
If the extension's panel does not open, press the JournTech button at the bottom left of the Ministry page, or click the JournTech icon in the browser toolbar. If the Ministry page is not recognised, the link in the extension's panel opens the copy sheet in JournTech.
Sending the application number back
If the Ministry page shows the application number after you save, the extension writes the number into the field in its panel.
- Check the number.
- To count the request as sent, tick Mark the application as submitted.
- Press Send to JournTech.
In JournTech the request becomes Sent to the Ministry. If the transfer does not work, mark the status by hand in JournTech with the Sent to the Ministry button.
Ticket and session
Fill with the extension gives the extension a single-use ticket that is valid for 10 minutes. The ticket is bound to your panel session. Do not sign out of JournTech until you are done at the Ministry. Sending the application number back works within two hours and while you are signed in to JournTech. If the time runs out, press Fill with the extension again.
If the extension does not respond, see The extension does not respond in this browser.
How-to
Entering the ISBN
Entering the ISBN that the Ministry assigned on the request, understanding the number checks, and how the number is written to the catalogue record.
When the Ministry of Culture and Tourism assigns the number, the Ministry officer enters it on the request. At this point the request must be Sent to the Ministry.
- On the request page, press Enter the ISBN.
- In ISBN-13, type the number as the Ministry's screen shows it. You can use hyphens and spaces.
- Check the results in the Number check section.
- Press Save the ISBN.
Number check
Before saving the number, JournTech checks the following.
- The number has 13 digits and its check digit matches. If you enter an ISBN-10, its 13-digit form is saved.
- The number is in one of Türkiye's ISBN groups. These groups are 978-605, 978-625, 978-975 and 978-9944.
- The number is not used on another request or another catalogue record.
If the range message of the International ISBN Agency has been fetched, the group and the registrant range of the number are checked against it. If it has not been fetched yet, only Türkiye's prefixes are checked, and the dialog says so.
If the range message has not been refreshed for more than three weeks, it lacks the groups and registrant ranges opened since it was last fetched. A number it does not know is then not refused. The number is saved with a warning, and the copyright page and the barcode show it without hyphens until the message is refreshed. When you see the warning, compare the number with the one on the Ministry's screen. A number whose check digit does not match, or that belongs to another country's group, is still refused.
After saving
The request becomes ISBN assigned, and the number is written to the identifiers of the catalogue record. On a request opened with a title only, the number stays on the request. The book's first printing is also added to the request automatically. From now on, the barcode and the copyright page (künye) are ready.
If the number is recorded on another request or record, the dialog shows a link that opens it. If no number is entered within 1 business day of sending the request to the Ministry, the Ministry officers get a reminder.
How-to
Downloading the Barcode and Copyright Page
Downloading the cover barcode of a book with an ISBN as SVG or PDF, and copying the text of the copyright page or getting it as a PDF.
Once a request has its ISBN, the Barcode and copyright page card prepares the EAN-13 barcode for the cover and the book's copyright page (künye).
Barcode
- On the request's Barcode and copyright page card, press Download SVG or Download PDF.
- Give the file to the cover designer.
The barcode is at its nominal size and takes up about 37 × 32 mm. Do not shrink it.
Copyright page
- Check the text in the Copyright page section of the card.
- Copy the text with Copy the copyright page, or download the copyright page as a PDF with the Download PDF button next to it.
The copyright page contains the following.
- The title and subtitle, the authors and the contributors
- The publisher's name and publisher certificate number
- The date and number of the publishing board's decision
- The ISBN and the numbers of the other forms of the same edition
- The edition and printing details, the printer and the printer's certificate number
- The place and year of publication
- The licence statement for an openly licensed book, and the copyright line for other books
The publisher's details come from Site settings, and the edition, printing and printer details from the request.
Hyphenation
The hyphens in the number are placed according to the range message of the International ISBN Agency. If the range message has not been fetched yet, the barcode and the copyright page show the 13 digits of the number without hyphens, and the card says so in a warning. The same happens when the message has not been refreshed for more than three weeks and does not know the number. This way a number split in the wrong places is never printed. Before sending the book to print, wait for the range message to be fetched or refreshed, or set the hyphens by hand as the screen of the Ministry of Culture and Tourism shows them.
How-to
Changing the Print Date and Cancelling an ISBN
How the print date reported to the Ministry affects the legal deposit period, what to do when printing is postponed, and cancelling an ISBN that will not be used.
If the print date reported to the Ministry of Culture and Tourism is not changed, the book counts as printed on that date and the legal deposit (derleme) obligation begins. JournTech sends reminders 14 and 3 days before the planned print date. If the date passes and no print date is entered, it sends another reminder the next day and counts the legal deposit period from the planned date.
If printing is postponed
- Update the date in the Ministry's system.
- In JournTech, change the printing's Planned print date to the new date on the request's Printings and legal deposit card.
- Press Save printing.
The reminders follow the new date.
Cancelling the number
The number of a book that will not be published is cancelled.
- On the request page, press Cancel request.
- In Reason for cancelling, enter a reason of at least 5 characters and confirm.
- Have the number cancelled in the Ministry's system too.
The number is removed from the catalogue record and the request is closed. The cancellation cannot be undone. The Ministry may give the cancelled number to the publisher's next book.
The number of a book that was printed or has been made public cannot be cancelled. Nor can the number of a book that has been promoted on sales sites or catalogued in a library.
A request that has no number yet is cancelled with the same button. If you cancel a request that was sent to the Ministry, withdraw the application in the Ministry's system too.
How-to
Tracking Legal Deposit
Entering the print date, recording the bandrol, deposit copies, EYDeS, ISBN agency copy and reprint steps, and uploading the receipts.
Once the ISBN is assigned, the request's Printings and legal deposit card tracks the legal deposit (derleme) steps of each printing. Entering the print date starts the 15-day legal deposit period (Law No. 6279 on legal deposit). The card shows the deadline for each step.
Print date
- On the printing's card, enter the day the book was printed in Print date.
- Press Save printing.
The request becomes Printed, and the card shows the legal deposit deadline. The print date cannot be in the future.
Bandrol
Printed books are distributed with a bandrol, the banderole sticker that the Ministry of Culture and Tourism issues for each copy. The bandrol goes on the copies after printing and before shipment, and the Ministry issues bandrols within 10 business days.
- With Required selected, fill in Bandrol application date and Bandrols received on.
- If free distribution was declared in the bandrol application, select Free distribution declared.
- For the exceptions listed in the regulation, select Exempt.
Deposit copies
Six copies with bandrols are delivered to the Istanbul Legal Deposit Office (İstanbul Derleme Müdürlüğü) in Istanbul, and to the provincial public library (il halk kütüphanesi) in other provinces.
- Enter the date you sent them in Copies sent on.
- Under Delivered to, select İstanbul Derleme Müdürlüğü or Provincial public library. If you selected the provincial public library, fill in Name of the library.
- Upload the receipt in Deposit office receipt.
If you upload a new document, it replaces the old one, and the old document is deleted.
Electronic copy and other steps
- The electronic copy of a printed book is also uploaded within 15 days to EYDeS, the electronic legal deposit system of the National Library (Milli Kütüphane), without a password or copy protection. Enter the upload date in Uploaded to EYDeS on and upload the EYDeS confirmation document.
- EYDeS does not use e-Devlet (Türkiye's e-government gateway). You log in with the e-mail address and password of your EYDeS account. EYDeS has no bulk upload.
- In Copy sent to the ISBN agency on, enter the date of the copy sent to the ISBN agency. This step can be switched off in Site settings.
- For a reprint, enter the date of the "Basım sonrası işlemler" (post-print procedures) record in the Ministry's system in Post-print record in the Ministry’s system on.
For e-books, legal deposit is through EYDeS only. For an electronic publication, the card is called Publication and EYDeS, and you enter the Publication date instead of a print date. An electronic publication takes no deposit office receipt, only the EYDeS document.
When every step is ticked, the printing is complete and the request becomes Deposit complete. The fine for missing legal deposit is charged for each copy, and its amount is revalued every year. The amount announced for 2026 is 11,500 TL. Paying the fine does not remove the legal deposit obligation.
Reprints
A reprint with unchanged content keeps the same ISBN and has its own legal deposit.
- Press Add printing at the top of the card.
- Enter the planned print date and the print run.
- Press Add printing in the dialog.
Before you add a reprint, the print date of the previous printing must be entered. A reprint added by mistake is removed with Remove printing, as long as no print date has been entered for it. For a new edition with changed content, open a new ISBN request.
How-to
Downloading the Yearly ISBN Report
Downloading the ISBN requests, numbers, Ministry dates and the legal deposit steps of each printing for a chosen year as an Excel workbook.
The yearly report gives the ISBN requests and legal deposit (derleme) steps of a year in one Excel workbook.
- On the Yearly report (Excel) card at the side of the Editorial → ISBN & legal deposit screen, select the year in the Year list.
- Press the download button of the card. The label of the button includes the year you selected.
The report contains the requests that were not cancelled. A request is in the report when it was opened or given a number in the selected year, or when one of its printings was printed in that year. Each printing is a separate row and appears in the report of the year it was printed. A reprint of a book whose request was opened in an earlier year is therefore in the report of the year of the reprint. A printing without a print date appears in the report of the year the request was opened or given its number. A request with no printing in the year is a single row, with the printing columns empty. The columns are as follows.
| Column | Content |
|---|---|
| ISBN, Eser adı, Biçim, Baskı, Durum | The details of the request (title, form, edition, status) |
| Başvuru no, Başvuru tarihi, ISBN tarihi | The steps at the Ministry of Culture and Tourism (application number, application date, ISBN date) |
| Basım no, Basım tarihi, Bandrol | The details of the printing (printing number, print date, bandrol) |
| Derleme gönderildi, EYDeS, Ajans nüshası, Derleme tamam | The dates of the legal deposit steps (copies sent, EYDeS, agency copy, deposit complete) |
Cells whose value starts with =, +, - or @ are written as text and do not work as formulas in Excel.
Concept
ISBN Process
The statuses an ISBN request goes through from draft to legal deposit, who takes each step, and the part JournTech plays in the Ministry application.
ISBNs are assigned by the Yayın Standartları ve Derleme Bilgi Sistemi (the publication standards and legal deposit information system, ekygm.gov.tr) of the Ministry of Culture and Tourism. The Ministry offers no public service that other systems can connect to. So the person authorised for your institution in the Ministry's system applies with their own e-Devlet login (Türkiye's e-government gateway). JournTech collects the data for the application and has the request approved. It records the Ministry steps and the number that comes back, tracks the printing and the legal deposit (derleme), and sends reminders before deadlines pass. JournTech never sends an application on your behalf.
The path of a request
| Status | What happens | Who does it |
|---|---|---|
| Draft | The data for the Ministry form is filled in. | Production coordinator |
| Awaiting approval | The request goes to the publishing board. | The Publishing board approves it or sends it back with a reason. |
| Ready to apply | The approved request is entered in the Ministry's system. | Ministry officer |
| Sent to the Ministry | The application number is recorded. The Ministry usually assigns the number the same day. | Ministry officer |
| ISBN assigned | The number is checked and written to the catalogue record. The barcode and the copyright page are ready. | Ministry officer |
| Printed | Entering the print date starts the 15-day legal deposit period. | Production coordinator |
| Deposit complete | All legal deposit steps are ticked. | Production coordinator |
| Cancelled | The request, or a number that will not be used, is cancelled. | Production coordinator |
If the publishing board sends the request back or the Ministry returns the application, the request returns to draft with the reason and goes for approval again. When the print date of a reprint with the same ISBN is entered, the request becomes Printed again, and it is complete again once the legal deposit of that printing is done.
Ministry officer
A Ministry officer is a person who acts for the institution in the Ministry's system. If officers are listed in the site settings, only they record the Ministry steps. If the list is empty, the Production coordinator who handles ISBN requests records these steps too. The list is described in Entering the Publisher Settings.
Approval and the four-eyes principle
The Ministry application is made in the institution's name, and the number it brings is written to the catalogue record. That is why the person who prepared a request does not approve it, and another member of the publishing board gives the approval. The rule is described in Four-Eyes Principle.
Legal deposit
Within 15 days of printing, six copies of a printed book with bandrols (the banderole stickers issued by the Ministry) are delivered to the deposit office, and its electronic copy is uploaded to EYDeS, the electronic legal deposit system. For e-books, legal deposit is through EYDeS only. The steps are in Tracking Legal Deposit.
Screens and settings
ISBN Reminders
Which events in the ISBN and legal deposit process send a reminder, when and to whom, and where the reminder days are changed.
The Upcoming and overdue obligations list on the ISBN & legal deposit screen shows all open tasks by deadline. Reminders go out for the same tasks, as panel notifications and e-mails. The e-mails do not contain the title of the book, only the date and a link.
Default reminders
| Event | When | To whom |
|---|---|---|
| The publisher certificate is about to expire | 90, 30 and 7 days before, then weekly once it has expired | System administrators and production coordinators |
| A Ministry officer's account was closed | Monthly | System administrators |
| A request is awaiting approval | After 3 business days | Publishing board |
| An approved request was not entered at the Ministry | After 3 business days | Ministry officers |
| Sent to the Ministry, no number entered | After 1 business day | Ministry officers |
| The print date is approaching | 14 and 3 days before | The preparer and the Ministry officers |
| The print date has passed and no printing is entered | The next day | The preparer and the Ministry officers |
| No bandrol (banderole) application yet | 21 days before printing | The preparer |
| Legal deposit steps are missing | 10 and 14 days after printing | The preparer |
| The legal deposit period has passed | Weekly from day 16 | The preparer and the publishing board |
| Weekly digest | Monday | Production coordinators and Ministry officers |
Business days are counted from Monday to Friday. Public holidays are not left out: a holiday on a weekday counts as a business day. If no Ministry officers are listed, the reminders meant for the officers go to the production coordinators. The weekly digest goes out only when something is upcoming or overdue. If the e-mail of an e-mail template is switched off, only the panel notification goes out.
Changing the days
A System administrator changes the days on the Reminders card of the Site settings → Publisher and ISBN tab. For the reminders counted in business days and for the bandrol reminder, 0 switches the reminder off. The 15-day legal deposit period set by law does not change. The settings are described in Entering the Publisher Settings.
Troubleshooting
An ISBN request cannot be sent for approval
Missing fields, unsaved changes and the publisher certificate when the Send for approval button is disabled or sending a request for approval gives an error.
A request goes for approval only while it is a draft, its form is saved, and the required fields of the form of the Ministry of Culture and Tourism are filled in. Check the causes below in order.
There are unsaved changes
While the form has unsaved changes, the Send for approval button is disabled, and a note below it says that you need to save them. Press Save.
A required field is missing
The top of the Data for the Ministry form card lists the missing fields. The title, the language and the planned date are required on every request. The number of pages is required for printed and PDF books, and the printer's certificate number for printed books. Unless the author type is No author, at least one author is needed.
The publisher certificate is missing or has expired
If the warning at the top of the request says that no publisher certificate is entered or that it has expired, a System administrator enters the certificate on the Site settings → Publisher and ISBN tab. The steps are in Entering the Publisher Settings.
The request is not a draft
A request that was sent for approval or approved cannot be sent again. If something has to change, press Back to draft.
You do not have the permission
The person who handles ISBN requests sends them for approval. The Production coordinator and System administrator roles have this permission.
Troubleshooting
The buttons for the Ministry steps are missing
The Ministry officer list and the request's status when the Sent to the Ministry, Fill with the extension, Enter the ISBN or Ministry returned it buttons are missing.
The buttons for the steps at the Ministry of Culture and Tourism depend on the request's status and on the list of Ministry officers. Check the causes below in order.
You are not a Ministry officer
If Ministry officers are listed in the site settings, only the people on the list record these steps. A note below the buttons says so. If you should be on the list, a System administrator adds you to the Ministry officers list on the Publisher and ISBN tab. The steps are in Entering the Publisher Settings.
The request is not in the right status
Sent to the Ministry and Fill with the extension appear only on a request that is Ready to apply. Enter the ISBN and Ministry returned it appear only on a request that is Sent to the Ministry. If the request is not approved yet, wait for the publishing board's approval.
You do not have the permission
The Ministry steps need the permission to handle ISBN requests. The Production coordinator and System administrator roles have it. A Catalogue editor and a Unit manager can only view requests.
Troubleshooting
The extension does not respond in this browser
What to do when the JournTech ISBN helper does not respond after Fill with the extension, or says that it could not fill in the form.
After you press Fill with the extension, the panel waits for the extension to answer. If the extension does not answer or cannot fill in the form, the panel says so in a note. In every case you can fill in the form by hand with the Copy sheet for the Ministry form on the request page.
The extension is not installed
If the note in the panel says that the extension did not answer in this browser, the extension is not installed, is
switched off, or is not allowed on this address. Your institution's IT department installs the extension, and the
installation guide is the extension/README.md file in the repository.
The extension did not answer in time
If the extension is installed but no answer came within 30 seconds, the network may be slow. If the tab of the Ministry of Culture and Tourism opened, carry on there. If it did not open, try again.
The extension could not fill in the form
The note in the panel gives the reason the extension reported. The JournTech address may be missing from the extension's settings, or another address may be set there. Enter the address on the extension's Options page. If the ticket has expired or was already used, press Fill with the extension again.
The request is not ready to apply
The extension works only on a request that is Ready to apply. If the request was taken back to draft or marked as sent to the Ministry in the meantime, the fill ticket becomes invalid.
The side panel did not open
Press the JournTech button at the bottom left of the Ministry page, or click the JournTech icon in the browser toolbar. How to use the extension is described in Using the ISBN Helper Extension.
Troubleshooting
The ISBN from the Ministry is not accepted
Causes and fixes when entering the ISBN warns that the number is not valid, does not belong to Türkiye or is used on another record.
The Enter the ISBN dialog checks the number before saving it and shows any problem in the dialog. Check the causes below.
The check digit does not match
The number may have been mistyped. Check the number again on the screen of the Ministry of Culture and Tourism. Use digits, hyphens and spaces only.
The number is not in one of Türkiye's groups
ISBNs assigned in Türkiye start with 978-605, 978-625, 978-975 or 978-9944. Once the range message (the International ISBN Agency's file of ISBN ranges) has been fetched, the registrant range of the number is checked too. The dialog says which group the number belongs to. Enter the number again exactly as the Ministry's screen shows it.
If the range message has not been refreshed for more than three weeks, a number it does not know is not refused. The number is saved with a warning. The details are in Entering the ISBN.
The number is recorded elsewhere
If the number is recorded on another request or another catalogue record, the dialog shows a link that opens that request or record. If the number was entered on the wrong record, correct that record first.
The button is missing
If the Enter the ISBN button is missing, see The buttons for the Ministry steps are missing.
Feature
Institutional Content
Managing institutional pages, policies, guides, news, events, menus, banners and documents.
The institutional content of the public site is managed in the Institutional content section. Institutional pages, versioned policies and guides are written on the Pages & policies screen. News, announcements, events and calls are on the News & events screen. The Menus screen edits the top menu and the footer links, and the Banners screen edits the showcase of the home page. PDF documents such as regulations and reports are published on the Institutional documents screen. On the Help notes screen you add notes specific to your institution below help topics. The steps are in Managing Help Notes.
The Turkish and English texts are written on the language tabs of the same item. Content without an English text appears in Turkish on the English site. Pages are saved as drafts, published at once or scheduled for a later date. Every published version of a page is kept, and you can go back to an older version.
If review approval is on in your installation, the person who sent content to review cannot publish it themselves. The steps are in Publishing with Review Approval, and the reason for the rule is in Four-Eyes Principle.
Screens and settings
Pages & Policies
The tabs, filters, columns and row actions of the screen that lists institutional pages, versioned policies and guides.
The Institutional content → Pages & policies screen lists institutional pages, policies and guides. Content such as About us, the boards, the ethics policy and the author guide is created here.

On the public site, pages are published at /sayfa/…, policies at /politikalar/… and guides at /rehberler/…. On
the English site, the addresses are /en/page/…, /en/policies/… and /en/guides/….
Tabs and filters
The All, Pages, Policies and Guides tabs above the list group the content by type. Below the tabs are these filters.
- The Search box searches titles and addresses.
- The Status list filters content by the statuses Draft, In review, Published, Unpublished and Archived.
- The Deleted box shows deleted content.
The filters stay in the address bar. If you share the link, the same list opens.
Columns
| Column | Shows |
|---|---|
| Title | The title and the public address. The missing-translation, unpublished-changes and scheduled-publication badges also appear here. |
| Type | Page, policy or guide |
| Status | The content's status |
| Version | For a policy the version label and effective date, for other types the number of the live version |
| Updated | The time of the last change |
The Unpublished changes badge shows that a published page has a saved change that is not published yet.
Row actions
The Actions menu at the end of the row holds Edit, View on the site for published content, and Delete. Published content cannot be deleted. Unpublish it first. Deleting needs a reason of at least 5 characters. You restore deleted content with Restore in the Deleted view.
New content
The New page menu opens the editor for an Institutional page, a Policy (versioned) or a Guide. The steps are in Creating a Page, and the parts of the editor in Page Editing Screen.
How-to
Creating a Page
Creating an institutional page, a versioned policy or a guide, writing the Turkish and English text, and saving the content.
Institutional pages, policies and guides are written in the same editor. Content you save does not show on the public site until you publish it.
Choosing the type
- On the Institutional content → Pages & policies screen, press New page.
- Select Institutional page, Policy (versioned) or Guide.
You can change the type later in the Page type list on the Page settings card. Once content has been published, its type cannot change.
Text
- On the Content card, check that the Türkçe (Turkish) tab is open.
- Fill in Title. The Turkish title is required and must be at least 2 characters long.
- Optionally enter a Short summary. The summary shows in lists and search results and can be up to 2000 characters long.
- Write the text in Text. The toolbar has buttons for headings, bold, italics, links, lists and quotes.
- To show a different title or description in search engines, open the Search engines section. Fill in SEO title and SEO description. If you leave them empty, the page title and the summary are used.
Page settings
- Address (slug) is the address of the page on the public site. Use lower-case letters, digits and hyphens. If you leave it empty, the address is generated from the title.
- A policy also has the Version label (for example v2.0) and Effective date fields. A policy cannot be published without them. The details are in Policy Versions.
On the public site, pages are published at /sayfa/…, policies at /politikalar/… and guides at /rehberler/…
(/en/page/…, /en/policies/… and /en/guides/… on the English site). The text of the For authors page is the
guide whose address is yazarlar-icin.
English text
The English tab holds the English text of the content. If the English title is empty, Translation missing shows next to the tab's name, and the public site shows the Turkish content on the English page.
- Go to the English tab.
- To start from the Turkish text, press Copy from Turkish.
- Write the title and the text in English. If any field in this language is filled in, the title is required too.
You remove a translation you do not need with Remove this language. When you save, the title and the text in that language are deleted.
Saving
Press Save. The Ctrl+S shortcut saves too. On the first save, the content is created as a draft and the editing screen opens.
Every save adds a new version to the Version history card. Missing or invalid fields are listed by name in the notice at the bottom right. If you leave the screen without saving, the panel warns you.
To publish the content, follow the steps in Publishing and Scheduling.
Screens and settings
Page Editing Screen
The Content, Publication, Page settings and Version history cards of the page, policy and guide editor, and the rules of the screen.
The page editor opens when you create content or press an item in the list. Next to the title you see the content's type, its status, its public address and whether the changes are saved.
Top buttons
- View on the site opens the published page in a new tab.
- Save saves the changes.
- Publish publishes the content. On a published page the button reads Publish changes. The button appears only when there is something to publish and the publishing rules allow it.
Content card
The Content card holds the Türkçe (Turkish) and English tabs, Title, Short summary, Text and the Search engines section. On the English tab, Copy from Turkish appears when there is no content, and Remove this language when there is. If one language leaves empty the fields that the other language has filled in, a note at the top of the card lists them.
Publication card
The Publication card appears after the content is saved for the first time. It shows the live version and its publication date, unpublished changes, a scheduled publication and the review note. Its buttons depend on the content's status.
| Button | What it does |
|---|---|
| Publish | Publishes the content, or the changes to a published page |
| Send for review | Sends the draft to review. With review approval on, it shows as Send the changes to review on a published page. |
| Schedule | Publishes the last saved state at the time you choose |
| Cancel schedule | Removes the schedule |
| More actions | Opens Return to draft, Unpublish, Archive and Delete page |
If you do not have the publish permission, the card says so and tells you to send the content to review.
Page settings card
The Page settings card holds the Page type and Address (slug) fields. For a policy, the Version label and Effective date fields appear too.
Version history card
The Version history card lists every save and every publication as a version. The last six versions are shown, and Show more opens the rest. Versions carry these badges.
| Badge | Meaning |
|---|---|
| Live | The version shown on the site |
| Published | A version that was published before |
| Saved | An unpublished save |
The View and Restore buttons on a row open the version or copy it into the working copy. The details are in Viewing and Restoring Page Versions.
Rules of the screen
- The Turkish title is required and must be at least 2 characters long.
- Archived and deleted content opens read-only.
- While there are unsaved changes, the Restore buttons on the Version history card are disabled.
- While a status action such as publishing or a restore runs, the Save button is disabled. What you type while a save or an action runs is not lost. It stays on the screen afterwards, waiting to be saved.
- The type of content that has been published once cannot change.
- When the address of a published page changes, the old address redirects to the new one.
- Menu links to content whose address changes move to the new address by themselves.
- If someone else saved the same content while you were editing it, your save is refused and the panel tells you.
The steps are in Creating a Page and Publishing and Scheduling.
How-to
Publishing and Scheduling
Publishing an institutional page, policy or guide at once, putting the changes to a published page online, and scheduling a publication for a later time.
You publish a page from the Publication card on the right of the editor. Published content is stored as a version that cannot be changed.
If review approval is on in your installation, content is published only after review. In that case, follow the steps in Publishing with Review Approval.
Publishing at once
- Open the content on the Institutional content → Pages & policies screen.
- Press Publish. Your unsaved changes are saved first.
- Confirm the dialog.
For a policy, the dialog shows the label and the effective date of the version to be published.
Changing a published page
When you edit and save a published page, the site keeps the old content. The card says that there are unpublished changes.
- Make the change and press Save.
- To put the change online, press Publish changes.
Scheduling
- Press Schedule.
- In Publication time, enter a future time in Istanbul time.
- Press Schedule in the dialog.
The last saved state of the page is published automatically at that time. Changes you save after scheduling are included too. The card shows the publication time. If you change your mind, press the Cancel schedule link on the card.
The system checks scheduled publications once a minute. If the page does not meet the publishing conditions when the time comes, the schedule is removed and this is written to the audit log.
Publishing conditions
- The content must have a title.
- A policy must have a version label and an effective date. The label must not have been published before.
- Archived content cannot be published.
- If a published page has no saved change, there is nothing to publish.
To remove a page from the site, see Unpublishing and Deleting.
How-to
Publishing with Review Approval
Sending institutional content to review, reviewing it, and publishing it or sending it back for corrections in an installation with review approval switched on.
If the system administrator has switched on Institutional content is published after review on the Site settings → Workflow tab, institutional content is published only after review. The person who sends content to review cannot publish it themselves. Another editor with the publish permission publishes it.
The rule covers pages, policies, guides, news, announcements, events, calls and institutional documents. Banners and menus are outside the rule. A journal's own announcements and calls stay with the journal's editors and are not subject to this rule.
Sending content to review
- Write the content and save it.
- Press Send for review on the Publication card of a page or the Publication card of a news item. For an institutional document, the button is in the row's Actions menu.
For saved changes to a published page, the button reads Send the changes to review. While the review is under way, the site keeps the old content. The card says that you sent the content to review and that another editor will publish it.
Reviewing and publishing
The reviewing editor opens the content and takes one of two paths.
- If the content is fine, they press Publish. On a published page the button reads Publish changes. Instead of publishing the page at once, the editor can also schedule it.
- If corrections are needed, they send the content back. On a page this is Return to draft in the More actions menu, and on a published page the same action reads Send the changes back. On a news item and an institutional document, the action is Send back to draft.
For pages and news items, a reason for sending back is optional. For an institutional document, a reason of at least 5 characters is required. Content that is sent back returns to draft. Its author corrects it and sends it to review again.
Published news, events and documents
News items, events and documents have no separate working copy. An edit to a published news item, event or document shows on the site as soon as it is saved. To put a large change through review first, unpublish the content and send it to review.
When the setting is off
The setting is off by default. While it is off, everyone with the publish permission publishes directly. On pages, Send for review stays available as an optional intermediate step.
The reasoning behind the rule is in Four-Eyes Principle.
How-to
Viewing and Restoring Page Versions
Viewing an earlier version of a page, restoring it into the working copy and publishing the restored content again.
Every save and every publication of a page is added to the Version history card as a version. You can view an earlier version or restore it into the working copy.
Viewing a version
- Open the page and scroll down to the Version history card.
- Press View on the version's row.
A dialog shows the version's title, summary and text, with a tab for each language.
Restoring a version
- If the page has unsaved changes, press Save first.
- Press Restore on the version's row.
- Confirm the dialog.
- Check the restored title and text.
- Publish the page to show it on the site.
Restoring creates a new version, and the earlier versions are not deleted. The restored content does not show on the site until you publish it. The publishing steps are in Publishing and Scheduling.
Restoring puts the version's content in place of the working copy. So while there are unsaved changes, the Restore buttons are disabled and the Version history card says what to do. Saving the page does not change the page on the site.
Restoring a policy version
A restored policy version comes back with its own label and effective date. If that label was published before, enter a new label in Version label before publishing. A label that was published before cannot be used again.
You cannot restore a version on an archived page.
How-to
Unpublishing and Deleting
Removing an institutional page, news item or document from the site, archiving it, deleting it and restoring deleted content.
You remove published content from the site in one of three ways. Unpublished content can still be edited, archived content is kept, and deleted content goes to the Deleted view. These actions need a reason of at least 5 characters, and the reason is written to the audit log.
Pages, policies and guides
- Open the page.
- Select the action in the More actions menu on the Publication card.
- Enter the reason and confirm.
The actions work as follows.
- Unpublish removes the page from the site at once. Visitors to its address see a "not found" page, and links to it in menus are hidden. The page can still be edited and published again.
- Archive removes the page from the site and makes it read-only. An archived page cannot be edited or published again.
- Delete page removes the page from the list. A published page cannot be deleted. Unpublish it first.
All three actions keep the page's version history.
News, announcements and events
The More actions menu on the Publication card of the news editor holds Unpublish, Archive and Delete. The Actions menu of the list also offers unpublishing and deleting.
- An unpublished item leaves the site at once and returns to draft. Its card on the home page may stay visible to visitors who are not signed in for up to 30 seconds.
- An archived item leaves the site and can be published again later.
- A published item cannot be deleted. Unpublish it first.
Institutional documents
The Actions menu on a document's row holds Unpublish, Archive and Delete. An unpublished document returns to draft and its file link stops working. A published document cannot be deleted. Unpublish it first.
Banners and menus
Deleting a banner or a menu also needs a reason. To remove a banner from the home page without deleting it, use Take offline. The details are in Adding a Banner and Editing a Menu.
Restoring deleted content
- For pages and news, tick the Deleted box in the list. Press Restore on the row. The content comes back with its previous status.
- For banners and documents, press Deleted at the top of the screen and select Restore. A restored banner comes back switched off, and a restored document comes back archived. To show them on the site, switch the banner on again and publish the document again.
Screens and settings
News & Events
The tabs, filters, columns and row actions of the screen that lists news, announcements, events and calls.
The Institutional content → News & events screen lists news, announcements, events and calls on separate tabs. An item whose publication date is set in the future shows on the site from that time on.
Tabs
| Tab | Items | On the public site |
|---|---|---|
| News | News | /haberler (/en/news) |
| Announcements | Public announcements, and announcements shown in the panel only to selected roles | The public ones under /haberler (/en/news) |
| Events | Events with a start time and a location | /etkinlikler (/en/events) |
| Calls | Calls for papers and chapters with a deadline | /cagrilar (/en/calls) |
On the news, announcement and event tabs, the button at the top of the screen creates an item of that type, for example New news item. The Calls tab also lists the calls that journal editors open from the journal page.
Filters
- The Search box searches titles and addresses.
- The Status list filters items by the statuses Draft, In review, Published and Archived.
- The Featured only box shows featured items.
- The Deleted box shows deleted items.
Columns
| Column | Shows |
|---|---|
| Title | The title and the public address. The Featured, Internal and missing-translation badges also appear here. |
| Category | The item's category |
| Date | For an event the start time and location, for other items the publication date |
| Status | The item's status. A future-dated item shows the date it goes live. |
Row actions
The Actions menu holds Edit, View on the site for a published item, Publish, Unpublish and Delete. A published item cannot be deleted. A deleted item's row shows the Restore button.
The steps are in Adding News, Announcements and Events, and the parts of the editor in News Editing Screen.
How-to
Adding News, Announcements and Events
Preparing a news item, announcement or event, choosing an announcement's audience, featuring an item, and publishing it now or at a later date.
You prepare news, announcements and events on the Institutional content → News & events screen. An item shows on the site when you publish it, not when you save it.
Preparing an item
- On the News & events screen, go to the News, Announcements or Events tab.
- Press the button at the top of the screen, for example New news item.
- On the Türkçe (Turkish) tab, fill in Title, Short summary and Text. The Turkish title is required.
- On the Details card, optionally enter a Category and upload a Cover image.
- To show the item on the home page and at the top of lists, switch on Feature.
- Press Save.
Write the English text on the English tab. The cover image is resized and its EXIF data is removed.
Event details
An event shows the Event details card. Starts is required, and Ends and Location are optional. You enter times in Istanbul time, and the end cannot be before the start.
An announcement's audience
An announcement shows the Audience card.
- If you select no role, the announcement is published for everyone on the public site.
- If you select roles, the announcement does not show on the public site. It shows only in the panel of users with those roles, in the Announcements section of the Overview screen and in the announcement strip at the top of the page.
Calls
The Calls tab lists calls for papers and chapters. You start a new call with the
New call button on this tab. A call's Call details card has
the Deadline field. The public site's /cagrilar page (/en/calls in English) sorts open calls by
deadline. A call whose deadline has passed moves under the Closed calls heading. A journal's editors open the
journal's calls from the journal page, and
Posting Journal Announcements and Calls describes those steps.
Publishing
The Publication card appears after the item is saved for the first time.
- Publish publishes the item at once.
- Publish later makes the time you choose the publication date. The item shows from that moment on. If you choose a past date, the item goes live at once and is sorted by that date in lists.
- On a published item, Change publication date changes the publication date.
An event cannot be published without a start time. An edit to a published item shows on the site as soon as you save it. If review approval is on in your installation, the steps in Publishing with Review Approval apply. To remove an item from the site, see Unpublishing and Deleting.
Screens and settings
News Editing Screen
The Content card, the Publication card, the type-specific cards and the rules of the editor for news, announcements, events and calls.
The news editor opens when you create an item or press an item in the list. The item's type shows above the title, and its status and public address next to it. On an internal announcement, the Internal badge appears instead of the address.
Top buttons
- View on the site opens the published item in a new tab.
- Save saves the changes. The Ctrl+S shortcut saves too.
- Publish publishes the item.
Content card
The Content card holds the Türkçe (Turkish) and English tabs, Title, Short summary and Text. The short summary is shown on cards and in lists.
Publication card
The Publication card appears once the item is saved. It shows the publication date, a scheduled publication or the review note. Its buttons depend on the item's status.
- Send for review sends the item to review and appears only while review approval is on.
- Publish publishes the item at once, and Publish later at the time you choose.
- Change publication date changes the publication date of a published item.
- The More actions menu opens Send back to draft, Unpublish, Archive and Delete.
Cards by type
| Card | Type | Fields |
|---|---|---|
| Event details | Event | Starts (required), Ends, Location |
| Call details | Call | Deadline |
| Audience | Announcement | A list of roles. With no role selected, the announcement is public. |
| Details | All | Category, Feature, Address (slug), Cover image |
Rules of the screen
- The Turkish title is required and must be at least 2 characters long.
- The address consists of lower-case letters, digits and hyphens. If you leave it empty, it is generated from the title.
- The end time cannot be before the start time.
- An audience can be chosen for announcements only.
- A deleted item opens read-only.
- While a status action such as publishing runs, the Save button is disabled. What you type while a save or an action runs is not lost. It stays on the screen afterwards, waiting to be saved.
The steps are in Adding News, Announcements and Events.
Screens and settings
Banners
The screen that lists the banners in the showcase area of the home page, its states and actions, and the fields of the banner dialog.
The Institutional content → Banners screen manages the showcase area of the home page. Banners appear on the home page in the order of the list.
List
Each row shows the banner's image, title, subtitle, button text, link and display window. The badge next to the title gives the banner's state.
| State | Meaning |
|---|---|
| Live | The banner is on and inside its display window, and it shows on the home page |
| Off | The banner is off and does not show on the home page |
| Scheduled | The banner is on, but its display window has not started yet |
| Expired | The banner is on, but its display window has ended |
You change the order by dragging a banner by its handle or with the up and down arrows. The new order is saved at once.
Buttons and row actions
- New banner opens the banner dialog.
- Deleted lists the deleted banners. Restore brings a banner back switched off.
- The row's Actions menu holds Edit, Go live, Take offline and Delete.
Switching a banner on or off and deleting a live banner need the publish permission.
Banner dialog
| Field | Description |
|---|---|
| Title | A Turkish title is required. The English title goes on the English tab. |
| Subtitle | Optional |
| Button text | The text of the button on the banner |
| Link | Where the button leads. It starts with https:// or /. |
| Image | JPG, PNG or WebP. The image is resized and its EXIF data is removed. |
| Display window | The From and To times. When they are empty, the banner shows with no end. |
| Live | A live banner shows on the home page within its display window. |
Rules of the screen
- The end time must be after the start time.
- The image does not show on the home page until it has passed the virus scan. If the image does not pass the scan or cannot be opened, the image field says why and what to do.
- Banners are not subject to the review approval rule.
- While you are signed in, you see a change on the home page at once. Visitors who are not signed in may see the home page as it was up to 30 seconds earlier.
- Deleting needs a reason of at least 5 characters.
- The list and the Deleted list show at most 1,000 banners. If there are more, a note above the list says so.
The steps are in Adding a Banner.
How-to
Adding a Banner
Adding a banner to the home page, giving it a display window, ordering banners, and taking them offline or deleting them.
Banners appear in the showcase area of the home page in the order of the list. Each banner has a title, a button and an image, and optionally a display window.
New banner
- On the Institutional content → Banners screen, press New banner.
- On the Türkçe (Turkish) tab, fill in Title. Optionally enter Subtitle and Button text.
- To show text on the English site too, fill in the English tab.
- In Link, enter the address the button leads to.
- Upload the image in Image.
- To show the banner for a limited time, enter the From and To times under Display window.
- To put the banner online, switch on Live.
- Press Save.
A new banner goes to the end of the list. Change its position by dragging its handle or with the arrows.
Taking a banner offline and deleting it
- Take offline removes the banner from the home page and keeps it in the list. Go live switches it back on.
- Delete asks for a reason and moves the banner to the Deleted list. A restored banner comes back switched off. Switch it on again to show it on the site.
While you are signed in, you see the change on the home page at once. Visitors who are not signed in see it up to 30 seconds later.
Only people with the publish permission can use the Live switch and switch banners on and off. The parts of the screen are described in Banners.
Screens and settings
Institutional Documents
The groups, statuses and actions of the screen that lists PDF documents such as regulations, directives and reports, and the fields of the document dialog.
The Institutional content → Institutional documents screen manages PDF documents such as regulations, directives and
annual reports. Published documents are listed on the public site's Institutional documents page (/belgeler, or
/en/documents in English).
List
Documents are grouped by category on separate cards. Documents without a category are on the Uncategorised card. Each row shows the title, version, document date, file name and size, and the document's status. If the file's virus scan has not finished, the scan status shows too.
You change the order within a card by dragging a document by its handle or with the arrows. The Status list at the top filters documents by the statuses Draft, In review, Published and Archived.
Buttons and row actions
- New document opens the document dialog.
- Deleted lists deleted documents. Restore brings a document back as archived.
- The row's Actions menu holds Edit, Download file, Publish, Unpublish, Archive and Delete. When review approval is on, Send for review and Send back to draft appear too.
Document dialog
| Field | Description |
|---|---|
| Title | The Turkish title is required, the English title is optional. |
| Category | On the documents page, the document is grouped under this heading. Categories used before are offered as suggestions. |
| Version | For example v1.0 |
| Document date | The date of the document |
| PDF file | PDF only, required |
Rules of the screen
- A file cannot be downloaded until it has passed the virus scan.
- A published document cannot be deleted. Unpublish it first.
- Replacing the file of a published document is written to the audit log as a separate action.
- Unpublishing, archiving and deleting need a reason of at least 5 characters.
- The list and the Deleted list show at most 1,000 documents. If there are more, a note above the list says so. You can narrow the list with the Status filter.
The steps are in Publishing an Institutional Document.
How-to
Publishing an Institutional Document
Uploading a PDF document such as a regulation, directive or report, publishing it on the public site and replacing the file of a published document.
Institutional documents are listed by category on the public site's /belgeler page (/en/documents in English).
You add a document as a draft first and then publish it.
Adding and publishing a document
- On the Institutional content → Institutional documents screen, press New document.
- Enter the Turkish title in Title. The English title is optional.
- Optionally fill in Category, Version and Document date.
- Upload the PDF in PDF file.
- Press Save. The document is added to the list as a draft.
- In the Actions menu of the document's row, select Publish and confirm.
The file cannot be downloaded until it has passed the virus scan. If review approval is on in your installation, send the document to review first. The steps are in Publishing with Review Approval.
Replacing the file
- Select Edit on the document's row.
- Upload the new PDF in Replace file.
- Press Save.
The file of a published document changes as soon as you save, and the change is written to the audit log.
To remove a document from the site, see Unpublishing and Deleting.
Concept
Policy Versions
How policies are published with a version label and an effective date, how the public site shows earlier versions, and the cookie policy and privacy notice.
When a policy changes, readers need to see which rule applied when. That is why JournTech keeps policies in versions. Every published version carries its own label and effective date and is never changed afterwards.
Version label and effective date
A policy is published only when Version label and Effective date are filled in. Every published version has its own label, for example v2.0 and v2.1. A label that was published before cannot be used again. When you restore an old version, its label comes back too. In that case, enter a new label before publishing.
Versions on the public site
The public site shows the version of the policy in force, with its version label and effective date. At the bottom of the page is a list of earlier versions, and each earlier version can be read at its own link. Search engines do not index earlier versions.
Cookie policy and privacy notice
The institution's cookie policy and its KVKK privacy notice (the notice required by Türkiye's Personal Data Protection Law) are published as policies too. On a first visit to the public site, a short cookie note appears at the bottom of the page. The note says that the site uses only the cookies it needs to work and to stay secure, and it links to the Policies page. When the visitor presses OK, the note does not appear again in that browser. The site uses only strictly necessary cookies, so there is no consent dialog.
The steps for creating a policy are in Creating a Page.
Concept
Institutional Content Rules
The rules for text cleaning, immutable versions, address redirects, image processing, virus scanning, permissions and the audit log in institutional content.
Institutional content is published on the public site in the institution's name. That is why the system applies the same rules to all of it.
Text cleaning
Content from the text editor is cleaned when it is saved. Harmful tags and scripts are not stored. Text pasted into a page therefore cannot harm the visitors of the site.
Immutable versions
Every published page version is stored so that it cannot be changed. The public site always shows this version, so an unfinished edit never appears on the site. Restoring an old version also creates a new version, and the history is not deleted.
Address redirects
When the address of a published page changes, the old address redirects to the new one. Links that were shared keep working. The redirect is set up for both the Turkish and the English address. An old address that redirects is not given to a new page or news item, because the old links would then open the new content. An address made from the title then gets a number at the end.
Images and files
Uploaded images are resized and their EXIF data is removed. Every file goes through a virus scan. Until the scan is done, a file cannot be downloaded and an image does not show on the site. A file that fails the scan cannot be used in content.
Permissions and the audit log
Publishing, unpublishing and archiving content need the publish permission. A user without it submits the content for approval with Send for review. Publishing actions, deletions of subscribers and messages, and exports are written to the audit log.
If the system administrator has made two-factor authentication mandatory for privileged roles, the Content editor permissions do not work until two-factor authentication is set up. The setup is described in Using Two-Factor Authentication.
Troubleshooting
My change does not show on the site
Causes and fixes when a page, news, banner or menu change you saved does not show on the public site.
The public site shows the published version of a live page. Saving does not put a change online. Check the causes below in order.
The change is not published
On a live page, Save is not enough. If the Publication card says there are unpublished changes, press Publish changes.
The change is in review
If review approval is on in your installation, changes go to review first. The site keeps the old content until another editor publishes them. The steps are in Publishing with Review Approval.
The publication is scheduled
If the card shows a publication time, the page is published automatically at that time. To publish now, press Publish changes. Publishing also removes the schedule.
The news item's publication date is in the future
If a news item's publication date is in the future, the item does not show on the site until then. In the list, the item's status column shows the date it goes live.
A link in the menu
The public site caches menus for up to 20 seconds. Reload the page after a moment. If the link still does not show, see A menu link does not show on the site.
The home page
The public site keeps the publication lists, news, events and banners of the home page in a cache for up to 30 seconds for visitors who are not signed in. While you are signed in, the home page always opens up to date. To see a change in a browser that is not signed in, reload the page after half a minute. Record and news pages show the change at once.
Only on the English site
If you changed only the Turkish text, the English site keeps the old text. For the translation, see A page shows in Turkish on the English site.
Troubleshooting
A policy cannot be published
Causes and fixes related to the version label, the effective date, review approval and archiving when you get an error while publishing a policy.
A policy is published only with a version label and an effective date, and every published version has its own label. When a policy cannot be published, the notice at the bottom right says that the publishing conditions are not met and marks the field at fault.
The version label or effective date is empty
On the Page settings card, fill in Version label (for example v2.1) and Effective date. Save and publish again.
The label was published before
You cannot reuse a label that was published before. If you restored an old version, its label came back with it. Enter a new label in Version label, save and publish again.
Review approval is on
If review approval is on in your installation, a policy is published only after review. If you sent the policy to review yourself, another editor publishes it. The steps are in Publishing with Review Approval.
The policy is archived
An archived policy is read-only and cannot be published again. Create a new policy if you need one.
The rules are described in detail in Policy Versions.
Troubleshooting
A page shows in Turkish on the English site
How to add the translation when a page, news item, banner or document shows in Turkish on the English version of the public site.
When content has no English translation, the public site shows the Turkish text on the English page. In the editor, Translation missing appears next to the English tab, and lists show a missing-translation badge next to the content.
Adding the translation
- Open the content and go to the English tab.
- Optionally press Copy from Turkish to start from the Turkish text.
- Write the title and the text in English and press Save.
- If the page is published, press Publish changes.
For news and events, a change to a published item shows on the site as soon as you save it. You enter the English title of a banner or an institutional document in its own dialog.
The translation is missing some fields
If there is an English title but no summary or text, that field stays empty on the site. The page editor shows a note listing the fields missing in this language. Fill in the missing fields and publish the page again.
Troubleshooting
I cannot find the For authors page in the panel
Where you edit the text of the For authors page of the public site in the panel, and how to create the page if it does not exist.
The text of the For authors page on the public site is a guide whose address is yazarlar-icin. You edit it among
the guides on the Pages & policies screen, not on a separate screen.
- On the Institutional content → Pages & policies screen, go to the Guides tab.
- Open the guide whose address is
yazarlar-icin. - Edit the text, save it and publish it.
If there is no such guide, select Guide in the New page menu and enter
yazarlar-icin in Address (slug). Until the guide is published, the page opens with a built-in text. In every
case, the page also lists the ways to submit to the published journals.
A journal's own author guidelines are in the journal profile and are described in Setting Author Guidelines and Review Criteria.
Troubleshooting
The Publish button is missing in institutional content
Causes and fixes related to the content's status, review approval and permissions when a page, news item or institutional document shows no Publish button.
The Publish button depends on the content's status, your installation's review approval rule and your permissions. Check the causes below in order.
The content is not saved yet
On new content, the publication card appears after the first save. Press Save first.
There is nothing to publish
On a published page with no saved changes, the button is hidden. Once you save a change, the button appears as Publish changes. You change the publication date of a published news item with Change publication date.
The content is archived
An archived page is read-only and cannot be published. An archived news item or document can be published again.
Review approval is on
If review approval is on in your installation, content is published only after review. Press Send for review first.
You sent the content to review
If the card says that another editor will publish the content, you sent it to review yourself. Ask another editor to publish it. The reasoning behind the rule is in Four-Eyes Principle.
You do not have the publish permission
If the card says that you cannot publish, send the content to review. The publish permission belongs to the Content editor and System administrator roles.
How-to
Managing Help Notes
Adding information specific to your institution below help topics, previewing it and removing it.
The help pages are the same in every installation of JournTech. You can add information that is specific to your institution below a topic as a note, for example an internal approval step, a submission calendar or the name of the unit that answers questions. Readers see the note at the end of the topic, under the name of your institution. The note appears both on the help page and in the help side panel.

Users with the "Edit pages, menus, banners, news, events and documents" permission write the notes.
Adding a note
- Open the Institutional content → Help notes screen.
- Press Add a note and select the topic the note is for. If the topic you select already has a note, its text comes into the dialog and you edit it.
- Write the Turkish text. For the English pages, you can also write on the English tab. If there is no English note, the English pages show the Turkish note.
- Check with Preview how the note will look on the page, then press Save.
The Add an institution note to this topic link in the side panel opens the same dialog with that topic selected. When you notice missing information while you read a topic, adding the note from there is quicker.
Text format
Notes are written in Markdown. For bold text use **text**, and for a bullet point use - at the start of a line. A
link to a web page has the form [text](https://…). For a link to another help topic, write [text](konu:topic-id).
The topic ID is the last part of the help page's address. For this page it is yardim-notlari.
HTML is not added to a note. If you write HTML, it appears as plain text. If a link does not open or a shortcode is not recognised, the preview shows it and the note is not saved.
Removing a note
Use Delete the note in the menu on the note's row in the list. The note disappears from the help page and from the side panel at once. Adding, changing and deleting a note are written to the audit log.
If a topic is removed or renamed in a version upgrade, the note stays in the list with the Topic removed marker and does not appear on any page. Move the text to another topic and delete the old note.
Feature
Newsletter and Contact
Managing newsletter subscribers and answering the contact messages that come from the public site.
The Institutional content → Newsletter subscribers screen lists the people who signed up with the newsletter form on the public site. The subscription uses double opt-in and is complete once the person opens the link sent to their e-mail. The panel does not send newsletters. It keeps the subscriber list and gives the confirmed subscribers as a CSV file.
The Institutional content → Contact messages screen collects the general messages, copyright reports and correction requests from the public site's contact form. Opening a message counts as access to personal data and is written to the audit log. You send the reply by e-mail yourself and record the outcome on the screen.
Users with the Catalogue editor role also settle copyright reports and correction requests on the Catalogue → Copyright and correction reports screen. The forms on the public site are turned on and off with the Newsletter sign-up (public site) and Contact form flags on the Site settings → Features tab.
Screens and settings
Newsletter Subscribers
The counters, filters and columns of the newsletter subscribers screen, the CSV export and the rule for deleting a subscriber record.
The Institutional content → Newsletter subscribers screen lists the people who signed up with the newsletter form on the public site. Subscription uses double opt-in. A person signs up with the form and becomes a subscriber on opening the confirmation link sent to their e-mail address. The confirmation link is valid for 7 days.
The panel does not send newsletter e-mails. It keeps the subscriber list and gives you the subscribers as a CSV file.
Counters and filters
The Confirmed, Awaiting confirmation and Unsubscribed boxes at the top show the number of subscribers. Pressing a box narrows the list to that status. The Search box searches the e-mail addresses, and the Status list filters subscribers by status.
Columns
| Column | Shows |
|---|---|
| The subscriber's e-mail address | |
| Language | The language the subscriber chose |
| Status | Awaiting confirmation, Confirmed or Unsubscribed |
| Dates | The dates of sign-up, confirmation and unsubscribing |
| Consent text | The version of the privacy notice the subscriber accepted |
CSV export
Download CSV downloads the subscribers in the status selected in the filter. With no status selected, you get the confirmed subscribers.
- The addresses of confirmed subscribers are written in full, because these people gave explicit consent to the newsletter.
- The addresses of subscribers awaiting confirmation and of those who unsubscribed are masked unless you have the permission to export personal data.
- Every export is written to the audit log.
The permission to export personal data (Export reports with personal data) belongs to the System administrator role only.
Deleting a record
Delete record on a row deletes the subscription and the e-mail address permanently, as KVKK (Türkiye's Personal Data Protection Law) requires. The deletion cannot be undone and is written to the audit log.
The newsletter form is switched on with the Newsletter sign-up (public site) feature flag. The subscribers' unsubscribe link works even while the flag is off. The download steps are in Downloading the Subscriber List.
How-to
Downloading the Subscriber List
Downloading the confirmed subscribers as a CSV file to send a newsletter, and the details the file contains.
The panel does not send newsletter e-mails. To send a newsletter, you download the confirmed subscribers as a CSV file.
- Open the Institutional content → Newsletter subscribers screen.
- Leave the status filter empty, or press the Confirmed box.
- Press Download CSV.
For each subscriber the file holds the e-mail address, the language, the status, the version of the privacy notice they accepted, and the dates of sign-up, confirmation and unsubscribing. The addresses of confirmed subscribers are written in full.
If you select another status before downloading, the addresses of subscribers awaiting confirmation and of those who unsubscribed are masked unless you have the permission to export personal data. Every export is written to the audit log.
To remove a subscriber from the list, see Newsletter Subscribers.
Screens and settings
Contact Messages
The message types, filters and columns of the screen that lists contact form messages and copyright and correction reports, and the message dialog.
The Institutional content → Contact messages screen lists the messages from the contact form of the public site. Messages are grouped by type, and personal data is deleted automatically when the retention period ends.
| Type | Who sees it | Retention period |
|---|---|---|
| General | Content editor | 365 days |
| Copyright report | Content editor and Catalogue editor | 730 days |
| Correction report | Content editor and Catalogue editor | 365 days |
A System administrator sees every type. A Catalogue editor opens the same screen from Catalogue → Copyright and correction reports and sees only copyright and correction reports. The catalog editor records the outcome but cannot delete personal data.
Filters
- The Search box searches the subject, the sender's name and the e-mail address.
- The Type list filters messages by type.
- The Status list filters messages by the statuses New, In progress and Closed.
Columns
| Column | Shows |
|---|---|
| Subject | The subject and the first lines of the message |
| Sender | The sender's name and e-mail address |
| Type | The message type |
| Status | The message status, and a mark when an outcome is recorded |
| Received | When the message arrived |
New messages are highlighted in the list.
Message dialog
Open on a row opens the message. Opening a message is written to the audit log as access to personal data. The dialog shows the sender, type, status, time received and retention date. If the message concerns a publication, the Related publication line shows its address.
The bottom of the dialog holds these fields and buttons.
- New status offers Start handling and Resolve and close.
- Outcome / action taken is required when you close a message.
- Copyright and correction reports also show Reason (written to the audit log).
- Update records the outcome, and Delete personal data deletes the message and the sender's details permanently.
The new-message notification does not include the message text. Its link opens the message directly on this screen. The steps are in Replying to a Contact Message.
How-to
Replying to a Contact Message
Opening a contact message, copyright report or correction report from the public site, replying to it, recording the outcome and deleting the personal data.
You read a contact form message in the panel and send the reply yourself by e-mail. The panel does not send the reply for you.
Resolving a message
- On the Institutional content → Contact messages screen, press Open on the message's row. The link in the notification also opens the message.
- Send the reply from your own e-mail program. The sender's address is shown below the message.
- Under New status, select Start handling or Resolve and close.
- In Outcome / action taken, enter what you did. When you close the message, this field is required and must be at least 3 characters long.
- For a copyright or correction report, you can also fill in Reason (written to the audit log).
- Press Update.
For copyright and correction reports, the outcome is also written to the audit history of the publication concerned. If the message concerns a publication, the Related publication line shows its address. If you have catalogue permissions, the Open publication link takes you to the record.
Deleting the personal data
- Open the message.
- Press Delete personal data at the bottom of the dialog and confirm.
The message and the sender's details are deleted permanently. Only non-personal facts stay in the audit log. A Catalogue editor does not see this button.
If you do not delete them, the personal data is deleted automatically on the retention date shown in the dialog. General messages and correction reports are kept for 365 days, copyright reports for 730 days.
Feature
Users and Roles
Inviting users, managing accounts, and granting and revoking roles.
Accounts and roles are managed on the Administration → Users & roles screen. From there the system administrator invites users, verifies e-mail addresses, issues password links, unlocks accounts or disables them. Every account starts with the Registered researcher role.
Editorial roles are granted for a single journal or for the whole platform, with an end date if you want one. You see the permissions each role contains on the Roles & permissions guide screen and on the role pages of this help. The server refuses every action that a role does not contain.
Role and account changes are written to the audit log. The system administrator cannot issue final decisions on submissions or approve ISBN requests. These rules are explained in Separation of Duties and Four-Eyes Principle.
How-to
Inviting Users
Opening an account for a new person, granting their roles and passing on the link to set a password by e-mail or by hand.
The account of the person you invite is opened at once, and the person gets a one-time link to set their password. The link is valid for 14 days. When the person sets their password, their e-mail address is verified too.
Steps of the invitation
- On the Administration → Users & roles screen, press Invite user.
- Fill in the E-mail and Full name fields.
- In the E-mail language list, select the language of the invitation e-mail.
- If you are giving the person an extra role, press Add role in the Roles section.
- Select the role on the added row. For the Section editor and Editor-in-chief roles, you can also select a journal from the list next to it.
- If you want the invitation e-mail to go to the person, leave Send the invitation e-mail ticked.
- Press Create invitation.
Every account starts with the Registered researcher role, so you do not need to grant this role separately. You can grant other roles later too. The details are in Granting and Revoking Roles.
If an account was already opened with this address, no invitation is created. The invitation is written to the audit log.
Invitation link passed on by hand
If you untick Send the invitation e-mail, or if e-mail sending is off in the installation, the window shows the Invitation link field. The link appears only in this window and only once. Copy the link and pass it to the person through a secure channel.
If e-mail sending is on, the invitation e-mail goes to the person automatically, and the window says so. The Open user button in the window opens the new account's page.
Accepting with ORCID
If sign-in with ORCID is on, the window also has the ORCID iD for signing in field. If you enter the person's ORCID iD in this field, the person can accept the invitation with the Accept with ORCID button without setting a password. The invitation can be accepted only with this ORCID iD, and from then on the person can sign in with ORCID. The setting itself is described in Configuring ORCID Sign-In.
After the invitation
Until the person opens the link and sets their password, the account's status shows as Awaiting verification. How the person accepts the invitation is described in Accepting an Account Invitation.
If the invitation link has expired, you cannot create a new invitation to the same address, because the account is already open. Create a One-time password link on the person's page and pass it to the person. When the person sets their password with this link, their address is verified too. The steps are in Managing User Accounts.
If the New account registration flag is on, people can also open accounts themselves on the registration page. The flag is explained in Feature Flags.
How-to
Granting and Revoking Roles
Granting a user a role for a single journal or for the whole platform, with an end date if you like, and revoking the role.
Roles are granted and revoked on the Roles & scopes card of the user's page. The change takes effect at once and is written to the audit log.
Granting a role
- On the Administration → Users & roles screen, press the user's name.
- On the Roles & scopes card, press Grant role.
- In the Role list, select the role.
- If the role is Section editor or Editor-in-chief, select Whole platform or a journal in the Scope list.
- If the role is to end on a certain day, fill in the Expires on field. If you leave the field empty, the role has no end date.
- Press Grant role in the window.
If the user already has the same role with the same scope, the role is not granted a second time. If you are giving an editor duties in several journals, grant the role separately for each journal.
Effect of the scope
An editor role granted for a single journal shows only that journal's submissions. An editor whose role was granted for Whole platform sees the submissions of all journals and the books, chapters and other submissions that do not belong to a journal. Other roles are always granted for the whole platform.
A role whose end date has passed stays on the card with its end date, but it gives no permissions. A role's end date cannot be changed later. To change the date, remove the role and grant it again with the new date.
The Roles & permissions guide button on the Users & roles screen shows which permissions the roles contain. The screen is explained in Roles & Permissions Guide.
Revoking a role
- On the user's page, find the Roles & scopes card.
- On the role's row, press Revoke role.
- In the window that opens, press Revoke role again.
The user immediately loses access to the screens and actions of this role.
Rules the system applies
- Registered researcher is the base role of every account and cannot be removed.
- You cannot remove your own System administrator role.
- At least one System administrator must remain on the platform.
- Every action that a role does not contain is refused on the server. The menus also show only the sections the user is allowed to use.
- Roles do not work on an account whose e-mail address is not verified.
- If mandatory two-factor authentication is on, administrator and editor roles do not work until the person turns on two-factor authentication.
The system administrator's roles
Someone with the System administrator role has access to every section but cannot make final decisions on submissions or approve ISBN requests. They do not count as part of the editorial or production team either. They do not get notifications about new submissions and production jobs, and they do not appear in the editor assignment lists.
If a system administrator is also an editor of a journal, grant their account the Editor-in-chief or Section editor role as well. If they sit on the publishing board, grant them the Publishing board role too. The details of the rules are in Separation of Duties and Four-Eyes Principle.
How-to
Managing User Accounts
Verifying an e-mail address by hand, changing the name and e-mail, giving a password link, unlocking and disabling an account from the user page.
The account actions are on the Account actions and Account cards of the user's page. You open the page by pressing the user's name on the Administration → Users & roles screen. Every action here is written to the audit log.
Verifying an e-mail address by hand
Anyone can open an account with somebody else's e-mail address. Verify the address only after you have confirmed by phone or through institutional correspondence that the person really uses that mailbox. The safer way is to give the person a one-time password link. Whoever opens the link has proved the address, and the address is verified automatically.
- On the Verify e-mail manually row, press Confirm.
- Read the warning in the window and press Confirmed — verify.
This row appears only on accounts whose e-mail address is not verified. The status of a verified account becomes Active.
Changing the name and e-mail address
- On the Edit name and e-mail row, press Edit.
- Change the Full name or E-mail address field.
- Press Save.
- If you changed the e-mail address, press Change the e-mail address in the window that opens.
From then on, the person signs in with the new address. Until the new address is verified, the account counts as unverified, and actions such as submitting are closed to it. A verification link goes to the new address and a notice to the old one. Password links sent to the old address stop working. If another account was opened with the new address, nothing is changed.
You cannot change your own address on this screen. You change your own address on the My profile page. How a person changes their own address is described in Changing Your E-mail Address.
One-time password link
You pass this link on yourself to a person who forgot their password, or in an installation without e-mail sending.
- On the One-time password link row, press Create link.
- Copy the link in the Password reset link window.
- Pass the link only to the person themselves, through a secure channel.
The link is valid for the time shown in the window, 60 minutes by default, and works only once. When the person sets their password with the link, their e-mail address counts as verified too.
Account lock
In a default installation, an account is locked for 15 minutes after 5 failed attempts in a row. The lock appears with its end time on the Locked until row of the Account card and lifts by itself at that time. To lift the lock earlier, press Unlock on the same row.
The locked-out person is told by e-mail. A security alert goes to the system administrators too. The alert is explained in Operations Alerts.
Disabling an account
- On the Account actions card, press Disable account.
- In the window that opens, press Disable account again.
The person cannot sign in, and their open sessions are closed at once. No data is deleted. You open the account again with the Enable account button in the same place.
The person's editorial, reviewing and production roles stay in place, and the person continues the work once the account is open again. While the account is closed, the person gets no reminders. Notifications meant for the person go to the team of the same work. The production coordinators receive the production notifications, and the journal's editors-in-chief receive decision recommendations. On the editorial and production screens the Account closed label appears next to the person's name. If the account stays closed for long, give the person's work to someone else.
If you suspect that an account has been taken over, disable it first. Once you have confirmed the person's identity, enable the account and give the person a one-time password link.
Limits on your own account
You cannot disable or anonymise your own account. On this screen you cannot change your own name and e-mail address, create a password link for yourself or reset your own two-factor authentication. The buttons for these actions do not appear on your own page.
Resetting two-factor authentication is described in Resetting Two-Factor Authentication, and anonymising an account in Anonymising an Account.
How-to
Resetting Two-Factor Authentication
Turning off two-factor authentication for a user who lost their authenticator app and recovery codes, after confirming their identity.
A person who cannot reach their authenticator app can sign in with one of their remaining recovery codes. If the codes are lost too, you reset the person's two-factor authentication from the user page. Do this only after you have confirmed the person's identity through another channel.
- Confirm the person's identity by phone, through institutional correspondence or in person.
- On the Administration → Users & roles screen, press the user's name.
- On the Account actions card, press Reset two-factor authentication.
- In the Reason (how the identity was confirmed) field, write how you confirmed the identity, in at least 5 characters.
- Press Reset two-factor authentication in the window.
Effects of the reset
- The authenticator key and the recovery codes are deleted.
- All of the person's sessions are closed.
- The person receives an e-mail and a panel notification.
- The action is written to the audit log with its reason.
From then on, the person signs in with their password alone and turns two-factor authentication on again on the My profile → Security tab. The setup is described in Using Two-Factor Authentication.
If mandatory two-factor authentication is on and the person has an administrator or editor role, the person cannot do the work of that role until they finish the setup.
When the button does not appear
The Reset two-factor authentication button appears only on accounts that have two-factor authentication turned on. You see the state on the Two-factor authentication row of the Account card. The button does not appear on your own account either. You manage your own two-factor authentication on the Security tab.
How-to
Requiring Two-Factor Authentication
Turning on the feature flag that makes two-factor authentication mandatory for administrator and editor roles, and knowing which roles the rule covers.
While the Mandatory two-factor authentication for privileged roles flag is on, the permissions of administrator and editor roles work only on accounts that have two-factor authentication turned on. The flag is off by default.
Roles the rule covers
- System administrator
- Editor-in-chief and Section editor
- Catalogue editor and Content editor
- Production coordinator
- Publishing board
The Registered researcher, Reviewer, Unit manager and Auditor roles are outside the rule.
Accounts without two-factor setup
The person can sign in to the panel, but the permissions of their covered roles do not work. They can keep working with their roles that are outside the rule. The Two-factor authentication required. warning appears at the top of the panel. The Turn it on button in the warning opens the My profile → Security tab. Once the setup is finished, the permissions of the roles come back at once. The steps of the setup are in Using Two-Factor Authentication.
Turning the flag on
- Set up two-factor authentication for your own account on the My profile → Security tab.
- Tell the users in these roles in advance that they need to do the setup.
- On the Administration → Site settings screen, open the Features tab.
- Turn on the Mandatory two-factor authentication for privileged roles flag.
- In the window that opens, press Confirm.
The flag takes effect at once, and the change is written to the audit log.
If you turn the flag on without doing your own setup, your administration permissions stop too. In that case, set up your own two-factor authentication first. Once the setup is finished, your permissions come back.
If a user loses their authenticator app, you reset their two-factor authentication. Until the person does the setup again, they cannot do the work of their covered roles. The steps are in Resetting Two-Factor Authentication.
Screens and settings
Users & Roles Screen
The administration screen where accounts are searched and filtered, their roles and statuses are shown and new users are invited.
The Administration → Users & roles screen lists all accounts that have not been anonymised. The newest account is at the top. Pressing a user's name opens the User Page.

Buttons
- Roles & permissions guide shows the permissions that the roles contain. The screen is explained in Roles & Permissions Guide.
- Invite user opens a new account and gives the person a password link. The steps are in Inviting Users.
Filters
| Filter | What it does |
|---|---|
| Search | Searches with part of the name or e-mail address |
| Role | Shows the users who have the selected role |
| Status | Filters the accounts by status |
The Clear filters button removes the filters. The filters stay in the address bar, so if you share the link, the same list opens. The Unverified accounts card on the Overview screen opens this list with the unverified accounts.
Columns
| Column | What it shows |
|---|---|
| User | The name, the e-mail address and an icon that shows whether the e-mail address is verified |
| Roles | The user's roles |
| Status | The account's status |
| Last sign-in | The time of the last sign-in, or Never if the user has never signed in |
Account statuses
| Status | Meaning |
|---|---|
| Active | The account is in use. |
| Awaiting verification | The e-mail address is not verified yet. Accounts that registered but did not verify their address, did not accept their invitation or had their address changed are in this status, and their roles do not work. |
| Disabled | The account was disabled and cannot sign in. |
Anonymised accounts do not appear in the list.
Screens and settings
User Page
The cards of the administration screen that shows a user's roles, profile details, account status and account actions.
The user page opens when you press a user's name in the Administration → Users & roles list. The header shows the person's name and e-mail address, the account's status and whether the e-mail address is verified. The History of this record button in the header opens the audit log with the rows about this account.
Roles and scopes
The Roles & scopes card lists the user's roles. Each row states the role's scope. The scope is Whole platform or the name of a journal. The row of the Registered researcher role says Base role. Roles with a time limit show their end date too. The card's Grant role and Revoke role buttons are explained in Granting and Revoking Roles.
Profile details
| Row | What it shows |
|---|---|
| Title | The person's academic title |
| ORCID | The ORCID iD in the profile and, if the person may sign in with ORCID, the ORCID sign-in: assigned or ORCID sign-in: verified label |
| Institutional sign-in | If the account is linked to an institution account, the date of the link and the Remove the link button |
| Institution | The person's institution |
| Reviewer pool | Whether the person has joined the reviewer pool |
| Expertise | The fields of expertise entered for the reviewer pool |
The ORCID iD for signing in field at the bottom of the card allows the person to sign in with ORCID. The field is explained in Configuring ORCID Sign-In, and the link to an institution account in Configuring Institutional Sign-In.
Account
| Row | What it shows |
|---|---|
| Status | The account's status |
| Language | The person's language, in which e-mails are sent |
| Registered | When the account was opened |
| Last sign-in | The time of the last sign-in |
| Active sessions | The number of the person's open sessions |
| Two-factor authentication | Whether two-factor authentication is on or off |
| Locked until | If the account is locked, the time the lock ends and the Unlock button |
Account actions
Only people with permission to manage accounts see the Account actions card. The card has these actions.
| Action | Accounts where it appears |
|---|---|
| Edit name and e-mail | All accounts |
| Verify e-mail manually | Accounts whose e-mail address is not verified |
| Reset two-factor authentication | Accounts with two-factor authentication turned on |
| One-time password link | All accounts |
| Disable account | Active accounts |
| Enable account | Disabled accounts |
The steps of the actions are in Managing User Accounts and Resetting Two-Factor Authentication.
Irreversible actions
The KVKK: anonymise account button on the Irreversible actions card permanently deletes the account's personal data. Only people with permission to manage requests under KVKK (Türkiye's Personal Data Protection Law) see the card. The action is explained in Anonymising an Account.
Your own page
On your own page, the buttons for editing the name and e-mail address, the password link, resetting two-factor authentication, disabling and anonymising do not appear. There is no Revoke role button next to your own System administrator role either.
Screens and settings
Roles & Permissions Guide
The screen that shows the system roles, the permission codes each role contains and whether a role can be granted per journal.
The Roles & permissions guide button at the top of the Administration → Users & roles screen opens the Roles & permissions guide screen. The screen shows the system's own role definitions and changes nothing. Granting a role to a user is described in Granting and Revoking Roles.
Role cards
Each role has a card. The card shows the following.
- The role's name and code, for example
catalog_editor. - Whether the role is labelled Can be granted per journal or Platform-wide.
- A short description of the role.
- The code and description of every permission the role contains.
The Registered researcher and Reviewer roles contain no permissions. Their cards say that access is decided by ownership and invitations. For example, an author sees their own submission, and a reviewer sees the submission they were invited to.
Default deny
Every action that a role does not contain is refused on the server. The menus also show only the sections the user is allowed to use. If a user cannot see a screen, look on the cards for the role that contains the permission for that work.
The role pages of the help are built from the same definitions. That is why their permission lists always match the installed version.
Troubleshooting
A user did not receive the verification e-mail
If a person who opened an account did not get the verification e-mail, checking the outbox and verifying the address with a link or by hand.
The verification e-mail depends on the installation's e-mail sending and on the limit of e-mails that can be sent to one address. Check the causes below in order. What the person can do themselves is described in The verification or password e-mail did not arrive.
The e-mail is waiting in the outbox
On the E-mail outbox tab of the Administration → System health screen, find the e-mail to the person's address. If the status is Not sent (in outbox), e-mail sending is off in the installation. You can take the link with the View content button and pass it to the person. The steps are in Forwarding a Link from the E-mail Outbox.
The e-mail could not be sent
If the status is Failed, the error text on the row gives the reason. Try the e-mail settings with a test e-mail, then send the e-mail again with the Resend button. The settings are in Configuring Outgoing E-mail.
The e-mail was sent but did not arrive
If the status is Sent, the e-mail has left the server. Ask the person to look in their spam folder. Check the SPF, DKIM and DMARC records of the sender domain as well.
The link was requested too often
Password reset and verification e-mails are sent to one address at most three times an hour. Once the limit is passed, the screen gives the person the same answer, but no e-mail goes out. The person can ask again an hour later, or you can use one of the ways below.
Verifying the address another way
Create a One-time password link on the person's page and pass it to the person. When the person sets their password with the link, their address is verified too. If you have confirmed through another channel that the person uses that mailbox, you can also use the Verify e-mail manually action. Both actions are explained in Managing User Accounts.
Troubleshooting
An editor cannot see their journal's submissions
If an editor cannot see their journal's submissions in the queue, checking the role's scope and end date, the e-mail verification and two-factor authentication.
The editor queue shows only the submissions that the editor's role covers. On the Administration → Users & roles screen, open the editor's page and check the following in order.
The role was granted for another journal
On the Roles & scopes card, look at which journal is named next to the editor role. A role granted for a single journal shows only that journal's submissions. If the role was granted for the wrong journal, grant a new role for the right journal and remove the old one.
The submission does not belong to a journal
Books, chapters and other submissions without a journal are seen only by editors whose role covers the whole platform. If the editor is to work on these submissions, grant the role with the Whole platform scope. The editor's side is described in Book submissions do not appear in the queue.
The role has expired
If an end date is shown next to the role and that date has passed, the role does not work. First remove the expired role, then grant the role again with a new end date or with no end date.
The e-mail address is not verified
If the account's status is Awaiting verification, its roles do not work. Once the e-mail address is verified, the editor queue opens. The ways to verify the address are in A user did not receive the verification e-mail.
Two-factor authentication is not set up
If the Mandatory two-factor authentication for privileged roles flag is on, editor roles work only on accounts that have two-factor authentication turned on. If the Two-factor authentication row on the Account card says Off, ask the editor to set it up. The rule is explained in Requiring Two-Factor Authentication.
The editor is an author of the submission
Editors do not see the submissions they are an author of in the queue. Another editor handles such a submission. The rules of the queue are in Editor Queue.
Troubleshooting
A user wants to change their e-mail address
Telling a user whose e-mail address has changed to change it in their own profile, or changing the address on the user page.
A user's e-mail address can be changed in two ways. If the person can still reach their old address, it is safer for them to change the address themselves.
The person changes the address themselves
On the My profile → Profile tab, the person presses Change and enters their new address and their password. The old address stays valid until they open the link sent to the new address. The steps are in Changing Your E-mail Address.
You change the address
If the person cannot reach their old address, use the Edit name and e-mail action on the user page. Confirm the person's identity through another channel first. Until the new address is verified, the account counts as unverified and the person's roles do not work. The steps are in Managing User Accounts.
The new address belongs to another account
If another account was opened with the new address, the address is not changed. Decide together with the person which of the two accounts to use. You can disable the account that will not be used, or anonymise it on the person's request under KVKK (Türkiye's Personal Data Protection Law).
Troubleshooting
A user lost their two-factor authentication device
A user who lost the phone with their authenticator app signs in with a recovery code, or, if the codes are gone too, has their two-factor authentication reset.
A person who cannot reach their authenticator app uses their recovery codes first. If the codes are lost too, you reset the person's two-factor authentication.
The person has a recovery code
On the sign-in screen, after entering their password, the person presses the I can't use my phone — use a recovery code link and enters one of the codes they saved during the setup. Each code works only once. The person's steps are in I cannot access my authenticator app.
The recovery codes are lost too
Confirm the person's identity by phone, through institutional correspondence or in person. Then turn off two-factor authentication with the Reset two-factor authentication action on the user page. The person signs in with their password alone and does the setup again. The steps are in Resetting Two-Factor Authentication.
Remind users to keep their recovery codes in a safe place.
Feature
Site Settings and Feature Flags
The site's identity, workflow rules, search, integrations and feature flags.
Site settings are on the Administration → Site settings screen. The nine tabs of the screen set the site's identity, the workflow deadlines and rules, the integrations, search, the publisher and ISBN details, the review processes, e-mail sending, sign-in with ORCID and the feature flags. The tabs are listed in Site Settings Tabs.
A feature flag turns a feature on or off. A flag takes effect at once, without saving, and every change is written to the audit log. The Help pages open to everyone flag decides whether the help pages are open to visitors who have not signed in. While the flag is off, a visitor is taken to the sign-in page and returns to the help page they wanted after signing in.
Passwords and secret keys are stored encrypted and are never shown on any screen.
How-to
Setting the Institutional Identity and Logo
Setting the site's name, the publisher details, the theme colours, the logo, the tab icon, the contact details and the KVKK privacy notice version on the General tab.
The site's identity details are on the General tab of the Administration → Site settings screen. After filling in the fields, press Save at the bottom of the page. Every saved change is written to the audit log.
Institutional identity
The Institutional identity card has these fields.
- Site name is required. It appears in the site's header and footer and in the page title on the browser tab. The site information given to search engines, the news feed (RSS) and all e-mails use this name too. If no name has been saved, the name given at installation appears.
- Tagline appears on the home page and in the footer and is written separately in Turkish and English.
- Publisher name is used in citations and in the Crossref output.
- Place of publication appears in the Crossref output and on the ISBN copyright page.
- Current privacy notice (KVKK) version holds the version of the privacy notice under KVKK (Türkiye's Personal Data Protection Law) that users must accept.
- KVKK notice page is the short name of the privacy notice's page under Policies, for example
gizlilik-kvkk. The registration form, the sign-in screens, the privacy tab and the contact form link to it. If the field is empty, the links go to the policies list.
The version does not change by itself. When you update the privacy notice, enter the new version in this field. Once the version changes, users see a warning and an accept button on the My profile → Privacy & KVKK tab so that they can accept the new text.
Theme colours
- On the Theme colours card, enter a hexadecimal colour code in the Primary colour and Accent colour (open access) fields, or use the colour picker next to them.
- Press Save.
A colour code is written in the form #2643d6. The colours you choose are used on the public site and in the panel. The
system sets the colour of the text on these colours to a readable contrast automatically.
Site logo
- In the Site logo section of the Theme colours card, select one of the Uploaded logos or upload a new image.
- If the lettering of your logo cannot be read on a dark background, select a light version of the logo in the Dark theme logo section.
- Press Save.
An image you upload is selected at once and goes through the virus scan. While the scan runs, a note stands in place of the preview. The preview appears when the scan is done. If the image does not pass the scan, the note says why and what to do. The other images in the list can be selected once they have passed the scan. If no logo is selected, the JournTech logo is used. To remove the selected logo, press Use the JournTech logo. If no dark theme logo is selected, the site logo appears in the dark theme too. This section appears only while a site logo is selected.
If the selected image did not pass the virus scan, was deleted or is not an image, the settings are not saved. The warning appears under the picker of that image. An image that is still being scanned can be saved, and it appears on the site once the scan is done.
Tab icon
The tab icon (favicon) is the small image shown on the browser tab, in bookmarks and on a shortcut added to the home screen of a phone.
- In the Tab icon (favicon) section of the Theme colours card, select one of the Uploaded images or upload a new image.
- Press Save.
A square image of at least 192 × 192 pixels gives the best result. A wide logo with lettering cannot be read on a tab, so choose an image with only the emblem or the initial of your logo. An image that is not square is fitted into a square without being distorted, with space left at its edges. Uploading and the virus scan work as for the logo. The icon is used on every page of the public site and in the panel. A page of the public site that is already open shows the new icon when it is loaded again. If no icon is selected, the JournTech icon is used. To remove the selected icon, press Use the JournTech icon.
Contact details and social media
The Contact details card has the E-mail and Phone fields and the Turkish and English Address fields. In the Social media links section, enter the full addresses of your LinkedIn, X, YouTube, Instagram and Facebook pages. The links you fill in appear in the site's footer.
The Search engines and sharing card on the same tab is explained in Setting Search Engine and Sharing Defaults.
How-to
Setting Search Engine and Sharing Defaults
Setting the default description and share image that pages without a description or image of their own give to search engines and social media.
The Search engines and sharing card on the General tab sets the defaults for pages that have no description or image of their own, such as the home page, category pages and list pages. Publication and news pages keep using their own abstracts and covers.
- On the Administration → Site settings screen, open the General tab.
- On the Search engines and sharing card, fill in the Turkish and English Default description fields.
- In the Default share image section, select one of the uploaded images or upload a new image.
- Press Save at the bottom of the page.
Default description
The description is plain text and can be at most 300 characters in each language. The pages of each language use only the description in that language. Pages in a language you leave empty give no description.
Share image
When a link to the site is shared on social media, this image appears in the preview. The recommended size is 1200 × 630 pixels. The image can be PNG, JPG or WebP and must be 10 MB or smaller. An image you upload is selected at once and goes through the virus scan. Until the scan is done, a note appears in place of the preview. If the image does not pass the scan, the note says why and what to do.
If no image is selected, the site logo is used, and if no logo is selected either, the JournTech mark is used. To remove the selected image, press Remove the image (use the logo). If the selected image did not pass the virus scan or was deleted, the settings are not saved, and the warning appears under this section.
How-to
Configuring Search
Turning search suggestions and synonym expansion on the public site on or off and defining synonym groups.
The search settings of the public site are on the Search tab of the Administration → Site settings screen. Save your changes with the Save button. A saved change is written to the audit log and takes effect on the site within 15 seconds.
Suggestions while typing
While the Suggestions while typing switch is on, a list of suggestions opens as soon as at least two letters are typed into the search box at the top of the site. The list contains publication titles, keywords and author names that start with what was typed. The list shows at most 8 suggestions. The switch is on by default. If you turn it off, the search box works without suggestions.
Expanding with synonyms
While the Expand with synonyms switch is on and the searched word is in a synonym group, publications that contain the other words of the group are found too. Publications that contain the searched word itself stay at the top of the list. The results page states which synonyms were searched as well. Expansion does not apply to phrases in quotation marks or to author names. The switch is on by default.
Synonym groups
- In the Synonym groups field, write one group per line.
- Separate the words or phrases of a group with commas, for example
makale, yazı, articleoraçık erişim, open access. - Press Save.
The counter next to the field shows how many groups you have defined. Upper and lower case and Turkish characters do not matter, so "Yazı" and "yazi" count as the same word. Groups do not change the stored publications. They only widen the search. When you delete a group and save, its expansion stops too.
Rules for groups
- A group has at least two and at most 20 different words or phrases.
- A word or phrase can be at most 100 characters long.
- You can define at most 500 groups.
- Words must be written in full to match. A group with
articledoes not expand a search forarticles. Add the inflected form to the group if needed.
If a line breaks a rule, nothing is saved and the error is shown with the line number. If you saved while another tab was open, the screen switches to the Search tab to show the error.
Exact phrase search
Visitors can search for an exact phrase by putting the words in quotation marks, for example
"open access policy". This search is always on and needs no setting. The visitor's side of search is described in
Searching the Public Site.
How-to
Configuring ORCID Sign-In
Turning on sign-in with ORCID through an ORCID client, knowing who can sign in this way and allowing a person to sign in with ORCID.
Sign-in with ORCID is only for people who are already known to the system, and no new account is opened with ORCID. While the setting is on, the Sign in with ORCID button appears on the sign-in screen.
Turning the setting on
- On orcid.org, create a free Public API client in the developer tools.
- On the Administration → Site settings screen, open the ORCID tab.
- Copy the address in the Redirect URI field and add it to the redirect URIs of the ORCID client.
- In the Environment list, select Production (orcid.org). For trials, use Sandbox (sandbox.orcid.org).
- In the Client ID field, enter the 20-character ID that starts with
APP-. - In the Client secret field, enter the client secret.
- Press Save.
- Press Test connection and check that ORCID recognises the client.
- Turn on the Allow signing in with ORCID switch.
- Press Save again.
The test uses the saved settings, and the button is off while there are unsaved changes. If ORCID does not recognise the client or orcid.org cannot be reached, the reason appears next to the button.
The client secret is stored encrypted and is never shown again. If you leave the field empty and save, the stored secret is kept. The server must be able to reach orcid.org. The line at the top of the card shows whether sign-in with ORCID is on and how many accounts can sign in with ORCID.
When you turn the switch off and save, the button disappears and sign-in with ORCID stops at once.
Who can sign in
- People whose ORCID iD an administrator entered on their user page or in their invitation.
- People who linked their ORCID account themselves with the Link my ORCID account button on the My profile → Security tab.
An ORCID iD that the person typed into their own profile does not allow them to sign in. A person who comes with an unknown ORCID iD is told that no account is set up with this iD. Disabled and locked accounts cannot sign in with ORCID either. Accounts with two-factor authentication turned on are still asked for the code.
The first ORCID sign-in and every account link are reported to the person by e-mail. Every sign-in is written to the audit log with its method.
Allowing a person to sign in with ORCID
- On the Administration → Users & roles screen, press the user's name.
- In the ORCID iD for signing in field on the Profile details card, enter the person's ORCID iD.
- Press Save next to the field.
To withdraw the permission, empty the field and save. An ORCID iD can be used for signing in on only one account. The ORCID sign-in: assigned label shows that an administrator gave the permission. The ORCID sign-in: verified label shows that the person has signed in with ORCID at least once or linked their account themselves.
How the person signs in with ORCID is described in Signing in with ORCID.
How-to
Configuring Institutional Sign-In
Turning on OpenID Connect sign-in with the institution's identity provider and setting the allowed e-mail domains and the opening of new accounts.
Institutional sign-in works with Microsoft Entra ID, Google Workspace, Keycloak or any other identity provider that supports OpenID Connect. It is off by default. While it is on, the Sign in with your institution account button appears on the sign-in screen, and the person signs in to the account that has the same e-mail address. Upper and lower case in the addresses do not matter.
Registering the application at the provider
- On the Administration → Site settings screen, open the Integrations tab.
- On the Institutional sign-in (OIDC) card, copy the Redirect URI address.
- Register a web application at the identity provider and add this address to the application's redirect URIs.
The openid, email and profile scopes are enough. In Microsoft Entra ID, add the optional email claim to the ID
token. If the provider does not send the e-mail address, nobody can sign in.
Settings on the card
- In the Issuer URL field, enter the provider's https address.
- Fill in the Client ID and Client secret fields.
- If you want only institutional addresses to sign in, enter the domains in the Allowed e-mail domains field, for
example
universite.edu.tr. - If you want accounts to be opened for institution staff who have no account, turn on the Create accounts for the allowed domains switch.
- If you want to change the name of the button on the sign-in screen, fill in the Turkish and English Button label fields.
- Press the card's Save button.
- Press Test the connection.
- If the test succeeds, turn on the Allow sign-in with the institution account switch.
- Press Save again.
As the issuer URL, enter the https address at which the provider publishes its /.well-known/openid-configuration
document. The table gives examples for common providers.
| Provider | Example issuer URL |
|---|---|
| Microsoft Entra ID | https://login.microsoftonline.com/<tenant ID>/v2.0 |
| Google Workspace | https://accounts.google.com |
| Keycloak | https://sso.kurum.edu.tr/realms/<realm> |
Test the connection reads the provider's document and signing keys. The client secret is tested only by a real sign-in. The test uses the saved settings, and the button is off while there are unsaved changes. If the test fails, the reason appears next to the button, for example that the provider names another address or that the document could not be fetched. The client secret is stored encrypted and is never shown again. If you leave the field empty and save, the stored secret is kept. The Remove the saved secret option deletes the secret. When you turn the switch off and save, the button disappears and institutional sign-in stops at once.
The line at the top of the card shows whether institutional sign-in is on and how many accounts are linked to an institution account.
Allowed domains
- If the list is filled in, only addresses in these domains sign in with an institution account.
- If the provider never reports whether the e-mail address is verified, addresses in these domains count as verified. Microsoft Entra ID does not send this information.
- If the provider explicitly reports that the address is not verified, sign-in is always refused.
- If the list is empty, any address that the provider calls verified can sign in.
Opening new accounts
Create accounts for the allowed domains is off by default. While it is off, only people who have an account in the system sign in. While it is on, a new person from an allowed domain gets a Registered researcher account with a verified e-mail address and no password. The account is opened even if the New account registration flag is off, and the person is asked to accept the privacy notice under KVKK (Türkiye's Personal Data Protection Law). You must enter at least one domain to turn this switch on.
Rules applied at sign-in
- Disabled and locked accounts cannot sign in.
- Accounts with two-factor authentication turned on are still asked for the code.
- An account whose e-mail address was never verified is activated by institutional sign-in. A password set before the address was proved is deleted, and the account's other sessions are closed. If the person wants a password, they set a new one with the Forgot your password? link on the sign-in screen.
- The first institutional sign-in of an account is reported to the person by e-mail.
- Every sign-in, opened account, refusal and error is written to the audit log with only a reason code.
Institution account link
At the first sign-in, the ID that the provider gives the person is stored in the account. The Institutional sign-in row on the Profile details card of the user page shows the date of the link.
A sign-in with the same address from another account at the provider is refused, because the institution may have given the address to someone else. If the person's account at the institution was re-created and you are sure it is the same person, press Remove the link on this row. The next institutional sign-in links the account again.
How the person signs in with their institution account is described in Signing in with Your Institution Account.
How-to
Configuring Automatic DOI Registration
Setting up the deposit account and the test mode so that an institution with a Crossref membership sends DOIs to Crossref automatically as records are published.
Automatic DOI registration is off by default. Turn it on once the institution has a Crossref membership and a deposit account. While it is on, every public record whose DOI starts with the institution's prefix is sent to Crossref automatically when it is published and when its metadata changes. The file that is sent is the same as the file downloaded with Download Crossref XML on the record screen.
Crossref details
- On the Administration → Site settings screen, open the Integrations tab.
- On the Crossref / DOI card, fill in the DOI prefix, Registrant, Depositor name and Depositor e-mail fields.
- Press the Save button under the ROR (organisation identifiers) card.
Crossref sends the processing result of every deposit to the depositor e-mail address.
Deposit account and test
- On the Automatic DOI registration (Crossref) card, fill in the Deposit login field. For role-based
accounts, the user name has the form
user/role. - Enter the password in the Deposit password field.
- Check that the Test mode switch is on.
- Turn on the Automatic DOI registration switch.
- Press the card's Save button.
- Publish a few records.
- On the record screen, check that the Crossref status is Sent.
- Check that a success result has arrived at the depositor e-mail address.
- Turn off the Test mode switch.
- Press the card's Save button again.
Test mode is on by default. In test mode, the files go to test.crossref.org and the DOIs are not really registered. When test mode is off, the files go to doi.crossref.org.
The password is stored encrypted and is never shown again. If you leave the field empty and save, the stored password is kept. The Remove the saved password option deletes the password. Automatic registration cannot be turned on before a DOI prefix is saved. When you save the DOI prefix in the form on the same tab, the card updates by itself. Unsaved changes on the card stay in place.
Deposit rules
- The same metadata is not sent twice.
- After test mode is turned off, a record goes to the live system at its next change or when it is sent by hand. Having been sent to the test system before does not prevent this.
- Edits made one after another within half a minute are combined into one deposit.
- Records harvested from DergiPark (Türkiye's national journal platform) are not sent, because DergiPark registers their DOIs.
- If Crossref cannot be reached or is busy, the deposit is retried at growing intervals. After the last attempt, the job stays on the System health → Background jobs tab and can be run again from there.
- If the user name or the password is refused, or if the record does not meet Crossref's rules, the deposit fails at once.
The status line at the top of the card shows the numbers of sent, waiting and failed records. The Recent errors list gives the cause of each error and the link to the record. The Crossref card on the record screen and the Send now button are explained in Automatic DOI Registration.
How-to
Defining Peer Review Processes
Describing the press's book peer review processes with the questions of DOAB's PRISM, publishing them on the public site and making them available to books.
The Peer review tab defines the review processes that the press's books go through before publication. Each process is described with the questions of DOAB's PRISM form. Book and chapter records select the process the record went through from this list.
DOAB accepts only books that independent external reviewers reviewed before publication, and it asks for the process to be stated on the press's website. The processes you save are published on the Peer review page of the public site and on each book's own page. This page opens only while at least one process is saved.
Adding a process
- On the Administration → Site settings screen, open the Peer review tab.
- Press Add a process.
- Fill in the Turkish and English Process name fields.
- Answer the Review object, Reviewer type, Anonymity, Review stage and Decision to publish questions.
- If you like, enter the minimum number of reviewers who review a book in the Number of reviewers field.
- If the review reports are published with the book, turn on the Review comments published switch.
- In the Turkish and English Description fields, describe how the process works, how the reviewers are chosen and how the decision is made.
- Press Save.
A new process starts with the values DOAB asks for. These values are the pre-publication stage, double-anonymised review and an external reviewer. DOAB receives the English name of the process. Separate the paragraphs of the description with an empty line.
The note under the title of each process shows whether the DOAB requirement is met. DOAB requires the review to take place before publication and by an external reviewer.
DOAB PRISM ID
After you define the process in DOAB, paste the ID that DOAB gives into the DOAB PRISM id field exactly as it is. The ID is added to the books in the DOAB export. You see whether the books are ready for DOAB on the DOAB readiness screen. Selecting the process for a book is described in Preparing a Book for DOAB, and the screen in DOAB Readiness.
Rules for processes
- You can define at most 20 processes.
- The process name must be written in at least one language.
- At least one option must be ticked for the Review object and Reviewer type questions.
- The number of reviewers can be between 1 and 10.
- The description can be at most 4000 characters in each language.
You can remove a process with the Remove process button. If the removed process is selected on a book, you have to select another process when you save that book's details.
Screens and settings
Site Settings Tabs
The nine tabs of the Site settings screen, the cards on each tab, how saving works and the integration cards.
The Administration → Site settings screen brings the site's identity, the workflow rules, the integrations and the feature flags together on nine tabs. Secret keys and passwords are stored encrypted and are not shown on any screen.

Tabs
| Tab | What it contains | Details |
|---|---|---|
| General | Institutional identity, theme colours and logo, search engines and sharing, contact details | Setting the Institutional Identity and Logo, Setting Search Engine and Sharing Defaults |
| Workflow | Review, revision and reminder periods, the retention period for deletions under KVKK (Türkiye's Personal Data Protection Law), operations alerts, catalogue and institutional content rules | Workflow Settings |
| Integrations | OAI-PMH, Crossref and DOI, ROR, automatic DOI registration and institutional sign-in | Configuring Automatic DOI Registration, Configuring Institutional Sign-In |
| Search | Suggestions while typing, synonym expansion and synonym groups | Configuring Search |
| Publisher and ISBN | The publisher certificate, the officers for the Ministry of Culture and Tourism, printers, legal deposit and ISBN reminders | Entering the Publisher Settings |
| Peer review | The peer review processes of the books | Defining Peer Review Processes |
| E-mail sending and the test e-mail | Configuring Outgoing E-mail | |
| ORCID | Sign-in with ORCID | Configuring ORCID Sign-In |
| Features | Feature flags | Feature Flags |
The open tab stays in the address bar. If you share the link, the screen opens on the same tab. While the screen is open, a link to another of its tabs opens that tab too, for example an ISBN reminder in the notifications.
Saving changes
The General, Workflow and Search tabs and the first three cards of the Integrations tab are one form. The Save button at the bottom of these tabs saves the changes you made on all of them together. If nothing changed, the screen shows the Nothing changed message.
The Automatic DOI registration (Crossref) and Institutional sign-in (OIDC) cards have their own Save button. The Publisher and ISBN, Peer review, E-mail and ORCID tabs are saved separately too. The switches on the Features tab take effect at once, without saving. If you cancel a switch that asks before turning off, or the change cannot be saved, the switch goes back to where it was.
Moving to another tab does not discard the unsaved changes of any tab. If you try to leave the screen with unsaved changes, the panel asks first.
If a field is invalid, nothing is saved, and the message at the bottom right lists the fields to correct. Every saved change is written to the audit log with its old and new value. Changes take effect on the site within 15 seconds.
Cards on the Integrations tab
- The OAI-PMH card has the Repository name and Administrator e-mail fields of the OAI-PMH repository. External indexes see these details in the OAI-PMH response. If the repository name is empty, the site name is used, and if the administrator e-mail is empty, the contact e-mail is used.
- The Crossref / DOI card holds the DOI prefix and the publisher details sent to Crossref.
- The ROR search in the institution form switch on the ROR (organisation identifiers) card is off by default. Once it is turned on and saved, the Search ROR button appears in the form of people who add and edit institutions. The server queries ROR's open interface and keeps the results in memory for six hours. The server must be able to reach api.ror.org. How to use the button is described in Searching ROR for an Institution.
- The Automatic DOI registration (Crossref) card is explained in Configuring Automatic DOI Registration.
- The Institutional sign-in (OIDC) card is explained in Configuring Institutional Sign-In.
Screens and settings
Workflow Settings
Review and revision periods, reminder days, the submission number prefix, the KVKK retention period, operations alerts and approval rules.
The Workflow tab of the Administration → Site settings screen has five cards. You save changes with the Save button at the bottom of the page.
Review and submission periods
| Field | Default | Effect |
|---|---|---|
| Review period (days) | 21 | The time a reviewer gets to write the report if the editor gives no other period in the invitation |
| Invitation response period (days) | 7 | The time a reviewer gets to answer the invitation if the editor gives no other period in the invitation |
| Reminder (days before the deadline) | 3 | How many days before the response and report deadlines the reviewer is reminded |
| Submission number prefix | JT | The prefix of the submission number, for example JT in the number JT-2026-00042 |
The report period can be 1 to 180 days, the response period and the reminder 1 to 60 days. These are the limits a reviewer invitation accepts. A period saved outside them before is pulled to the nearest limit in an invitation.
How review periods and reminders work is described in Reviewer Deadlines and Reminders.
The submission number consists of the prefix, the year and a five-digit sequence number. The sequence starts at 1 for each year and each prefix. When you save the prefix, it is changed to capital letters, and Ç, Ğ, İ, Ö, Ş and Ü are written as C, G, I, O, S and U. If you enter ÇOMÜ, the prefix becomes COMU. Characters other than letters of the Latin alphabet and digits are dropped. If no letter or digit is left, the prefix is not saved. Numbers already given stay the same when the prefix changes.
Revision, production and ODİS reminders
| Field | Default | Effect |
|---|---|---|
| Minor revision period (days) | 30 | The time an author gets for a minor revision if the editor chooses no other period with the decision |
| Major revision period (days) | 60 | The time an author gets for a major revision if the editor chooses no other period with the decision |
| Revision reminder (days before the due date) | 3 | How many days before the revision deadline the author gets one e-mail and one panel notification |
| Production task reminder (days before the due date) | 3 | How many days before a task's due date the person who took the task is reminded |
| ODİS upload reminder (days after the issue was published) | 14, 45 | How many days after an issue is published its journal's editors are reminded to upload it to ODİS, the upload system of TR Dizin (Türkiye's national journal index) |
Revision periods can be between 7 and 365 days. If you enter 0 for the revision or production task reminder, no reminder is sent. Separate the ODİS days with commas. You can enter at most 6 days, each between 1 and 365. If you leave the field empty, no ODİS reminder is sent. If a deadline is extended, a new reminder is sent for the new deadline.
KVKK deletion and retention
The Retention of files of rejected and withdrawn submissions (days) field is 730 days by default and cannot be less than 30 days. When an account is anonymised under KVKK (Türkiye's Personal Data Protection Law), the files of its rejected and withdrawn submissions that are past this period are deleted. Drafts that were never submitted are deleted with their files regardless of the period. The details are in Anonymising an Account.
Operations alerts
Every operations alert also goes by e-mail to the addresses in the Alert e-mail addresses field. Write one address per line. Up to 10 addresses can be given. After saving the addresses, you can send a test alert with the Send a test alert button.
The Alert threshold (actions) field is 5 by default and the Window (minutes) field is 10 minutes by default. An alert is created when, within the window, more records than the threshold are unpublished, retracted or deleted after having been published. Entering 0 as the threshold turns the alert off. The alerts are explained in Operations Alerts.
Catalogue and institutional content rules
| Switch | Default | Effect |
|---|---|---|
| Journal issues need a date to be published | On | An issue cannot be published until its volume, number, year and publication date are entered. Turn it off to publish old issues whose date is unknown. |
| Institutional content is published after review | Off | Institutional content is published only from review, and the person who sent it to review cannot publish it. |
| Catalogue records are published after an editor's approval | Off | A catalogue record is published only from review and only by a catalogue editor other than the one who sent it to review. |
The last two rules are explained in Four-Eyes Principle. Releasing an accepted submission from production to publication, the DergiPark harvest and bulk import are not affected by the catalogue rule.
Screens and settings
Feature Flags
The default value of each flag on the Features tab of the site settings, its effect when it is on and off, and the rules for changing it.
Feature flags are on the Administration → Site settings → Features tab. When you change a flag, the change takes effect at once without saving and is written to the audit log. The screen asks for confirmation when you turn a flag off and when you turn the Mandatory two-factor authentication for privileged roles flag on. Under each flag, its code, its default value and the time of its last change are shown.
Flags
| Flag | Default | Effect |
|---|---|---|
| New account registration | On | When off, the registration page does not open new accounts. Accounts can still be opened by invitation. The option of institutional sign-in to open accounts is not affected by this flag either. |
| New submissions | On | When off, authors cannot start new submissions. Submissions in progress continue. |
| Newsletter sign-up (public site) | On | When off, the newsletter sign-up form on the public site does not work. |
| Contact form | On | When off, the contact form on the public site does not work. |
| File uploads | On | When off, no file can be uploaded from any screen. Files that are already uploaded still open. |
| OAI-PMH endpoint (/oai) | On | When off, the /oai address does not answer and external indexes cannot harvest the metadata. |
| Crossref XML export | On | When off, Crossref XML cannot be downloaded from the record screen. Automatic DOI registration does not depend on this flag. |
| Mandatory two-factor authentication for privileged roles | Off | When on, administrator and editor roles work only on accounts with two-factor authentication turned on. |
| Reading counts and most-read lists | On | Shows reading counts and most-read lists on the public site. When off, none of them appear. |
| Show TR Dizin data | Off | When on, the journal record, citation counts and author links read from the open data of TR Dizin (Türkiye's national journal index) appear. |
| Help pages open to everyone | On | When off, only signed-in users see the help pages. |
File uploads
While there is a storage problem, turn the File uploads flag off until the problem is fixed. The symptoms and the steps are in File uploads fail.
Mandatory two-factor authentication
Before you turn the flag on, set up your own two-factor authentication and tell the users in these roles. The roles covered and the setup are in Requiring Two-Factor Authentication.
Reading counts
While the flag is on, view and download counts appear on the publication page. The home page and the journal page have a most-read list for the last 12 months, and publication lists can be sorted by most read. The counts leave out bots and repeats on the same day. IP addresses are not kept. If the counts are lower than expected, see Reading counts are missing or look too low.
Crossref XML
While the Crossref XML export flag is off, the XML download on the record screen does not work. The download itself is described in Downloading Crossref XML, and automatic deposits in Configuring Automatic DOI Registration.
TR Dizin data
While the flag is on, the server reads the open data of TR Dizin several times a day. The journals' TR Dizin records are found by ISSN, the articles' TR Dizin citation counts by DOI and the authors' TR Dizin profiles by ORCID. The citation count appears on the article page and the TR Dizin link on the author page. In journal management, the TR Dizin tab holds the journal's record. The server must be able to reach search.trdizin.gov.tr.
Help pages
While the Help pages open to everyone flag is off, a visitor who opens a help page is sent to the sign-in page. After signing in, the visitor returns to the same help page. Search engines never index the help pages.
Troubleshooting
File uploads fail
If uploads fail on every screen, checking the file storage and turning file uploads off until the problem is fixed.
If uploads fail on every screen, check the file storage first. Turn file uploads off while the storage problem lasts.
- On the Administration → System health screen, open the Health tab.
- Look at the File storage tile.
- If the tile says Problem, turn off the File uploads flag on the Site settings → Features tab.
- Repair the file storage together with the team that runs the installation.
- When the problem is fixed, turn the File uploads flag back on.
While the flag is off, no file can be uploaded from any screen, and files that are already uploaded still open. Every change to the flag is written to the audit log.
Files are waiting for the scan
If the Virus scanner tile says Problem, uploads are accepted, but the files wait for the virus scan and nobody can open them. Scan jobs are retried in the background. A scan job that has used up its last attempt is queued again by itself within 15 minutes, so the files are scanned without anything done by hand once the scanner works again. The symptoms on the file's own screen are described in A file stays in scanning or quarantine.
The storage is open to anonymous access
If the File storage tile says WARNING: the bucket allows anonymous access, the file storage is open to anonymous access. In that case, close the storage at once together with the team that runs the installation. The details of the health tab are in System Health Screen.
Feature
E-mail and Templates
Setting up e-mail sending and editing the templates of the e-mails the system sends.
The server that sends the system's e-mails is set up on the E-mail tab of the Administration → Site settings screen. The Turkish and English templates of every e-mail are edited on the E-mail templates screen.
E-mails carry no submission, report or message content. They only link to the panel. Panel notifications are created even without e-mail.
In an installation where e-mail sending is turned off, the e-mails wait on the E-mail outbox tab of the System health screen. System administrators take the verification, invitation and password links from there and pass them on to the people concerned.
How-to
Configuring Outgoing E-mail
Setting up the SMTP server that sends the system's e-mails from the panel, trying it with a test e-mail and turning sending on.
You set up e-mail sending on the E-mail tab of the Administration → Site settings screen. Changes take effect within a few seconds, both in the panel and in the background jobs, without a restart.
Server settings
- Fill in the SMTP server, Port and Connection security fields.
- If the server requires authentication, fill in the User name and Password fields.
- Fill in the Sender address field.
- If you like, fill in the Sender name, Reply-to address and Timeout (seconds) fields too.
- Turn on the Send e-mails switch.
- Press Save.
Port 587 is usually used for STARTTLS and port 465 for SSL/TLS. Select Unencrypted (internal network only) only for a relay on the institution's internal network. When you change the connection security, the well-known ports change with it, while a port you typed yourself is kept. The timeout can be between 5 and 120 seconds. While sending is on, the server and the sender address are required.
The password is stored encrypted and is never shown again. The screen only shows that a password is stored. If you leave the password field empty and save, the stored password is kept. The Remove the stored password option deletes the password.
Test e-mail
- On the Test e-mail card, type the address in the Recipient field. The field comes filled in with your own address.
- Press Send test e-mail.
The test uses the saved settings and works even while sending is off. You cannot run a test while there are unsaved changes. The result appears on the screen at once. If something fails, the screen gives the reason without showing the password, for example that authentication was refused or that no connection could be made. If you send many tests in a short time, the screen asks you to wait a little.
Status line
The status line at the top of the tab shows whether sending is on and which settings are in use. If no settings are saved in the panel, the installation's settings are used, and the panel's settings take over the first time you save the form. The line also shows the result of the last test and the e-mails waiting in the outbox. If the line says that the stored password cannot be decrypted, enter the password again.
The E-mail tile on the System health → Health tab gives the same information. Settings and tests are written to the audit log without the password.
After turning sending on
While sending is off, e-mails are not sent and wait on the System health → E-mail outbox tab. After you turn sending on, send the waiting e-mails with the Resend button on their rows. The steps are in Forwarding a Link from the E-mail Outbox.
Set up the SPF, DKIM and DMARC records for the sender domain as your e-mail provider instructs. In-panel notifications are created even while e-mail sending is off.
How-to
Editing an E-mail Template
Changing the Turkish or English subject and text of an e-mail the system sends, previewing it, turning it off or resetting it to the default.
The Turkish and English templates of every e-mail the system sends are edited separately.
- Find the template on the Administration → E-mail templates screen.
- On the template's row, press Edit.
- On the language tab of the window, select Turkish or English.
- Edit the Subject and Text fields.
- Press Preview and check the result.
- Press Save.
Save saves every language you changed in one go. A language tab with unsaved changes shows a dot. If a subject or text is empty, the window opens that language's tab and marks the field. You can also open the window directly in one language by pressing the TR or EN label on the row.
While there are unsaved changes, the window closes only through its buttons. Close asks before it drops the changes.
Text and variables
The text is plain text. Variables are written as {{ name }} and appear in the Variables list next
to the window. The preview puts sample values in place of the variables.
When you delete a variable of the default text, the window lists the variables that are not used. Above all, do not
delete the {{ link }} variable, because the e-mails take the person to the panel through this link.
E-mails must not carry confidential content. Do not add the text of a submission, a review report or a message to a template. A footer with the site name and address is added to the end of every e-mail automatically.
Turning an e-mail off
If you turn off the Send this e-mail switch and save, no e-mail is sent for that event in that language. The in-panel notification is still created. In the list, Sending off appears next to the label of this language.
Resetting to the default
On a customised template, the Reset to default button appears at the bottom of the window. The button deletes the customisation on the open language tab and brings back the default text. If you had turned sending off, it is turned back on as well.
Saving and resetting to the default are written to the audit log. The parts of the screen are explained in E-mail Templates.
How-to
Forwarding a Link from the E-mail Outbox
Taking the link out of an e-mail that waits in the outbox while sending is off, passing it to the person, and sending the waiting e-mails once sending is on.
In an installation where e-mail sending is off, the system's e-mails are not sent and wait on the E-mail outbox tab with the status Not sent (in outbox). You take the verification, invitation and password links from these e-mails and pass them to the person yourself. For example, the password link of a new reviewer whom an editor invited by e-mail address waits here too.
- On the Administration → System health screen, open the E-mail outbox tab.
- In the Status list, select Not sent (in outbox).
- On the row of the e-mail to the person's address, press View content.
- Copy the link from the text in the window.
- Pass the link to the person through a secure channel.
Viewing an e-mail's content is written to the audit log, because the content can contain one-time links. The e-mail's text also states how long the link is valid. Instead of an expired link, create a new One-time password link on the person's user page.
In-panel notifications are created without e-mail too. If the person can sign in to the panel, they see their notifications under the bell.
When sending is turned on
After you turn e-mail sending on, send each waiting e-mail with the Resend button on its row. If sending is still off, the screen says that the e-mail will stay in the outbox. Setting up sending is described in Configuring Outgoing E-mail.
Screens and settings
E-mail Templates
The rows, status labels and editing window of the screen that lists the Turkish and English templates of the e-mails the system sends.
The Administration → E-mail templates screen lists the template of every e-mail the system sends. Each template keeps its Turkish and English text separately. E-mails carry no confidential content, only a link to the panel.
List
Each row shows the template's name, code and Turkish subject. The search box searches the templates' names, codes and subjects. Next to the TR and EN labels on a row, the status of that language is shown.
| Label | Meaning |
|---|---|
| Default | The system's default text is in use. |
| Customised | The text was changed in this installation. |
| Sending off | No e-mail is sent in this language, and the in-panel notification continues. |
Editing window
The Edit button opens the Edit template window.
| Part | What it is for |
|---|---|
| Language tabs | Switch between the Turkish and English texts |
| Subject | The e-mail's subject, at most 300 characters |
| Text | Plain text, at most 20,000 characters |
| Send this e-mail | When off, no e-mail is sent for this event in this language |
| Variables | The variables you can use in the text |
| Preview | Shows the text with sample values when you press Preview |
| Reset to default | Appears only on a customised template and deletes the customisation |
If a variable of the default text is not used, the window says so with a warning. The steps are in Editing an E-mail Template.
Alert templates
The templates whose names start with "Operations alert" and "Security alert" create panel notifications for system administrators. If alert addresses are set in the site settings, the same text goes to these addresses by e-mail. No e-mail goes to the system administrators' own addresses. These alerts are explained in Operations Alerts.
Feature
Reports
Following publication, submission and process indicators and downloading reports as CSV files.
Reports are on the Administration → Reports screen. The screen shows the submission flow, publications, access counts, searches on the public site and in the help, and overdue work on separate tabs.
Personal data is masked in downloaded CSV files. Downloading without masking requires a separate permission, which only the System administrator role has. Every download is written to the audit log.
Screens and settings
Reports Screen
The indicators and filters on the submission flow, publications, access, search, help and overdue tabs, and the CSV downloads with masked personal data.
The Administration → Reports screen shows publication, submission, access and search indicators on tabs. The screen is open to people whose report permission covers the whole platform. An Editor-in-chief whose role was granted for a single journal does not see this screen.

Tabs
| Tab | What it shows |
|---|---|
| Submission flow | Submitted, in-progress, accepted and rejected submissions, the acceptance rate, the median time to the first and to the final decision, and the breakdown by month, status, type and journal |
| Publications | Published works, works without a category, and the breakdown by type, access status, publication year, language and category |
| Access | View and download counts, a daily series and the most accessed publications |
| Search | The number of searches on the public site, searches without results and the most frequent searches |
| Help | Searches made in the help centre, words without results, the readers' answers and notes on topics, and topics that are due for review |
| Overdue | Overdue reviewer invitations, review reports and revisions, stalled submissions and late production tasks |
The acceptance rate is calculated from the submissions that received a decision. Access counts leave out bots, and IP addresses are not stored. Searches and help queries are counted without keeping user or IP details. The panel's global search does not count as a help search. The Table button of some charts shows the same data as a table.
The Stalled submissions list shows submissions that are submitted, in screening or have a submitted revision and have not been acted on for more than 14 days. Submissions you are an author of do not appear on the Overdue tab.
Filters
| Filter | Tabs where it appears |
|---|---|
| Period | Submission flow, Access, Search and Help |
| Publication year range | Publications |
| Journal | Submission flow and Overdue |
| Publication type | Submission flow, Publications and Access |
The Period list has the options All time, Last 30 days, Last 90 days, This year and Custom range. The filters stay in the address bar.
CSV download
| Tab | Button |
|---|---|
| Submission flow | Download CSV |
| Overdue | Overdue items (CSV) |
| Publications | Download CSV and People (CSV) |
| Access | Download CSV |
The downloaded file follows the filters on the screen. The Unit manager and System administrator roles can download reports. Personal data in the files is masked. Only the System administrator role has the permission to download unmasked data. The Personal data is masked note under the button shows that the file will be masked. Names and e-mail addresses on the Overdue tab are masked on the screen by the same rule.
Every download is written to the audit log. An attempt to open a report without permission is written to the audit log too.
Feature
Audit Log and KVKK Requests
Reviewing the audit log of important actions and settling personal data requests.
Actions such as publishing, retracting, role changes and setting changes are written to the audit log on the Audit log screen. The audit log cannot be changed or deleted. The rows that match the screen's filters can be downloaded as a CSV file.
The requests that users open for a copy, a correction or the deletion of their data are settled on the Data requests (KVKK) screen. For a deletion request, the account is anonymised. Audit records, decisions and published authorship details are kept because the law requires them to be retained.
Users with the Auditor role see the audit log and the requests under KVKK (Türkiye's Personal Data Protection Law) read-only.
How-to
Resolving a KVKK Data Request
Taking up a user's request for a copy, a correction or the deletion of their data, doing what it asks and telling the person the outcome.
Users open a request under KVKK (Türkiye's Personal Data Protection Law) on the My profile → Privacy & KVKK tab. The requests arrive on the Administration → Data requests (KVKK) screen. Open requests are also counted on the Open data requests card of the Overview screen.
- To show that you are handling the request, press Start review on its row.
- Do what the request asks, depending on its type. What to do for each type is described below.
- Press Resolve on the row.
- In the Outcome list, select Completed or Rejected.
- In the Explanation (shown to the person) field, write what you did or why you rejected the request, in at least 5 characters.
- Press Resolve in the window.
The explanation appears in the request history on the person's Privacy & KVKK tab. Every status change of the request is written to the audit log, and the log keeps who resolved the request and when.
Steps for each request type
| Request | What to do |
|---|---|
| A copy of my data | Download the file with the Download data (JSON) button on the row and pass it to the person through a secure channel. |
| Correction of my data | Make the correction the person describes in their note. You change the name and e-mail address on the user page. |
| Deletion of my account and data | Anonymise the account from the user page, then resolve the request. |
The Open user link in the resolution window of a deletion request opens the user's page. Anonymisation is explained in Anonymising an Account, and changing the name and e-mail address in Managing User Accounts.
Data copy file
The Download data (JSON) button downloads the account's personal data in a single JSON file. The file contains the following.
- account and profile details, roles and sessions
- KVKK requests, notifications and saved publications
- the newsletter subscription and contact messages
- the person's submissions, the submissions they co-authored and their review invitations
- the messages the person sent on submissions, their editor assignments and their production comments
- the linked catalogue person, the account's events and the actions the person took on other records
Passwords, one-time links and two-factor authentication keys are not in the file. E-mail texts and the texts of review reports are not included either, so a reviewer's later addendum to a submitted report is listed without its text. An action shows only its name, its time and the type of record. The changed values and the reason for the action are not in the file. Other people's messages and comments are not in it either.
The account's events, the actions, the messages, the editor assignments and the comments are limited to the newest
2000 rows. If a list was shortened, the export.truncated field at the top of the file gives the list's name, the
number of rows in the file and the total number of rows. When the field is empty, the file is complete.
Every download is written to the audit log. The button appears only on copy requests that were not rejected.
How-to
Anonymising an Account
Permanently deleting an account's personal data for a KVKK deletion request and knowing which records are kept because the law requires them.
Anonymisation permanently deletes an account's personal data and cannot be undone. Audit records, decisions and published authorship are kept because the law requires them. You carry out a deletion request under KVKK (Türkiye's Personal Data Protection Law) with this action.
- On the Administration → Data requests (KVKK) screen, press the e-mail address on the row of the deletion request. The user's page opens.
- On the Irreversible actions card, press KVKK: anonymise account.
- In the Reason (e.g. KVKK request reference) field, enter the reason, for example the number of the request.
- Type the person's e-mail address as the window asks.
- Press KVKK: anonymise account in the window.
- If the person wrote a review report in the last five years, confirm again in the second window that opens.
- Resolve the KVKK request. The steps are in Resolving a KVKK Data Request.
Deleted data
- The name, e-mail, ORCID iD and profile details are deleted, all roles are removed and the account can never be used again.
- The person's sessions are closed and their newsletter subscription is deleted.
- In their outbox entries, the address and the content are hidden. Their waiting e-mails are not sent.
- Panel notifications and saved publications are deleted.
- If the catalogue person linked to the account has no public work, the person's e-mail and ORCID iD are deleted. If they have a public work, the catalogue record stays as it is.
- The files of rejected or withdrawn submissions are deleted if the decision or withdrawal date is past the retention period.
- Drafts that were never submitted are deleted with their files and cannot be restored. This covers the drafts the person started, the drafts an editor started on the person's behalf and the drafts in the person's trash.
- The person's roles in the workflow are released. Open reviewer invitations are cancelled, editor assignments end, and the person is no longer in charge of open production jobs and tasks. This work stays with the submission's editors and the production coordinators. The person gets no e-mail about it, and the submission's timeline shows the change.
The retention period is in the Retention of files of rejected and withdrawn submissions (days) field on the Site settings → Workflow tab and is 730 days by default.
Retained records
The following are not deleted, because the law requires them to be kept.
- audit records, decisions and review reports
- published authorship and published works
- the files of submissions that are still within the retention period and of all other submissions that were sent
- if the person is an editor, the drafts they started on behalf of other authors, because these drafts belong to those authors
The user.anonymize row in the audit log shows in numbers what was deleted and what was kept and why.
Keeping review reports
TR Dizin (Türkiye's national citation index) expects review reports to be kept for five years. After anonymisation, the person's name no longer appears in the referee dossiers. That is why the system asks for a second confirmation if the person wrote a review report in the last five years. If needed, first download the referee dossiers of the submissions concerned with the Referee dossier (PDF) button on the editor screen.
Your own account
You cannot anonymise your own account. The button does not appear on your own page. Only people with permission to manage KVKK requests see the Irreversible actions card.
Screens and settings
Audit Log
The filters, rows and CSV export of the unalterable log that shows who carried out important actions, when and on which record.
The Administration → Audit log screen is the unalterable record of critical changes. Each row shows who carried out an action, when and on which record, and what changed. The entries cannot be changed or deleted in the database either, and the table cannot be emptied in one go. When the application connects to the database with a role that does not own the tables, it cannot switch this protection off itself. The team that runs the installation sets up that connection.
Actions written to the log
Changes to roles, settings, feature flags and templates, exports, anonymisation and viewing the content of an e-mail are written to the audit log. Publishing, retractions, decisions, sign-ins and account changes are recorded here too.
Filters
| Filter | What it does |
|---|---|
| Action (prefix) | Searches by the start of the action code, for example user., role.grant, publication.publish or submission.decision |
| Record type | Filters by record type, for example user or publication |
| Record ID | Shows the rows of a single record |
| User ID | Shows the actions of one user |
| From and To | Limit the rows to a date range |
Pressing the ID in the Record column narrows the list to that record. Pressing the ID in the Actor column narrows it to that user's actions. The Clear filters button removes the filters. The History of this record button on a user page opens this screen with the rows about that account.
Rows
| Column | What it shows |
|---|---|
| When | The time of the action |
| Action | The action code |
| Record | The type and ID of the record |
| Actor | The ID and role of whoever carried out the action, or System for the system's own actions |
The arrow at the end of a row opens the details. The details show the Reason, the Before and After values in the Changes table and the ID of the request that carried out the action.
CSV export
The Export CSV button downloads the rows that match the filters on the screen as a CSV file. The file contains the time, the actor's ID and role, the action, the record type, the record ID and the request ID. The before and after values and the reason are not included. A file contains at most 50,000 rows. Every export is written to the audit log too.
Screens and settings
KVKK Data Requests
The filter, columns, buttons and read-only view of the screen that lists the users' requests about their personal data with their statuses.
The Administration → Data requests (KVKK) screen lists the requests under KVKK (Türkiye's Personal Data Protection Law) that users open on the My profile → Privacy & KVKK tab. The newest request is at the top.
Request types
| Type | What the person asks for |
|---|---|
| A copy of my data | A copy of the personal data in their account |
| Correction of my data | The correction of some of their data |
| Deletion of my account and data | The deletion of their account and data |
A person cannot open a second request of the same type. They wait until the earlier request is resolved.
Statuses
The Status list filters the requests by status.
| Status | Meaning |
|---|---|
| Received | The request is new. |
| In review | The request has been taken into review. |
| Completed | The request was carried out. |
| Rejected | The request was rejected with a reason. |
Columns and buttons
| Column | What it shows |
|---|---|
| Person | The person's e-mail address and note |
| Request | The type of the request |
| Status | The status of the request and the explanation of the outcome |
| Received | When the request arrived |
Pressing the person's address opens the user page. A row has these buttons.
- Details shows the person's note, the explanation of the outcome and who resolved the request and when.
- Download data (JSON) downloads the account's data as a JSON file on copy requests.
- Start review takes a new request into review.
- Resolve opens the window for resolving the request.
The steps for a request are in Resolving a KVKK Data Request.
Read-only view
Someone with the Auditor role can list the requests and examine them with Details. They cannot take a request into review, resolve it, download a data copy or anonymise an account. The note at the top of the screen points this out.
Feature
System Health
Following the background jobs, the e-mail outbox and the health of the system.
The Administration → System health screen shows the health of the application and of the services it depends on, the background jobs and the e-mail outbox. A failed or stopped job is retried from here, and an e-mail that could not be sent is sent again.
The daily check starts with the Administration cards on the Overview screen. If many records are unpublished within a short time, an account is locked or a task fails, the system administrators receive an operations alert.
How-to
Monitoring System Health
Starting the daily check from the Overview cards and reviewing the health information, the failed background jobs and the waiting e-mails.
Start the daily check from the Administration cards on the Overview screen. The cards count the system status, the failed background jobs, the waiting e-mails, the open data requests under KVKK (Türkiye's Personal Data Protection Law) and the unverified accounts. Each card opens the screen it refers to. The other parts of the screen are described in Overview.
Health check
- On the Administration → System health screen, open the Health tab.
- Look for a component that says Problem in the tiles at the top.
- In the Scheduled tasks table, check the tasks whose result was a failure.
The information is read when the tab opens. To see the current state, press Refresh.
The File storage tile also checks that the file storage is closed to the public. The system tries to list the storage and read a file without credentials and expects both attempts to be refused. If the tile says WARNING: the bucket allows anonymous access, close the storage at once together with the team that runs the installation.
Failed background jobs
- Open the Background jobs tab.
- In the Status list, select Failed (will retry) or Stopped.
- Read the cause of the error in the Last error column.
- If the cause has been fixed, press Retry on the job's row.
If the same job is already waiting in the queue again or running, the stopped job is not retried and the screen says so. You need not do anything then, because the job will run anyway.
The number next to the tab shows the failed jobs that will be retried. You can cancel a job that is no longer needed with the Cancel button. A cancelled job is not run and moves to the Stopped status. It can be retried later if needed.
Waiting e-mails
The number next to the E-mail outbox tab shows the waiting e-mails. The row of an e-mail with the Failed status shows the error text. After you fix the e-mail settings, send the e-mail again with the Resend button. If sending is off, you pass the links on by hand. The steps are in Forwarding a Link from the E-mail Outbox.
The details of the tabs are in System Health Screen. The warnings that go to system administrators automatically are explained in Operations Alerts.
Screens and settings
System Health Screen
The components, statuses, columns and buttons shown on the health, background jobs and e-mail outbox tabs.
The Administration → System health screen shows the health of the application and the services it depends on, the background jobs and the e-mail outbox on three tabs. The Refresh button at the top right reads the information on the open tab again.
Health
| Tile | What it shows |
|---|---|
| Database | Whether the database works, and the database revision |
| File storage | Whether the file storage works and whether anonymous access to it is closed |
| Virus scanner | Whether the virus scanner works, and how it runs |
| Whether sending is on or off, the server, the source of the settings and the number of waiting or failed e-mails |
Below the tiles are these cards.
- The Job queue card counts the jobs by status. Pressing a number opens the Background jobs tab with that status. If jobs are waiting in the queue, the card says how long the oldest job has been waiting.
- The Application version card shows the application version, the database revision, the environment and the type of file storage.
- The Scheduled tasks table shows the last run time and the result of each scheduled task. If a task failed, the error text appears too.
- The Additional checks card shows the embargo and licence check. It counts expired embargoes, expired licences, open records without a licence and embargoes that end within 30 days.
Background jobs
| Status | Meaning |
|---|---|
| Queued | The job is waiting for its run time. |
| Running | The job is running now. |
| Done | The job has finished. Finished jobs are removed from the list after 14 days. |
| Failed (will retry) | The job failed or was interrupted, and will be retried at growing intervals. |
| Stopped | The job stopped after its last attempt, failed with an error that retrying cannot fix, or an administrator cancelled it. |
| Column | What it shows |
|---|---|
| # | The job's number |
| Job type | The type of job, for example send_email or ops_alert |
| Status | The job's status |
| Attempts | The number of attempts made and allowed |
| Run at | When the job will run or when it finished |
| Last error | The error text of the last attempt |
Long jobs do not hold up short ones. Only one DergiPark harvest or TR Dizin refresh job runs at a time, and short jobs such as e-mails and virus scans still run at once.
If the server stops unexpectedly, the job running on it is interrupted. Such a job is retried a few minutes later, and
the Last error column shows worker lost while running. Each interrupted run counts as an attempt. A job
that has used up its attempts moves to Stopped. A job that cannot finish while the server restarts
as planned goes back to the queue without counting the attempt.
The Retry button appears on failed and stopped jobs. It resets the number of attempts and puts the job back in the queue. If the same job is already waiting in the queue or running, the button does not queue a stopped job a second time, and the screen says so. The Cancel button appears on queued and failed jobs. Retries and cancellations are written to the audit log. In error texts, e-mail addresses, passwords and keys are masked, while the type of the error stays visible.
E-mail outbox
The note at the top of the tab says whether e-mail sending is on or off. If you have permission to manage the site settings, the E-mail settings link in the note opens the e-mail settings.
| Status | Meaning |
|---|---|
| Pending | The e-mail is waiting to be sent. |
| Sent | The e-mail has left the server. |
| Failed | Sending failed, and the row shows the error text. |
| Not sent (in outbox) | The e-mail was created while sending was off and is waiting in the outbox. |
The rows show the e-mail's subject and template code, the recipient, the status and the date. The View content button shows the e-mail's recipient, subject, template and text, and viewing it is written to the audit log. The Resend button appears on e-mails that were not sent and puts the e-mail back in the queue.
If the mail server does not answer or reports a temporary error, the e-mail is retried by itself at growing intervals for about an hour. The same happens when the server does not accept the user name, the password or the sender address. That is a setting to fix, and if it is fixed within that hour the waiting e-mails go out by themselves. If the server refuses the recipient or the e-mail itself for good, the e-mail is not retried. A final refusal has a reply code that starts with 5, and the code shows in the row's error text. Once you have fixed the cause, send the e-mail again with the Resend button.
The steps of the daily check are in Monitoring System Health.
Concept
Operations Alerts
The warnings that go to system administrators and the alert addresses after unusual unpublishing, when an account is locked and when a task, a harvest or a background job fails.
Some events can point to a fault or an attack. When they happen, JournTech sends a panel notification to all active system administrators. The notification appears under the bell in the top bar and on the Notifications page. The same warning goes by e-mail to the addresses in the Alert e-mail addresses field. If Telegram is set up for the installation, the warning is sent to Telegram too. The warning is also written to the application log.
Events that create an alert
| Event | Frequency limit |
|---|---|
| Many catalogue records or journal issues unpublished, records retracted or previously published records deleted within a short time | One alert per window |
| An account locked after repeated failed sign-ins | At most one alert per account per hour |
| Many accounts locked within one hour | After 10 account alerts, one combined alert for that hour |
| A periodic background task failing | At most one alert per task per hour |
| The ISBN range message not refreshed for more than three weeks | One alert a day until it is refreshed |
| A harvest from DergiPark (Türkiye's national journal platform) failing | At most one alert per journal per hour |
| A thesis harvest run failing | At most one alert per hour |
| A removal check started by the system not finding many theses on the repository's list | At most one alert per hour |
| Background jobs failing after all their attempts, or 50 jobs waiting for more than 30 minutes | At most one alert per hour |
| A test alert sent from the settings | At most one alert per minute |
The alert about failed background jobs counts every job that failed since the previous such alert. Jobs that fail before the hour is up therefore appear in the next alert.
Alert e-mail addresses
The addresses are on the Operations alerts card on the Site settings → Workflow tab. Write one address per line and press Save. Up to 10 addresses can be given. The IT department's shared address can go here. System administrators whose own addresses are not on this list see the alerts in the panel only.
Alert e-mails are written in the installation's default language and sent with the SMTP settings of the E-mail tab. While e-mail delivery is off, they are not sent and wait on the System health → E-mail outbox tab. Alert e-mails that were sent appear on this tab too.
Test alert
After saving the addresses, press Send a test alert below the address field. The test alert takes the same path as a real alert. The system administrators get a panel notification and the saved addresses get an e-mail. The button does not work while there is an unsaved change. At most one test alert can be sent per minute. Every test is written to the audit log.
Setting the unpublishing alert
The threshold and the window are in the Mass take-down alert part of the same card. More actions than the threshold within the window create an alert. The default threshold is 5 actions, and the default window is 10 minutes. Entering 0 as the threshold turns the alert off. Deleting a record that was never published does not count.
Alert content
Alert texts carry only IDs, counts, task names and journal names. They contain no e-mail addresses, passwords, codes or keys.
The link in an account lock alert opens the account's user page. If the password was right and the two-factor authentication codes were wrong, the alert says so separately. The locked-out person is told by e-mail too. If the attempts did not come from the person, look into the account and disable it if needed. The steps are in Managing User Accounts.
The link in an unpublishing alert opens the audit log. If the actions were not expected, check the account that carried them out. The audit log is explained in Audit Log.
Alert templates and records
The notification and e-mail texts are the templates on the E-mail templates screen whose names start with
"Operations alert" and "Security alert". If a template's e-mail is switched off, that alert does not go to the
addresses, but the panel notification still goes out. Every alert that is sent has an ops_alert job in the
System health → Background jobs list.
Monitoring systems
The institution's monitoring system (Prometheus, Zabbix or similar) can read JournTech's health, error rate and response
time measurements at the /metrics address. This address opens when an access key is set during installation, and it
answers only requests that send this key. The team that runs the installation sets the key. The server's disk use and
the certificate's validity are measured by the monitoring system's own tools.