# How fields in the Composer UI map to ANS

Source: https://dev.arcxp.com/composer/developer-docs/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 following table outlines each available field, what it means, and how it corresponds to the Arc XP Native Specification (ANS) 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\_commentscomments.display\_commentscomments.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 saveRequired to publish                                                                       |
| **Quote language** Optional picklist                                                | additional\_properties.language.code, additional\_properties.language.region                          | The defined language tag for a quote element                                                            | → Picklist                                                                                                |
| **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)                                                                   | → Required to publish                                                                                     |
| **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                                                                                                  |
