This list references the fields & values you can use to upload your diamond listings to RapNet.
Important:
Diamonds missing mandatory fields and/or values do not upload to RapNet.
Fields or values not supported by RapNet’s Accepted Field Names & Values, are not included in the diamond item details.
Mandatory Diamond Fields
Mandatory Fields | Clarity: for white diamonds only |
Highly Recommended Diamond Details | |
Highly Recommended Information |
Diamond Fields Breakdown
Key Diamond details | |
Pricing | |
Lot Location & Availability | |
Media | |
Matched Pairs | |
Additional Diamond Details | Girdle Thin, Girdle Thick, Girdle %, Girdle Condition, Culet Size, Culet Condition, Crown Height, Crown Angle, Pavilion Depth, Pavilion Angle, Laser Inscription, Eye Clean, Cert comment, Member Comment, Report Issue Date, Seller Spec, Star Length, Shade, Black Inclusion, White Inclusion, Open Inclusion, Milky, Report Type, Report Issue Location, Key To Symbols, Brand, Permissions and other, Parcel Stones, Trade Show |
Permissions |
Diamond Accepted Fields and Values
Acceptable values are the short values in bold.
RapNet Field Names & Accepted Alternatives | Accepted Field Values | Field Description or Comments |
Allow RapLink FeedAllowRapLinkFeed, RapLink | Y = Yes | Allow the diamond to appear in Raplink Diamond Feed Service (virtual inventory). |
AvailabilityAvail, Availability, Available, | G = Guaranteed Availability, GA, Guaranteed, GuaranteedAvailable | - This means that the diamond is available for sale. - Guaranteed availability means the seller has immediate access to the diamond and City/State/Country must be specified. - If "NA" is entered, the stone will not appear in search results. |
Black Inclusion | None = Black Inclusions None, |
|
BGM | Yes No BGM |
|
Brand | Hearts and Arrows, 88-Cut, Arctic Fox, Argyle, Canada Mark, Canada Mark eligible, Canadian Ice, Heart's On Fire, Polar Bear, Polar Ice | The diamond's brand |
Cash PriceIndex Price, Index Asking Price |
|
|
Cash Discount %IndexDiscountPercent |
|
|
Certificate #Cert Num, CertID, CertificateID, CertificateNum, CertificateNumber, CertNo, CertNum, CmPub |
| Type in the number on the certificate from the grading lab. |
Certificate FilenameCertFile, CertFilename, CertificateFile, CertificateFilename, CertificateImage, CertImage, File |
|
|
ClarityClar, Clearity, Purity | FL, IF, Loupe Clean, LC, VVS1, VVS2, VS1, VS2, SI1, SI2, SI3, I1, P1, I2, P2, I3, P3. | For fancy-colored stones without clarity, enter "N" for none. |
ColorColr, Colour | D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z | For fancy colors use the fancy color column. |
Cert CommentComments, Remarks, Lab comment, Cert comment, Certificate comment, Laboratory comment |
| Maximum 255 characters. |
Crown Angle |
| Give a value to the nearest 0.5 degrees. |
Crown, Crown Percent, CrownHeight, CrownPct |
| - Give a percentage with only one number after the decimal. - Do not include the % sign. |
Culet Condition | P = Pointed |
|
Culet SizeCulet, CuletSize, Culet_size, CuletGrade,Cullet, CulletGrade | EL = Extremely Large |
|
Cut GradeCut, CutGrade | I= Ideal, ID |
|
Depth %Depth, Depth Percent, DepthPct, DepthPercent, Dpth, TotalDepth |
|
Example: 62.4 |
Diamond Image/sDiamondImage, Image, ImageFile, Photo
Multiple ImagesImage 1, Image 2, Image 3, Image 4, Image 5 | imagename.jpg imagename.png imagename.pdf
|
|
Display Cert NumberDisplayCert, ShowCert | Y = Yes | Allows you to hide/show the certificate number |
DocumentMultiple DocumentsDocument1 Type, Document 2 Type, Document 3 Type |
| The filename for the document or URL |
Eye Clean | Yes |
|
Fancy ColorFancyColor, FancyColorMainBody, | BK = Black | To enter two colors, separate them with a hyphen or a space. Example: Blue-Green, Blue Green, B-G, B G |
Fancy Color IntensityFancyColorIntensity, FCIntensity, FC-Intensity | F = Faint |
|
Fancy Color OvertoneFancyColorOvertone, FancyColorOvertones, FCOvertone |
| - List any overtones in the color. Example: Brownish-Yellowish |
Fluorescence ColorFlrColor, Fluo Color, Fluor Color, FluorColor, FluorescenceColor | B = Blue, BL | The default is "N" if left blank. |
Fluorescence IntensityFlr, FlrIntensity, Fluo Intensity, Fluor, Fluor Intensity, Fluorescence, Fluorescence Intensity, FluorescenceIntensity, FluorIntensity | VS = Very Strong, VST, FL4 |
|
Girdle %Girdle Percent, GirdlePct, GirdleThicknessInPct |
| - Must be a positive number. - Do not include the % sign. |
Girdle ConditionGirdle Condition | P = Polished |
|
Girdle ThickGirdleMax, GirdleThick | Extremely Thick = XTK, EXTHICK, EXTHK, XTHK, XTHICK, XTHIK, ETK, EK, XK | You may enter both Girdle Thin and Girdle Thick into the Girdle Thin field, separate with a hyphen. Example: thn-thk |
Girdle ThinGirdle, GirdleMin, GirdleThin | Extremely Thick = XTK, EXTHICK, EXTHK, XTHK, XTHICK, XTHIK, ETK, EK, XK | You may enter both Girdle Thin and Girdle Thick in this field, separate with a hyphen. Example: thn-thk |
Is Matched Pair SeparableIsMatchedPairSeparable, IsPairSeparable, PairSep, PairSeparable, Separable, Separatable | Y = Yes | - If this value is set to "Y" the individual diamonds will show up in single stone searches as well as pair searches. - If stones are a pair and they are marked NOT separable they will NOT show up in single stone searches. - Refer to this article for guidance
|
Key To Symbols, KeyToSymbols, Key | Bearding, Brown patch of color, Bruise, Cavity, Chip, Cleavage, Cloud, Crystal, Crystal Surface, Etch Channel, Extra Facet, Feather, Flux Remnant, Indented Natural, Internal Graining, Internal Inscription, Internal Laser Drilling, Knot, Laser Drill Hole, Manufacturing Remnant, Minor Details of Polish, Natural, Needle, No Inclusion, Pinpoint, Reflecting Surface Graining, Surface Graining, Twinning Wisp |
|
LabCert, Certificate, Laboratory | GIA = G.I.A, G | The name of the Lab where the diamond was graded. |
Laser Inscription |
| Maximum 50 characters. |
CountryLocationCountry, LotCountry City, CityLocation |
| Specify the country or city where the diamond is located |
Measurements
Dimensions, Meas, Measurement |
| - The diamond's measurements: length, width, and depth. - Either enter all measurements into one field, for example, 8.93 x 6.44 x 3.82 or split up into 3 columns - see below. |
MeasWidth, Measurements Width, Width, MeasurementsWidth |
| - The diamond's width. - Use as an alternative to "measurements" |
MeasDepth, Measurements Depth, Height, MeasurementsDepth, MeasHeight |
| - The diamond's depth. - Use as an alternative to "measurements" |
MeasLength, Measurements Length, Length, MeasurementsLength |
| - The diamond's length. - Use as an alternative to "measurements" |
Member CommentMember Comments |
|
For example, "Source: Botswana". |
Milky, Cloudy | None, Light (M1), Medium (M2), Heavy (M3) |
|
Open Inclusion | None = Open Inclusions None, | Accepted values are the abbreviated values in bold. |
Pair Stock #MatchedPairStockNo, MatchedPairStockNum, MatchedPairStockNumber, Matching Stock Num, MatchingPair, MatchingStockNo, MatchingStockNum, MatchingVenderStockNumber, Pair, PairStock, PairStockNum, PairStockNumber |
| - Enter the stock number of the other diamond in the pair. - Refer to this article for guidance |
Parcel Stones, ParcelStoneCount, ParcelStones, StoneCount, Stone |
| - Type in the number of stones in the parcel. - Leave the field blank for single stones. |
Pavilion Angle |
| Give a value to one decimal place. Example: 62.3 |
PolishFinish, Pol | I = I, ID |
|
RapLab Report ID |
| The number on the RapNet report |
RapNet Discount % PctRapNetDiscount, Rap netDisc, RapnetDiscount, RapnetDiscountPct, RapnetDiscountPercent, RapnetDiscPct, RapnetDpx, RapnetRapPct, RDisc, RDiscount, RDiscountPct, RDiscountPercent, RDiscPct, RDpx, RRapPct, RapNet Discount Price |
| - This is the Rapaport discount percentage price. - To enter a discount below the Rap price, enter a negative decimal value without a % sign. Example: -0.34 or -.25 Note: if both discount% and price/ct are uploaded, only the price/ct will be considered.
|
RapNet PriceAskingPrice, PerCarat, PerCt, Prc, Price, PriceCarat, PriceCt, PricePerCarat, PricePerCt, Px |
| - The price at which the seller is prepared to sell the diamond, often a memo or credit price. - Per carat, no dollar sign, no commas, no cents.
Note: if both discount% and price/ct are uploaded, only the price/ct will be considered. |
Report # |
| Enter the number on the certificate from the Grading Lab |
Report Type, ReportType |
| Describes the type of report uploaded. |
Report Issue Date |
| The date the diamond report was issued. |
Report Issue Location |
| The location where the report was issued. |
SarineIDSarine ID, Sarine Name, Sarine Loupe, Sarin Loupe |
| Sarine file name |
Seller Spec | A1 | - For your diamond to display on RapNet as A1, this field must be filled in AND the diamond must meet A1 conditions. - Click here to view A1 parameters. |
ShapeShp | Round = B, BR, RB, RD, RBC, Round Brilliant, RND Epaulette - EP
| This is the shape of the diamond. *Go to the paragraph below for more on GIA shapes and trade shapes |
Shade | None, White, Yellow, Brown, Green, Grey, Black, Pink, Blue, Mixed, Faint Brown, Faint Green, Other |
|
ShowOnlyOnRapLink |
| - Displays your diamonds on your Instant Inventory feed only and will not be visible on RapNet. - Only for members on the Instant Inventory plan |
SizeCarat, CaratSize, CaratWeight, Ct, CtSize, CtWeight, Weight, Sz, Weight |
| The diamond's weight is in carat.
|
Source | Angola Australia Botswana Brazil Canada Lesotho Liberia Russia Sierra Leone South Africa Tanzania AGD Diamonds Alrosa Arctic Canadian Argyle Bluerock Diamonds Braúna Catoca Catoca Mine Cullinan Diavik Dominion DTC Ekati Endiama Finsch Firestone Diamonds Gahcho Kué Gem Diamonds Grib Diamond Mine Jwaneng Kao Kareevlei Karowe Koffiefontein Koidu Koidu Holdings Letšeng Lipari Mineraçãu Liqhobong Lucapa Diamond Company Lucara Lucara Diamond Corp Lulo Diamond Project Mirange Mothae Mountain Province Namibia Okavango Orapa Petra Diamonds Renard Rio Tinto Storm Mountain Diamonds Stornoway Diamond Venetia Williamson | - Indicates the diamond's source. |
StateStateLocation |
| Specify the state where the diamond is located. |
Star Length |
|
|
Stock #ReferenceNum, ReferenceNumber, Stock, Stock Num, Stock_no, StockNo, StockNum, StockNumber, VenderStockNumber |
| Enter your inventory stock number. |
SymmetrySym, Symetry, Sym-metry | I = I, ID |
|
Table %Table, Table Percent, TablePct, TablePercent, Tbl |
| - Give percentage in two-digit form. - Do not include the % sign. Example: 60 |
TracrIDTracr ID |
| Trcr ID number |
Trade ShowTradeShow |
| For use during major trade shows. |
TreatmentEnhance, Enhancement, Enhancements, Treatments | LD = Laser Drilled | To enter multiple values, separate them with a semicolon (;). |
VideoURLVideo Link
Multiple VideosVideoURL 1, VideoURL 2, VideoURL 3, VideoURL 4, VideoURL 5 | Video Link | - Upload HTTPS secure links only - Only whitelisted video providers will be displayed on RapNet. Click here for a list of whitelisted providers |
White Inclusions | None = White Inclusions None, | Acceptable values are the abbreviated values in bold. |
GIA-Graded Shapes & Trade Shapes
We replace all diamond data with gemological data direct from the GIA report.
In a few cases, we allow the seller to determine the shape of the GIA-graded diamond and they can upload one of these alternative shapes.
GIA Shape | Alternative Allowed RapNet Shapes | Default if an invalid shape was uploaded |
Round-Cornered Rectangular Modified Brilliant | Radiant, Cushion Modified, or Emerald | Other |
Modified Rectangular Brilliant | Radiant, Cushion Modified, Cushion Brilliant, Princess or Square Radiant | Other |
Rectangular Modified Brilliant | Radiant, Cushion Modified, Cushion Brilliant, Princess or Square Radiant | Radiant |
Cut-Cornered Square Modified Brilliant | Radiant, Cushion Modified, Cushion Brilliant, Princess or Square Radiant | Square Radiant |
Square Modified Brilliant | Radiant, Cushion Modified, Cushion Brilliant, Princess or Square Radiant | Princess |
Modified Square Brilliant | Radiant, Cushion Modified, Cushion Brilliant, Princess or Square Radiant | Cushion Modified |
Square Emerald Cut | Square Emerald or Asscher | Square Emerald |