How fields in the Composer UI map to ANS
Admin users have the option to configure how and where available form fields appear in the Composer editor. You can control the availability of these fields from Composer Settings under ANS Meta Field Configuration. You can configure each of these fields and move them to either the Planning or Meta tab in the Composer editor.Â
The the following table outlines each available field, what it means, and how it corresponds to ANS (Arc Native Specification) in the resulting JSON file for Composer stories.
FIELD NAME/TYPE | ANS | DESCRIPTION | CONFIGURATION OPTIONS |
---|---|---|---|
Address Compound field (combo short and long text fields) | address | The physical postal address of the story | → Required to publish |
Author Compound field - Searchable picklist (against Authors) → Add me →Add guest | credits.by.name | The author(s) of the current story | Planning |
Budget Line Long text field | planning.budget_line | Internal budget line for story | Planning |
Comments Toggles | comments.allow_comments comments.display_comments comments.moderation_required | A group of settings that enable/disable comments on the story | → Required to publish |
Copyright Optional picklist + free entry | copyright | The copyright details for the story | → Required to publish → Picklist → Allow for free text entry on picklist |
Corrections Compound field (add correction type and free text entry) | corrections | A way to make note changes to the story | → Required to publish |
Created date Read only | created_date | The timestamp when the story was first saved | → Required to publish |
Description Long text field | description | (none) | → Required to publish → Max characters |
Display date Read only | display_date | The timestamp that overrides the last publish date | → Required to publish |
Distributor Compound field | distributor | The distributor of the current story | → Required to publish |
Editor note Long text field | editor_note | (none) | → Required to publish → Max characters |
First publish date Read only | first_publish_date | The timestamp when the story was published the very first time | → Required to publish |
Kickers/labels Compound field | label | Kickers/labels that apply to the story | → Required to publish → Has its own section in Composer Settings to configure → Picklist or free text entry |
Language Optional picklist + free entry | language | The language code for the story | → Required to publish → Picklist → Allow for free text entry on picklist |
Last updated Read only | last_updated_date | The timestamp when the story was last saved | → Required to publish |
Latitude & longitude Compound field (two number entries) | geo | The latitude and longitude details for a story location | → Required to publish |
Location description Long text field | location | A description of the location, useful if a full address or lat/long specification is overkill | → Required to publish |
Media planning Non-searchable picklist | planning. scheduling. will_have_[image, video, gallery] (Long line broken up, but is all one string) | The ability to set what type of content will be in the story | Planning |
Paywall status Optional picklist + free entry | content_restrictions.content_code | Any content restrictions code that should apply to this story | → Required to publish → Picklist → Allow for free text entry on picklist |
Planned character count Number field | planning.story_length.character_count_planned | The planned character count of the story | Planning |
Planned inch count Number field | planning.story_length.inch_count_planned | The planned inch count of the story | Planning |
Planned line count Number field | planning.story_length.line_count_planned | The planned line count of the story | Planning |
Planned ready time Date field | planning.scheduling.planned_publish_date | The date the author plans on the story being published | Planning |
Planned word count Number field | planning.story_length.word_count_planned | The planned word count of the story | Planning |
Primary website Searchable picklist (against Sites) | taxonomy.primary_site | (none) | Planning (permanent) |
Publish date Read only | _id.additional_properties.publish_date | The timestamp when the story was last published (readonly) | Required to save Required to publish |
Redirect URL URL free entry | related_content.redirect | A URL that either leads the user to this article, or redirects them when they access it | Planning |
SEO keywords Non-searchable picklist (free text entry to chips) | taxonomy.seo_keywords | A list of SEO keywords for this story | → Required to publish |
Slug Short text field | slug | The short name given to this story | → Required to publish → Max characters |
Source system Short text field | source.system | What system this story was created in (readonly) | → Required to publish |
**Source type (legacy) ** Short text field | source.source_type | Source type (typically wire or staff) | Short text field |
Sponsored content Toggles | owner.sponsored [true, false] | Necessary for including/excluding advertorial and native content in search results, story card features | → Required to publish |
Stock symbols Non-searchable picklist (free text entry to chips) | taxonomy.stock_symbols | A list of stock symbols that correspond with this story | → Required to publish |
Story tags Searchable picklist (against Tags) | taxonomy.tags | A list of tags that apply to this story | → Required to publish |
Subtype Optional picklist + free entry | subtype | A way to give a classification to the type of content in the story | → Required to publish → Picklist → Allow for free text entry on picklist |
Syndication Non-searchable picklist | syndication | (none) | → Required to publish |
Website URL Read only with regenerate option | website_url | The website URLs for the story. Generated on the first publish (readonly after it is set) | → Required to publish |
Working headline Short text field | headlines.basic | The default headline for the story | Planning |